Skip to Content
API குறிப்பு

முழுமையான API குறிப்பு

இந்தப் பக்கத்தில் ட்ரேஸ்லெட்டின் உள்ளமைவு APIக்கான உண்மையின் முழுமையான ஆதாரம் உள்ளது. Tracelet.ready(Config) க்கு அனுப்பப்படும் ஒவ்வொரு அளவுருவும் இங்கே பட்டியலிடப்பட்டுள்ளது.

இந்த அளவுருக்களை ஏன் பயன்படுத்துகிறீர்கள் என்பதை விளக்கும் நிஜ உலக கட்டிடக்கலை காட்சிகளுக்கு, அவற்றிற்கு அடுத்துள்ள “கதையைக் காண்க 📖” இணைப்புகளைக் கிளிக் செய்யவும்.

இயக்க நேரத்தில் உள்ளமைவைப் புதுப்பிக்கிறது - ready() vs setConfig()

config செருகுநிரலை அடைய இரண்டு வழிகள் உள்ளன, மேலும் அவை வெவ்வேறு விஷயங்களைக் குறிக்கின்றன.

Tracelet.ready(config) முழுமையான அடிப்படையை நிறுவுகிறது. ஒவ்வொரு துறையும் உள்ளது அனுப்பப்பட்டது, அதன் பயனுள்ள மதிப்புக்கு தீர்க்கப்பட்டது. தொடக்கத்தில் ஒரு முறை அழைக்கவும் - அல்லது மீண்டும் எப்போது நீங்கள் முழு கட்டமைப்பையும் மாற்ற வேண்டும். Tracelet.reset(config) செயல்படுகிறது அதே வழியில்.

Tracelet.setConfig(config) என்பது பகுதி புதுப்பிப்பு. புலங்கள் மட்டுமே நீங்கள் உண்மையில் செட் அனுப்பப்படுகின்றன; மற்ற அனைத்தும் மேடையில் உள்ளதை வைத்திருக்கிறது நீடித்தது. ஒரு விஷயத்தை மாற்ற வேண்டியிருக்கும் போது, ​​நீங்கள் இடைக்கால அமர்வை விரும்புவது இதுதான்:

// Changes one flag. The notification title from ready(), the HTTP URL,
// distanceFilter, stopOnTerminate — all keep their configured values.
await Tracelet.setConfig(const Config(
  android: AndroidConfig(
    foregroundService: ForegroundServiceConfig(
      showNotificationOnPauseOnly: true,
    ),
  ),
));
 
// Changes nothing at all.
await Tracelet.setConfig(const Config());

⚠️ 3.8.0 இல் மாற்றப்பட்டது. setConfig() முன்பு முழுவதுமாக மாற்றப்பட்டது உள்ளமைவு, எனவே நீங்கள் குறிப்பிடாத எந்த புலமும் அமைதியாக மாற்றப்பட்டது இயல்புநிலை — setConfig(const Config()) ரீசெட் எல்லாவற்றையும், உட்பட stopOnTerminate, HTTP அமைப்புகள், முன்புற சேவை அறிவிப்பு மற்றும் iOS கீப்-லைவ் கொடிகள். நிலையை மீட்டமைக்க நீங்கள் அதை நம்பியிருந்தால், அழைக்கவும் Tracelet.reset() அல்லது அதற்குப் பதிலாக ready() (#320 , #321 ).

மதிப்பை அதன் இயல்புநிலைக்கு அமைப்பது இன்னும் வேலை செய்கிறது. “அன்செட்” என்றால் நீங்கள் செய்யவில்லை புலத்தை வழங்கவும், ஒருபோதும் மதிப்பு இயல்புநிலைக்கு சமமாக இருக்காது - எனவே ForegroundServiceConfig(showNotificationOnPauseOnly: false) கொடியை திருப்புகிறது ஆஃப். நீங்கள் முழுவதுமாகத் தவிர்த்துவிட்ட ஒரு புலம் மட்டும் தனியாக உள்ளது.

Tracelet.activeConfig உள்நாட்டில் அதே ஒன்றிணைப்பைப் பயன்படுத்துகிறது, எனவே அது எப்போதும் பிரதிபலிக்கும் உங்கள் கடைசி அழைப்பு விட்டுச் சென்ற இயல்புநிலைகளைக் காட்டிலும் இயங்குதளம் உண்மையில் என்ன வைத்திருக்கிறது அமைக்கப்படவில்லை.

இல்லை தொடர்ந்து அல்லது பைப்லைனை மறுதொடக்கம் செய்ய வேண்டிய மாற்றங்களுக்கு, பயன்படுத்தவும் அதற்கு பதிலாக இலக்கு இயக்க நேர APIகள்: updateLocationProviderOptions() துல்லியம்/தூரத்திற்கு, மற்றும் updateNotification() நேரடி அறிவிப்பை மறுபதிவு செய்ய.

🌍 GeoConfig (config.geo)

உடல் இருப்பிடம், துல்லியம் மற்றும் மாதிரி தர்க்கம் ஆகியவற்றைக் கட்டுப்படுத்துகிறது. ஜியோ ஸ்டோரியைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) இலக்கு வன்பொருள் துல்லியம். பேட்டரியைச் சேமிக்க GPSக்கு high, செல்லுலார்/Wi-Fiக்கு low ஆகியவற்றைப் பயன்படுத்தவும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒரு புள்ளி பதிவு செய்யப்படுவதற்கு முன் நகர வேண்டிய குறைந்தபட்ச கிடைமட்ட மீட்டர்கள்.

