കോൺഫിഗറേഷൻ API റഫറൻസ്

Tracelet.ready(Config)-ലേക്ക് കൈമാറിയ ഒരൊറ്റ Config ഒബ്‌ജക്റ്റ് ഉപയോഗിച്ചാണ് ട്രെയ്‌സ്‌ലെറ്റ് പൂർണ്ണമായും കോൺഫിഗർ ചെയ്‌തിരിക്കുന്നത്. ഈ ഒബ്‌ജക്‌റ്റിൽ എല്ലാ നെസ്റ്റഡ് ഉപ കോൺഫിഗറേഷനുകളും അടങ്ങിയിരിക്കുന്നു.

നിങ്ങളുടെ ഉപയോഗത്തിന് അനുയോജ്യമായ സജ്ജീകരണം നിർമ്മിക്കാൻ നിങ്ങളെ സഹായിക്കുന്നതിന്, ഞങ്ങൾ ഇവിടെ പാരാമീറ്ററുകൾ ലിസ്റ്റ് ചെയ്യുന്നില്ല. എന്തുകൊണ്ടാണ് അവ നിലനിൽക്കുന്നതെന്നും എപ്പോൾ നിങ്ങൾ അവ യഥാർത്ഥ ലോകത്ത് ഉപയോഗിക്കണമെന്നും ഞങ്ങൾ വിശദീകരിക്കുന്നു.

ജിയോകോൺഫിഗ് ഒബ്ജക്റ്റ് (config.geo)