ℹ️ desiredAccuracy அல்லது distanceFilter ஐ setConfig() வழியாக மாற்றுவது மதிப்புகள் தொடர்ந்து மற்றும் கண்காணிப்பு பைப்லைனை மறுதொடக்கம் செய்கிறது. கண்காணிக்கும் போது தற்காலிக மேலெழுதலுக்கு (எ.கா. உறுதிப்படுத்தப்பட்ட நிலையான காலத்தில் GPSஐ எளிதாக்குதல்), updateLocationProviderOptions() ஐப் பயன்படுத்தவும் - இது இயங்கும் வழங்குநரை மறுதொடக்கம் செய்யாமல் நேரடியாகப் புதுப்பிக்கிறது, மேலும் தொடர்ந்து உள்ள கட்டமைப்பைத் தொடாது.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) பயனரைச் சுற்றியுள்ள ஆரம் நிலையானதாகக் கருதப்படும் (ஜிபிஎஸ் வடிகால் நிறுத்தப்படும்).
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) விட்டுக்கொடுக்கும் முன் GPS பூட்டுக்காக காத்திருக்க அதிகபட்ச வினாடிகள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) உண்மை எனில், டைனமிக் வேக அடிப்படையிலான தூர அளவிடுதலை முடக்கும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) அதிக வேகத்தில் பயணிக்கும் போது மாறும் தூர வடிகட்டிக்கான பெருக்கி.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) NOTRANS0 லேட் நிமிடங்களுக்குப் பிறகு இயந்திரத்தை தானாக நிறுத்துகிறது. -1 என்றால் எப்போதும் இயங்கும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒரே நேரத்தில் கண்காணிக்க அதிகபட்ச ஜியோஃபென்ஸ்கள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) சரியான நானோ வினாடி வன்பொருள் நேர முத்திரைகளை இணைக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) பேட்டரி அளவின் அடிப்படையில் அமைப்புகளைத் தானாக மாற்றுகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) நிலையான போது அவ்வப்போது புதுப்பிப்புகளுக்கு இடையே உள்ள வினாடிகள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) குறிப்பிட்ட கால பின்னணி எழும்பும்போது துல்லியம் பயன்படுத்தப்படுகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) குறைந்த சக்தி செல்-டவர் முக்கோணத்தை பிரத்தியேகமாகப் பயன்படுத்துகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஸ்பேர்ஸ் பயன்முறையில் நகர்த்துவதற்கு மீட்டர்கள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒரு சிறிய புதுப்பிப்பு இல்லாமல் அதிகபட்ச நேரம்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஜிபிஎஸ் தொலைந்தால் (எ.கா. சுரங்கங்கள்) இருப்பிடத்தை யூகிக்க முடுக்கமானி/கைரோஸ்கோப்பைப் பயன்படுத்துகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) இறந்த கணக்கீடு தொடங்குவதற்கு முன் சில வினாடிகள் ஜிபிஎஸ் இழப்பு.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) நிறுத்துவதற்கு முன் டெட் கணக்கை அனுமதிக்க அதிகபட்ச வினாடிகள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) தானாக ரிவர்ஸ்-ஜியோகோட்கள் ஒரு தெரு முகவரி சரத்தில் ஒருங்கிணைக்கிறது.