എല്ലാ ഫിസിക്കൽ ലൊക്കേഷൻ, കൃത്യത, സാമ്പിൾ ലോജിക് എന്നിവ കൈകാര്യം ചെയ്യുന്നു.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: DesiredAccuracy.high (GPS)
• എന്ത്: ലൊക്കേഷൻ ഹാർഡ്‌വെയറിനായുള്ള ലക്ഷ്യ കൃത്യത.
• എപ്പോൾ അസാധുവാക്കണം: ഉപയോക്താവ് ഏത് നഗരത്തിലാണെന്ന് മാത്രം അറിയേണ്ട ഒരു കാലാവസ്ഥാ ആപ്പ് നിങ്ങൾ നിർമ്മിക്കുകയാണെങ്കിൽ, ഇത് DesiredAccuracy.low (സെല്ലുലാർ/വൈ-ഫൈ) എന്നതിലേക്ക് അസാധുവാക്കുക. high ഉപയോഗിക്കുന്നതിന് ഫിസിക്കൽ GPS ചിപ്പ് ആവശ്യമാണ്, ബാറ്ററി 10x വേഗത്തിൽ കളയുന്നു.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: 10.0 (മീറ്റർ)
• എന്ത്: ഒരു പുതിയ പോയിൻ്റ് രേഖപ്പെടുത്തുന്നതിന് മുമ്പ് ഉപകരണം നീങ്ങേണ്ട ഏറ്റവും കുറഞ്ഞ തിരശ്ചീന ദൂരം.
• എപ്പോൾ അസാധുവാക്കണം: നിങ്ങൾ അറ്റ്ലാൻ്റിക്കിന് കുറുകെ ഒരു സമുദ്ര ചരക്ക് കപ്പൽ ട്രാക്കുചെയ്യുകയാണെങ്കിൽ, ഇത് 1000.0 (1 കി.മീ) ആയി സജ്ജീകരിക്കുക. ഒരു കപ്പൽ പെട്ടെന്ന് 10 മീറ്റർ തിരിവുകൾ ഉണ്ടാക്കില്ല, ഓരോ 10 മീറ്ററിലും പോയിൻ്റുകൾ ലാഭിക്കുന്നത് നിങ്ങളുടെ ഡാറ്റാബേസിൽ കോടിക്കണക്കിന് ഉപയോഗശൂന്യമായ വരികൾ സൃഷ്ടിക്കും.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: 25.0 (മീറ്റർ)
• എന്ത്: “നിശ്ചലമായി” കണക്കാക്കപ്പെടുന്ന ഉപയോക്താവിൻ്റെ അവസാനത്തെ അറിയപ്പെടുന്ന പോയിൻ്റിന് ചുറ്റുമുള്ള ആരം.
• എപ്പോൾ അസാധുവാക്കണം: ഇടതൂർന്ന നഗര ചുറ്റുപാടുകളിൽ, അംബരചുംബികളായ കെട്ടിടങ്ങളിൽ നിന്ന് GPS “ബൗൺസ്” ചെയ്യുന്നു. ഒരു ഉപയോക്താവ് ഒരു കഫേയിൽ ഇരിക്കുകയാണെങ്കിൽ, അവരുടെ GPS തെരുവിൽ 40 മീറ്റർ താഴേക്ക് കുതിച്ചേക്കാം. stationaryRadius വളരെ ചെറുതാണെങ്കിൽ, ഉപയോക്താവ് നടക്കുകയാണെന്ന് ട്രേസ്ലെറ്റ് കരുതുകയും GPS ഓണാക്കി ബാറ്ററി കളയുകയും ചെയ്യും. ന്യൂയോർക്ക് അല്ലെങ്കിൽ ടോക്കിയോ പോലുള്ള നഗരങ്ങളിൽ ഇത് 50.0 ആയി സജ്ജീകരിക്കുക.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: false
• എന്ത്: സ്വയമേവ നേറ്റീവ് ഒഎസ് ജിയോകോഡറിനെ (ആപ്പിൾ മാപ്‌സ് / ഗൂഗിൾ പ്ലേ സേവനങ്ങൾ) മനുഷ്യർക്ക് വായിക്കാനാകുന്ന സ്ട്രീറ്റ് വിലാസത്തിലേക്ക് റിവേഴ്‌സ് ജിയോകോഡ് കോർഡിനേറ്റുകളിലേക്ക് വിളിക്കുന്നു.
• എപ്പോൾ അസാധുവാക്കണം: നിങ്ങളുടെ ആപ്പ് ഒരു മൈലേജ് ട്രാക്കർ ആണെങ്കിൽ, ഉപയോക്താക്കൾക്ക് അവർ ഏത് സ്ട്രീറ്റിൽ യാത്ര ആരംഭിച്ചുവെന്നും അവസാനിപ്പിച്ചുവെന്നും കൃത്യമായി കാണിക്കേണ്ടതുണ്ട്, ഇത് true എന്ന് സജ്ജീകരിക്കുക. എന്നിരുന്നാലും ശ്രദ്ധിക്കുക: റിവേഴ്സ് ജിയോകോഡിംഗിന് ഒരു തത്സമയ ഇൻ്റർനെറ്റ് കണക്ഷൻ ആവശ്യമാണ് കൂടാതെ ലൊക്കേഷൻ പൈപ്പ്ലൈനിലേക്ക് HTTP ലേറ്റൻസി ചേർക്കുന്നു. ഓരോ 5 സെക്കൻഡിലും നിങ്ങൾ പോയിൻ്റുകൾ റെക്കോർഡ് ചെയ്യുകയാണെങ്കിൽ ഇത് ഉപയോഗിക്കരുത്, കാരണം OS-ൽ നിങ്ങൾക്ക് നിരക്ക് പരിമിതപ്പെടുത്തും.

നോട്ട്രാൻസ്0ലേറ്റ് & നോട്രാൻസ്1ലേറ്റ്