🧹 இருப்பிட வடிகட்டி (config.geo.filter)

SQLite/Syncஐத் தாக்கும் முன், மோசமான GPS தரவைச் சுத்தம் செய்கிறது. வடிகட்டி கதையைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) X மீட்டர்களை விட மோசமான துல்லியம் கொண்ட புள்ளிகள் கைவிடப்பட்டன.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) வேகம் > X m/s (80 m/s = 288 km/h) குறிக்கும் இருப்பிடத் தாவல்களை நிராகரிக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) X மீட்டர்களை விட மோசமான துல்லியமான புள்ளிகள் மொத்த பயண தூரத்தில் சேர்க்காது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) மோசமான புள்ளிகளை எவ்வாறு கையாள்வது (drop அல்லது adjust).
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) GPS ஸ்பூஃபிங் ஆப்ஸ் மூலம் உருவாக்கப்பட்ட இருப்பிடங்களை உடனடியாக கைவிடும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) போலி ஜிபிஎஸ் கண்டறிதல் ஹூரிஸ்டிக்ஸின் தீவிரத்தன்மை.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) கச்சா ஜிபிஎஸ் பாதையில் சிக்கலான கல்மேன் மென்மையாக்கலைப் பயன்படுத்துகிறது.

📱 AppConfig (config.app)

ஒட்டுமொத்த பயன்பாட்டு வாழ்க்கைச் சுழற்சி நடத்தையைக் கட்டுப்படுத்துகிறது.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) true எனில், பயனர் பயன்பாட்டை ஸ்வைப் செய்யும் போது கண்காணிப்பு நிறுத்தப்படும். false எனில், அது பின்புலத்தில் மறுதொடக்கம் செய்யும். டெர்மினேட் ஸ்டோரியைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) true எனில், ஃபோனை மறுதொடக்கம் செய்யும் போது கண்காணிப்பு தானாகவே தொடங்கும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) என்ஜின் உயிருடன் இருப்பதை நிரூபிக்க ஒவ்வொரு X வினாடிகளிலும் “இதயத் துடிப்பு” நிகழ்வை நடத்துகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) CRON போன்ற சரங்கள், குறிப்பிட்ட நேரத்தில் கண்காணிப்பதைத் தானாகவே தொடங்க/நிறுத்துகின்றன.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) HTTPS URL SDK ஆனது ready() இலிருந்து JSON கட்டமைப்பு வரைபடத்தைப் பெறுகிறது, அதை உள்ளூர் கட்டமைப்பில் பயன்படுத்துகிறது மற்றும் பின்னணியில் புதுப்பிக்கிறது. உடனடி ஆஃப்லைனுக்கான சாதனத்தில் தற்காலிகமாகச் சேமிக்கப்பட்டது. தொலை உள்ளமைவு ஐப் பார்க்கவும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ரிமோட் கட்டமைப்பு பெறுவதற்கான HTTP தலைப்புகள்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) தொலைநிலை கட்டமைப்பை எம்எஸ்ஸில் பெறுவதற்கான நேரம் முடிந்தது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ரிமோட் கட்டமைப்பை மீண்டும் பெறுவதற்கு சில நிமிடங்களுக்கு முன்.

🤖 AndroidConfig (config.android)