• ഡിഫോൾട്ടുകൾ: false, 1.0
• എന്ത്: ഉപയോക്താവിൻ്റെ വേഗതയെ അടിസ്ഥാനമാക്കി distanceFilter ചലനാത്മകമായി നീട്ടുന്നു.
• എപ്പോൾ അസാധുവാക്കണം: നിങ്ങൾ 300 കി.മീ/മണിക്കൂർ വേഗതയിൽ പോകുന്ന ഒരു അതിവേഗ ട്രെയിൻ ട്രാക്ക് ചെയ്യുകയാണെങ്കിൽ, ഉപകരണം ഒരു സെക്കൻ്റിൻ്റെ അംശത്തിൽ 10 മീറ്റർ കവർ ചെയ്യുന്നു. ട്രെയ്‌സ്‌ലെറ്റ് സ്വാഭാവികമായും ദൂരം ഫിൽട്ടറിനെ വേഗത കൊണ്ട് ഗുണിക്കും. നിങ്ങൾക്ക് ഉയർന്ന വേഗതയിൽ കുറച്ച് പോയിൻ്റുകൾ വേണമെങ്കിൽ, elasticityMultiplier നെ 2.0 ആയി വർദ്ധിപ്പിക്കുക. വേഗത പരിഗണിക്കാതെ നിങ്ങൾക്ക് കൃത്യമായ 10-മീറ്റർ ഡോട്ട് ട്രയൽ ഉണ്ടായിരിക്കണം (ഉദാ. സ്ട്രീറ്റ് വ്യൂ ഇമേജറി വരയ്ക്കൽ), disableElasticity: true സജ്ജീകരിക്കുക.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: 0.0 (അപ്രാപ്‌തമാക്കി)
• എന്ത്: ടാർഗെറ്റ് പരമാവധി ബാറ്ററി ഡ്രെയിനേജ് ശതമാനം മണിക്കൂറിൽ.
• എപ്പോൾ അസാധുവാക്കണം: ഉച്ചഭക്ഷണസമയത്ത് നിങ്ങളുടെ ആപ്പ് അവരുടെ ഡ്രൈവർമാരുടെ ഫോണുകളെ നശിപ്പിക്കുന്നുവെന്ന് നിങ്ങളുടെ എൻ്റർപ്രൈസ് ക്ലയൻ്റുകൾ പരാതിപ്പെടുന്നുവെങ്കിൽ, ഇത് 1.5 (മണിക്കൂറിൽ 1.5% ചോർച്ച) ആയി സജ്ജമാക്കുക. ട്രേസ്‌ലെറ്റ് ബാറ്ററി API സ്വയമേവ നിരീക്ഷിക്കും. ചോർച്ച 1.5% കവിയുന്നുവെങ്കിൽ, അത് desiredAccuracy ഡൗൺഗ്രേഡ് ചെയ്യുകയും വൈദ്യുതി ലാഭിക്കുന്നതിന് ചലനാത്മകമായി distanceFilter വർദ്ധിപ്പിക്കുകയും ചെയ്യുന്നു.

ആൻഡ്രോയിഡ് കോൺഫിഗറേഷൻ ഒബ്‌ജക്റ്റ് (config.android)

Android നിർദ്ദിഷ്ട OS നിയന്ത്രണങ്ങളും ഒപ്റ്റിമൈസേഷനുകളും.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: false
• എന്ത്: ഉപകരണം പൂർണ്ണമായും നിശ്ചലാവസ്ഥയിൽ പ്രവേശിക്കുമ്പോൾ OEM വേക്ക്‌ലോക്ക് ഡ്രോപ്പ് ചെയ്യുന്നു (MotionDetectionMode.smart ഉപയോഗിക്കുമ്പോൾ മാത്രം ബാധകമാണ്).
• എപ്പോൾ അസാധുവാക്കണം: ഭക്ഷണത്തിനായി കാത്തിരിക്കുന്ന ഒരു റെസ്റ്റോറൻ്റിനുള്ളിൽ 30 മിനിറ്റ് ചെലവഴിക്കുന്ന ഡെലിവറി ഡ്രൈവർമാർ നിങ്ങളുടെ ആപ്പ് ഉപയോഗിക്കുകയാണെങ്കിൽ. വേക്ക്‌ലോക്ക് റിലീസ് ചെയ്യുന്നത് ഫോണിൻ്റെ സിപിയുവിന് ഗാഢനിദ്രയിൽ പ്രവേശിക്കാനും വലിയ അളവിൽ ബാറ്ററി ലാഭിക്കാനും അനുവദിക്കുന്നു, അതേസമയം ഡ്രൈവർ അവരുടെ കാറിലേക്ക് തിരികെ നടക്കാൻ തുടങ്ങുന്ന നിമിഷം തന്നെ സിപിയു തൽക്ഷണം ഉണർത്താൻ ഹാർഡ്‌വെയർ ആക്‌സിലറോമീറ്ററിനെ ആശ്രയിക്കുന്നു.

ലൊക്കേഷൻ ഫിൽട്ടർ ഒബ്ജക്റ്റ് (config.geo.filter)

നിങ്ങളുടെ ഡാറ്റാബേസിൽ എത്തുന്നതിന് മുമ്പ് മോശം GPS ഡാറ്റ വൃത്തിയാക്കുന്നു.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: 80 (m/s)
• എന്ത്: ഈ വേഗതയേക്കാൾ വേഗത്തിൽ ഉപയോക്താവ് സഞ്ചരിക്കുന്നുവെന്ന് സൂചിപ്പിക്കുന്ന ലൊക്കേഷൻ ജമ്പുകൾ നിരസിക്കുന്നു.
• എപ്പോൾ അസാധുവാക്കണം: 80 m/s എന്നത് ഏകദേശം 288 km/h ആണ് (മിക്ക കാറുകളേക്കാളും വേഗത). നിങ്ങൾ ഒരു വാണിജ്യ എയർലൈൻ ഫ്ലൈറ്റ് ട്രാക്കുചെയ്യുകയാണെങ്കിൽ, ഒരു ജെറ്റ് മണിക്കൂറിൽ 900 കി.മീ. നിങ്ങൾ ഇത് 300 m/s എന്നതിലേക്ക് വർദ്ധിപ്പിക്കണം, അല്ലെങ്കിൽ ഓരോ ലൊക്കേഷൻ പോയിൻ്റും ഒരു തകരാർ ആണെന്ന് ട്രെയ്‌സ്‌ലെറ്റ് കരുതുകയും അത് വലിച്ചെറിയുകയും ചെയ്യും!

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: 50 (മീറ്റർ)
• എന്ത്: ഈ മൂല്യത്തേക്കാൾ മോശമായ കൃത്യതയുള്ള പോയിൻ്റുകൾ മൊത്തം ട്രിപ്പ് ഡിസ്റ്റൻസ് ഓഡോമീറ്ററിൽ ചേർക്കില്ല.
• എപ്പോൾ അസാധുവാക്കണം: നിങ്ങൾ ഗിഗ്-ഇക്കണോമി ഡ്രൈവർമാർക്ക് മൈൽ വഴിയാണ് പണം നൽകുന്നതെങ്കിൽ, ഒരു നദിക്ക് കുറുകെയുള്ള 500 മീറ്റർ മോശമായ GPS ബൗൺസ് അവരുടെ ശമ്പളം അന്യായമായി വർദ്ധിപ്പിക്കും. ഈ പരിധി കർശനമായി സൂക്ഷിക്കുന്നത് (ഉദാ. 30) തെളിയിക്കാവുന്നതും വളരെ കൃത്യവുമായ ദൂരത്തിന് മാത്രമേ നിങ്ങൾ പണം നൽകൂ എന്ന് ഉറപ്പാക്കുന്നു.
• കാൽനടയായി: 50 m ഡിഫോൾട്ട് കാൽനടയാത്രക്കാർക്ക് അയഞ്ഞതാണ് - നടത്തം വേഗതയിൽ 40 m-കൃത്യത പരിഹരിക്കുന്നതിന് ഉപയോക്താവ് യഥാർത്ഥത്തിൽ ഉൾക്കൊള്ളുന്നതിനേക്കാൾ കൂടുതൽ “ദൂരം” സംഭാവന ചെയ്യാൻ കഴിയും. നടക്കാൻ ~10 എന്നതിലേക്ക് ശക്തമാക്കുക, അല്ലെങ്കിൽ കണ്ടെത്തിയ ഓരോ പ്രവർത്തനത്തിനും അത് തിരഞ്ഞെടുക്കാൻ ഓട്ടോ-ട്യൂണിംഗ് അനുവദിക്കുക.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: false
• എന്ത്: ഉപയോക്താവ് ഒരു വ്യാജ GPS സ്പൂഫർ ആപ്പ് ഉപയോഗിക്കുന്നുണ്ടോ എന്ന് കണ്ടെത്തുന്നു.
• എപ്പോൾ അസാധുവാക്കണം: നിങ്ങൾ ഒരു പോക്ക്മാൻ GO ക്ലോൺ അല്ലെങ്കിൽ റൈഡ് ഷെയർ ആപ്പ് നിർമ്മിക്കുകയാണെങ്കിൽ, സിസ്റ്റത്തെ വഞ്ചിക്കാൻ ഉപയോക്താക്കൾ അവരുടെ ലൊക്കേഷൻ കബളിപ്പിക്കാൻ ശ്രമിക്കും. വ്യാജ കോർഡിനേറ്റുകൾ തൽക്ഷണം നിരസിക്കാൻ ഇത് true ആയി സജ്ജമാക്കുക.