Android குறிப்பிட்ட OS கட்டுப்பாடுகள். ஆண்ட்ராய்டு கதையைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஜிபிஎஸ் பிங்ஸ் இடையே திருமதி.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒரு மணி நேரத்திற்கு அதிகபட்ச பேட்டரி வடிகால் % இலக்கு. 0.0 த்ரோட்டிங்கை முடக்குகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) MotionDetectionMode.smart ஐப் பயன்படுத்தும் போது, ​​ஆழ்ந்த உறக்க பேட்டரி சேமிப்பை அதிகரிக்க சாதனம் முழுமையாக நிலையாக இருக்கும்போது கண்காணிப்பு வேக்லாக்கை வெளியிடுகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) மற்றொரு ஆப்ஸ் ஜிபிஎஸ் பிங்ஸைக் கோரினால் இடையே வேகமான எம்எஸ்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) X msக்கான இருப்பிடப் புதுப்பிப்புகளைத் தொகுக்க Android ஐ அனுமதிக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) தவறு எனில், நகல் துல்லியமான ஆயங்கள் கைவிடப்படும்.
  • geofenceModeHighAccuracy: bool (இயல்புநிலை: false) — ⚠️ நிறுத்தப்பட்டது ஜியோஃபென்ஸிற்கான ஜிபிஎஸ் சிப்பை கட்டாயப்படுத்துகிறது (கனமான பேட்டரி வடிகால்). குறுக்கு மேடையைப் பயன்படுத்தவும் GeofenceConfig.geofenceModeHighAccuracy (கீழே உள்ள GeofenceConfig பகுதியைப் பார்க்கவும்) பதிலாக — இது இப்போது iOS மற்றும் Android இரண்டையும் கட்டுப்படுத்துகிறது. இந்த ஆண்ட்ராய்டு மட்டும் கொடி இன்னும் உள்ளது பின்தங்கிய இணக்கத்தன்மைக்காக கௌரவிக்கப்பட்டது (ஒன்று true ஆக இருந்தால், உயர் துல்லிய பயன்முறை இயக்கப்பட்டது) ஆனால் எதிர்கால பெரிய பதிப்பில் அகற்றப்படும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) அவ்வப்போது விழித்திருக்கும் போது ஒரு நிலையான அறிவிப்பை கட்டாயப்படுத்துகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) சரியான விழிப்புகளுக்கு AlarmManager ஐப் பயன்படுத்துகிறது (SCHEDULE_EXACT_ALARM மேனிஃபெஸ்ட் அனுமதி தேவை). சரியான அலாரங்களைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) CRON திட்டமிடலுக்கு சரியான அலாரங்களைப் பயன்படுத்துகிறது.