AppConfig ഒബ്ജക്റ്റ് (config.app)

ആപ്പ് ലൈഫ് സൈക്കിൾ പെരുമാറ്റം നിയന്ത്രിക്കുന്നു.

വിവർത്തനം ചെയ്യരുത്

• ഡിഫോൾട്ട്: true
• എന്ത്: സമീപകാല ആപ്പ് ലിസ്റ്റിൽ നിന്ന് ഉപയോക്താവ് ആപ്പ് സ്വൈപ്പ് ചെയ്യുമ്പോൾ ട്രാക്കിംഗ് നിർത്തണോ?
• എപ്പോൾ അസാധുവാക്കണം: സോഷ്യൽ ആപ്പുകൾക്കായി (എൻ്റെ സുഹൃത്തുക്കളെ കണ്ടെത്തുക), ആപ്പ് നിർബന്ധിച്ച് കൊല്ലുമ്പോൾ ട്രാക്കിംഗ് നിർത്തുമെന്ന് ഉപയോക്താക്കൾ പ്രതീക്ഷിക്കുന്നു. എൻ്റർപ്രൈസ് ഫ്ലീറ്റ് ട്രാക്കിംഗിനായി, ഡ്രൈവർ പരിഗണിക്കാതെ തന്നെ ട്രാക്ക് ചെയ്യണം. ഫ്ലീറ്റ് ട്രാക്കിംഗിനായി stopOnTerminate: false സജ്ജീകരിക്കുക, ഉപയോക്താവ് ആപ്പിനെ ബലപ്രയോഗത്തിലൂടെ കൊല്ലുമ്പോൾ Tracelet തൽക്ഷണം പശ്ചാത്തലത്തിൽ സ്വയം റീബൂട്ട് ചെയ്യും.

എൻ്റർപ്രൈസ് കോൺഫിഗറേഷനുകൾ

വിവർത്തനം ചെയ്യരുത്