ForegroundServiceConfig (config.android.foregroundService)

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) Android 13+ இல் POST_NOTIFICATIONS அனுமதி தேவை. அறிவிப்பைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) சிறிய ஐகான் பின்னணிக்கான ஹெக்ஸ் வண்ணம்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) உங்கள் res/drawable கோப்புறையில் வெள்ளை நிறத்திற்கு மட்டும் PNG இன் பெயர்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஆப்ஸ் திரையில் இருக்கும்போது அறிவிப்பை மறைக்கும். app.stopOnTerminate false ஆக இருக்கும்போது புறக்கணிக்கப்பட்டது — அதை மறைப்பது முன்புற சேவையைக் குறைக்கிறது, மேலும் அந்தச் சாளரத்தில் உள்ள சமீபத்தியவற்றிலிருந்து ஸ்வைப் செய்தால் செயல்முறை அழிக்கப்படும் (#378 ). start() க்கு ஒரு முறை மேலெழுதப்பட்டது. அறிவிப்பை மறைப்பதைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) எபோச் மில்லி விநாடிகள் (சுவர் கடிகாரம்) கழிந்த டைமர் இதிலிருந்து கணக்கிடப்படுகிறது. notificationShowTimer true ஆக இருக்கும்போது மட்டுமே ரெண்டர் செய்யப்படும். ஒவ்வொரு முறையும் அறிவிப்பை வெளியிடும் போது எதிர்காலத்தில் ஒரு மதிப்பு தற்போதைய நேரத்துடன் இணைக்கப்படுகிறது, எனவே சாதனத்தின் கடிகார திருத்தம் சுயமாக குணமாகும். கடந்த டைமரைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) notificationStartedAt இலிருந்து சுய-டிக்கிங் கவுண்ட்-அப் கடிகாரத்தைக் காட்டுகிறது. உங்கள் பயன்பாட்டிலிருந்து மறுபதிவுகள் இல்லாமல் Android அதை மேம்படுத்துகிறது. notificationStartedAt இல்லாவிட்டால் டைமர் எதுவும் காட்டப்படாது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) அறிவிப்பின் முதல் இடுகையில் மட்டுமே சாதனத்தை எச்சரிக்கும், எனவே பின்னர் உள்ளடக்க புதுப்பிப்புகள் அமைதியாக இருக்கும். டைமர்கள் மட்டுமின்றி, டிராக்கிங் செய்யும் போது உரை மாறும் எந்த அறிவிப்புக்கும் பயனுள்ளதாக இருக்கும். உரையை அமைதியாக புதுப்பிப்பதைப் பார்க்கவும் 📖

🔔 டிராக்கிங் ஏற்கனவே இயங்கும் போது அறிவிப்பு மாற்றத்தைப் பயன்படுத்த, setConfig() க்குப் பிறகு Tracelet.updateNotification() ஐ அழைக்கவும். இது பைப்லைனை மறுதொடக்கம் செய்யாமலேயே நேரடி அறிவிப்பை மறுபதிவு செய்கிறது (v3.6.8+). iOS இல் அது இயங்கும் நேரலை செயல்பாட்டைப் புதுப்பிக்கிறது; இணையத்தில் அது ஒரு தடை.

🍎 IosConfig (config.ios)

iOS குறிப்பிட்ட OS கட்டுப்பாடுகள். iOS கதையைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) நீங்கள் என்ன செய்கிறீர்கள் என்பதை iOSக்கு தெரிவிக்கும் (எ.கா. fitness, navigation) அதனால் கண்காணிப்பை எப்போது இடைநிறுத்துவது என்பதை அறியும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) செல்-டவர் கையேடுகளை முழுவதுமாக நம்பியுள்ளது. பூஜ்ஜியத்திற்கு அருகில் பேட்டரி வடிகால்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) நீல மாத்திரை காட்டி காட்டுகிறது. location Xcode திறன் தேவை. பார்க்க நீல மாத்திரை 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) பயனர் சிறிது நேரத்தில் நகரவில்லை என்றால், ஜிபிஎஸ் சிப்பை அழிக்க iOS ஐ அனுமதிக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) எந்த அனுமதியைக் கோருவது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) “பயன்படுத்தும் போது” மட்டும் கோரப்பட்டால், “எப்போதும் அனுமதி” எனத் தூண்டுவதை OS தடுக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) 24/7 ஆப்ஸை உயிர்ப்புடன் வைத்திருக்க அமைதியான ஆடியோவை இயக்குகிறது. audio Xcode திறன் தேவை. இடைநிறுத்தத்தைத் தடுப்பதைக் காண்க 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) CLBackgroundActivitySession (iOS 17+) ஐப் பயன்படுத்தி பின்னணி இருப்பிட அமர்வை மட்டும் “பயன்படுத்தும் போது” அங்கீகாரத்துடன் பராமரிக்கிறது. இது பாரம்பரிய நீல மாத்திரையை டைனமிக் ஐலேண்ட் காட்டி மாற்றுகிறது. குறிப்பு: Apple App Store வழிகாட்டுதல்களின்படி, பின்னணி இருப்பிடம் ஏன் அவசியம் என்பதை பயனர்களுக்கு தெளிவான விளக்கத்தை வழங்க, பயன்பாடுகள் இதைப் பயன்படுத்த வேண்டும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) டிராக்கிங் செய்யும் போது லாக் ஸ்க்ரீன் / டைனமிக் ஐலேண்ட் லைவ் ஆக்டிவிட்டியைத் தேர்ந்தெடுக்கவும் (iOS 16.1+, விட்ஜெட் நீட்டிப்பு தேவை). ஒரு title மற்றும் body எடுக்கிறது. நேரடி செயல்பாடுகளைப் பார்க்கவும் 📖. Tracelet.updateNotification() (v3.6.8+) மூலம் இயக்க நேரத்தில் அதைப் புதுப்பிக்கவும்.