• എന്ത്: SQLCipher ഉപയോഗിച്ച് വിശ്രമവേളയിൽ പ്രാദേശിക SQLite ഡാറ്റാബേസ് എൻക്രിപ്റ്റ് ചെയ്യുന്നു.
• എപ്പോൾ ഉപയോഗിക്കണം: നിങ്ങൾ HIPAA-അനുസരണമുള്ള രോഗി ട്രാക്കിംഗ് കൈകാര്യം ചെയ്യുകയോ അല്ലെങ്കിൽ സൈനിക ഉദ്യോഗസ്ഥരെ ട്രാക്ക് ചെയ്യുകയോ ചെയ്യുകയാണെങ്കിൽ, ഉപകരണത്തിലേക്കുള്ള പ്രാദേശിക ഫിസിക്കൽ ആക്സസ് അവരുടെ ചരിത്രപരമായ വഴികളിൽ വിട്ടുവീഴ്ച ചെയ്തേക്കാം. ഒരു എൻക്രിപ്ഷൻ കീ നൽകുന്നത് ഉപകരണം മോഷ്ടിക്കപ്പെട്ടാൽ ഡാറ്റാബേസ് ഉപയോഗശൂന്യമാണെന്ന് ഉറപ്പാക്കുന്നു.
• അത് എങ്ങനെ അഭ്യർത്ഥിക്കാം/ഉപയോഗിക്കാം: ട്രേസ്‌ലെറ്റ് ഒരു ക്രിപ്‌റ്റോഗ്രാഫിക് സഹായി നൽകുന്നു. ആദ്യ ആപ്പ് ലോഞ്ചിൽ സുരക്ഷിതമായ ഒരു 256-ബിറ്റ് കീ സൃഷ്ടിക്കാൻ await tl.Tracelet.generateEncryptionKey()-ലേക്ക് വിളിക്കുക, അത് സുരക്ഷിതമായി സൂക്ഷിക്കുക (ഉദാ. flutter_secure_storage ഉപയോഗിച്ച്), തുടർന്നുള്ള ബൂട്ടുകളിൽ Config-ലേക്ക് കൈമാറുക:

  // 1. Generate & store on first run
  final secureKey = await tl.Tracelet.generateEncryptionKey();
  await secureStorage.write(key: 'db_key', value: secureKey);
   
  // 2. Pass to config
  final config = tl.Config(
    security: tl.SecurityConfig(encryptionKey: secureKey),
  );

വിവർത്തനം ചെയ്യരുത്

• എന്ത്: ട്രാക്കിംഗ് സ്വയമേവ പ്രവർത്തനരഹിതമാക്കുന്ന ഭൂമിശാസ്ത്രപരമായ ബഹുഭുജങ്ങൾ നിർവ്വചിക്കുക.
• എപ്പോൾ ഉപയോഗിക്കണം: പല യൂറോപ്യൻ രാജ്യങ്ങളിലെയും യൂണിയൻ നിയന്ത്രണങ്ങൾ, വീട്ടിലോ യൂണിയൻ ഹാളിലോ ഉച്ചഭക്ഷണം കഴിക്കുമ്പോൾ ഡെലിവറി ഡ്രൈവർമാരെ ട്രാക്ക് ചെയ്യുന്നതിൽ നിന്ന് തൊഴിലുടമകളെ വിലക്കുന്നു. യൂണിയൻ ഹാളിനെ PolygonZone എന്ന് നിർവചിക്കുക, അവർ ഉള്ളിലായിരിക്കുമ്പോൾ തന്നെ ട്രാക്കിംഗ് ട്രാക്കിംഗ് ബ്ലാക്ക്-ഔട്ട് ചെയ്യും, അവർ പോകുമ്പോൾ മാത്രം അത് പുനരാരംഭിക്കും.
• ഒരെണ്ണം എങ്ങനെ സൃഷ്ടിക്കാം: tl.PolygonZone ഒബ്‌ജക്റ്റുകളുടെ ഒരു ലിസ്റ്റ് PrivacyConfig-ലേക്ക് കൈമാറുക.

  final config = tl.Config(
    privacy: tl.PrivacyConfig(
      zones: [
        tl.PolygonZone(
          id: 'union_hall',
          points: [
            tl.LatLng(48.8566, 2.3522),
            tl.LatLng(48.8568, 2.3525),
            tl.LatLng(48.8563, 2.3530),
          ]
        )
      ]
    )
  );