LiveActivity Config (config.ios.liveActivityConfig)

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (தேவை) நிலையான தலைப்பு. செயல்பாடு இயங்கும் போது ActivityKit பண்புக்கூறுகள் மாறாமல் இருக்கும், எனவே அடுத்த முறை தொடங்கும் போது மாற்றம் பொருந்தும்.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (தேவை) டைனமிக் நிலை வரி, updateNotification() மூலம் புதுப்பிக்கப்பட்டது.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) எபோச் மில்லி விநாடிகள் (சுவர் கடிகாரம்) கழிந்த டைமர் இதிலிருந்து கணக்கிடப்படுகிறது. showTimer true ஆக இருக்கும்போது மட்டுமே ரெண்டர் செய்யப்படும். கடந்த டைமரைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) Text(timerInterval:) ஐப் பயன்படுத்தி startedAt இலிருந்து சுய-டிக்கிங் கவுண்ட்-அப் கடிகாரத்தை ரெண்டர் செய்கிறது. உங்கள் பயன்பாட்டிலிருந்து எந்த புதுப்பிப்புகளும் இல்லாமல் iOS அதை மேம்படுத்துகிறது. startedAt இல்லாவிட்டால் டைமர் காட்டப்படாது.

    TraceletActivityAttributes.ContentState இன் அதன் சொந்த நகல் startedAt மற்றும் showTimer என அறிவித்தால் மட்டுமே தனிப்பயன் விட்ஜெட் நீட்டிப்பு டைமரை வழங்கும். இந்தப் புலங்கள் இருப்பதற்கு முன் எழுதப்பட்ட நீட்டிப்புகள் தொடர்ந்து செயல்படும் - கூடுதல் மதிப்புகள் புறக்கணிக்கப்படும் - ஆனால் நீங்கள் கட்டமைப்பைப் புதுப்பிக்கும் வரை கடிகாரத்தைக் காட்டாது. புதுப்பிக்கப்பட்ட துணுக்கைப் பார்க்கவும் 📖

📍 GeofenceConfig (config.geofence)

கிராஸ்-பிளாட்ஃபார்ம் ஜியோஃபென்சிங் நடத்தை (iOS + Android).

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஜியோஃபென்ஸ் மாற்றங்கள் எவ்வாறு கண்டறியப்படுகின்றன என்பதைக் கட்டுப்படுத்துகிறது:

    • false (இயல்புநிலை) — OS பகுதி-கண்காணிப்பு சேவையைப் பயன்படுத்துகிறது. குறைந்த ஆற்றல், iOS நீலக் காட்டி இல்லை, ஆனால் OS ஒரு நடைமுறை குறைந்தபட்ச ஆரம் (~100 மீ) செயல்படுத்துகிறது மற்றும் சிறிய அல்லது வெளியேறும் மாற்றங்கள் நம்பகத்தன்மையற்றதாக இருக்கலாம்.
    • true — தொடர்ச்சியான GPS இலிருந்து பயன்பாட்டில் உள்ள மாற்றங்களை மதிப்பிடுகிறது. **இறுக்கமான ஆரங்கள் (எ.கா. 5-50 மீ) மற்றும் வெளியேறும் நிகழ்வுகளை நம்பகமானதாக ஆக்குகிறது பார்க்க நீல மாத்திரை 📖

    இது நிராகரிக்கப்பட்ட AndroidConfig.geofenceModeHighAccuracy ஐ முறியடிக்கிறது; true ஆக இருந்தால், உயர் துல்லிய பயன்முறை இயக்கப்படும்.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) பதிவு செய்யும் போது ஜியோஃபென்ஸ் நிலையை மதிப்பிடுங்கள்.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) சாதனம் ஏற்கனவே ஜியோஃபென்ஸில் பதிவுசெய்யப்பட்டிருந்தால், உடனடியாக ENTER ஐ இயக்கவும்.

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) அருகாமை அடிப்படையிலான ஏற்றுதலுக்கான ஆரம் (மீட்டர்கள்) — இந்த தூரத்தில் உள்ள ஜியோஃபென்ஸ்கள் மட்டுமே OS இல் தீவிரமாக பதிவு செய்யப்படுகின்றன (iOS 20-பிராந்திய வரம்பை விட அதிகமாக நிர்வகிக்க உங்களை அனுமதிக்கிறது).

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) உயர் துல்லியமான பயன்முறையில் துல்லியம்-அறியும் EXIT கேட்டிங்கை டியூன் செய்கிறது (நிலையான பயன்முறையில் எந்த விளைவும் இல்லை). முழு ஜிபிஎஸ் பிழை வட்டமும் வேலியை (distance - accuracy > radius + buffer) துடைத்தவுடன் மட்டுமே ஒரு வட்ட ஜியோஃபென்ஸ் வெளியேறும், இது ஒரு சிறிய வேலிக்குள் ஒரு சாதனம் அமர்ந்திருக்கும் போது, ​​ஒரு உயர்-சறுக்கல் தீர்வை தவறான வெளியேற்றத்தைத் தடுக்கிறது - தோராயமாக ஜிபிஎஸ் நிச்சயமற்ற தன்மையால் உண்மையான வெளியேறலை தாமதப்படுத்தும் செலவில்.

    • -1 (இயல்புநிலை) - முழு கேட்டிங்; தவறான வெளியேற்றங்களுக்கு மிகவும் எதிர்ப்பு.
    • 0 - கேட்டிங் முடக்கப்பட்டது; வேகமாக வெளியேறும், ஆனால் சறுக்கல்-பாதிப்பு (முன் சரிசெய்தல் நடத்தை).
    • N > 0 — N மீட்டர்களுக்கு கிளாம்ப் துல்லியம்; N வரையிலான சறுக்கலை உறிஞ்சி, மோசமான நிலையில் வெளியேறும் தாமதத்தை ~N மீட்டருக்குக் கட்டுப்படுத்துகிறது. ஜிபிஎஸ் சறுக்கல் & தவறான வெளியேறு 📖

📡 HttpConfig (config.http)

பிணைய ஒத்திசைவு இயந்திரத்தை கட்டுப்படுத்துகிறது. ஒத்திசைவு கதையைப் பார்க்கவும் 📖

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) உங்கள் பின்தள இறுதிப்புள்ளி.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) தனிப்பயன் அங்கீகார தலைப்புகள். டைனமிக் JWT சுழற்சிக்கு, கால்பேக்குகளைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒவ்வொரு இருப்பிட பேலோடிலும் நிலையான JSON தரவு செலுத்தப்பட்டது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) JSON ரூட் முனை.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) தானாகவே பதிவேற்றுகிறது. தவறு எனில், நீங்கள் Tracelet.sync() ஐ அழைக்க வேண்டும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) 1-பை-1க்குப் பதிலாக இருப்பிடங்களின் வரிசைகளைப் பதிவேற்றுகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒத்திசைவைத் தூண்டுவதற்கு முன் தேவைப்படும் SQLite பதிவுகளின் எண்ணிக்கை.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஒரு இருப்பிடம் வந்த பிறகு ஒத்திசைக்கும் முன் காத்திருக்கவும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) ஆஃப்லைன் வரிசையில் மீண்டும் மீண்டும், நேர அடிப்படையிலான ஃப்ளஷ்களுக்கு இடையே உள்ள வினாடிகள். > 0 ஆகும்போது, ​​SDK இந்த கேடன்ஸில் நிலுவையில் உள்ள இடங்களை அவ்வப்போது பதிவேற்றும் - புதிய செருகல்களில் ஏற்படும் autoSyncDelay டிபவுன்ஸிலிருந்து சுயாதீனமாக. எத்தனை பதிவுகள் குவிந்திருந்தாலும் நேரத்தால் இயக்கப்படும் ஃப்ளஷிங்கிற்கு பயனுள்ளதாக இருக்கும். 0 இடைவெளி டைமரை முடக்குகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) பயனர் தரவுத் திட்டங்களைச் சேமிக்க வைஃபையில் இருக்கும்போது மட்டுமே ஒத்திசைக்கப்படும்.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) டெல்டா ஆயங்களை மட்டுமே அனுப்புகிறது, JSON பேலோட் அளவை 80% குறைக்கிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) உங்கள் இருப்பிடங்களுக்குப் பக்கத்தில் சேமிக்கப்பட்ட ஓட்டுநர்/பாதிப்பு நிகழ்வுகளைப் பதிவேற்றுகிறது. இயல்புநிலையாக முடக்கப்பட்டுள்ளது, எனவே ஏற்கனவே உள்ள பேலோட் உங்களுக்குக் கீழே மாறாது. டெலிமாடிக்ஸ் ஒத்திசைவைப் பார்க்கவும் 📖
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) டெலிமாடிக்ஸ்களை இருப்பிடப் பேலோடில் இணைப்பதற்குப் பதிலாக {"telematics": [...]} என அவற்றின் சொந்த முடிவுப் புள்ளிக்கு அனுப்புகிறது. syncTelematics தேவை. இணைக்கப்பட்ட பாதைக்குச் செல்ல வெற்று சரத்தை (null அல்ல) அனுப்பவும் - கட்டமைப்பு இணைக்கப்பட்டது, மாற்றப்படவில்லை.

🏢 நிறுவன கட்டமைப்புகள்

AuditConfig (config.audit)

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) இருப்பிட ஹாஷ்களின் கிரிப்டோகிராஃபிக், டேம்பர்-ப்ரூஃப் பிளாக்செயினை உருவாக்குகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) சங்கிலி தற்போது எப்போதும் SHA-256 ஐப் பயன்படுத்துகிறது; மற்றொரு அல்காரிதத்தைத் தேர்ந்தெடுப்பது இன்னும் பயன்படுத்தப்படவில்லை.
  • includeExtrasInHash: bool (இயல்புநிலை: false) — ⚠️ நிறுத்தப்பட்டது: செயல்படுத்தப்படவில்லை. சங்கிலி எப்போதும் முக்கிய இருப்பிட புலங்களை மட்டுமே ஹாஷ் செய்கிறது, எனவே இந்தக் கொடி எதையும் மாற்றாது. அதை வயரிங் செய்வது முன்பு கணக்கிடப்பட்ட ஒவ்வொரு சங்கிலியையும் செல்லாததாக்கும், எனவே அதற்கு பதிப்பு தேவை அமைதியான நடத்தை மாற்றத்தை விட சங்கிலி இடம்பெயர்வு.

SecurityConfig (config.security)

PrivacyZoneConfig (config.privacy)

AttestationConfig (config.attestation)

  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்) க்ரிப்டோகிராஃபிகலாக சாதனம் உண்மையானது மற்றும் முன்மாதிரி அல்ல என்பதை நிரூபிக்க Play Integrity (Android) மற்றும் App Attest (iOS) ஆகியவற்றைப் பயன்படுத்துகிறது.
  • நாட்ரான்ஸ்0லேட்: நோட்ரான்ஸ்1லேட் (இயல்புநிலை: நோட்ரான்ஸ்2லேட்)
  • verificationUrl: String? (இயல்புநிலை: null) — ⚠️ நிறுத்தப்பட்டது: செயல்படுத்தப்படவில்லை. சர்வர் பக்க சரிபார்ப்புக்காக எதுவும் சான்றளிப்பு டோக்கனை எங்கும் அனுப்புவதில்லை. டோக்கன் ஆகும் ஏற்கனவே ஒத்திசைவு பேலோடுகளில் சேர்க்கப்பட்டுள்ளது - அதற்கு பதிலாக உங்கள் சொந்த பின்தளத்தில் சரிபார்க்கவும்.
நிறுவன அம்சங்கள்கண்டறியும் கருவிகள்