ड्राइविंग एवं सुरक्षा

ट्रेसलेट कच्चे स्थान + एक्सेलेरोमीटर स्ट्रीम को सार्थक में बदल सकता है कोई उपकरण कैसे चल रहा है, इसके बारे में घटनाएँ - पूरी तरह से उपकरण पर, बिना किसी बादल के कॉल. 3.3.0 में जोड़ी गई, तीन स्वतंत्र विशेषताएं हैं:

| फ़ीचर | यह आपको क्या बताता है | आप इसे | के साथ सक्षम करें आप सुनिए | के साथ |---|---|---|---| | ड्राइविंग इवेंट | “ड्राइवर ने ज़ोर से ब्रेक लगाया / तेज़ गति से तेज़ किया / तेज़ मोड़ लिया / तेज़ गति से गाड़ी चला रहा है” | TelematicsConfig | Tracelet.onDrivingEvent | | परिवहन मोड | “उपयोगकर्ता अब किसी वाहन में चल रहा है/दौड़ रहा है/साइकिल चला रहा है” | ClassifierConfig | Tracelet.onModeChange | | दुर्घटना एवं पतन | “अभी-अभी दुर्घटना (या गिरावट) हुई होगी” | ImpactConfig | Tracelet.onImpact |

यह किसके लिए है? (वास्तविक दुनिया के उदाहरण)

• उपयोग-आधारित बीमा/बेड़े की सुरक्षा → ड्राइविंग इवेंट आपको प्रति-यात्रा प्रदान करते हैं बिना किसी सर्वर-साइड के जोखिम भरी ड्राइविंग (कठोर ब्रेक लगाना, तेज़ गति) की तस्वीर प्रसंस्करण.
• डिलीवरी / फील्ड-सर्विस ऐप्स → परिवहन मोड आपको प्रत्येक यात्रा को इस प्रकार टैग करने देता है ड्राइविंग बनाम चलना (उदाहरण के लिए “वैन छोड़ कर, दरवाजे तक चलकर”)।
• अकेला-कार्यकर्ता / राइडशेयर / व्यक्तिगत-सुरक्षा ऐप्स → दुर्घटना और गिरावट का पता लगाना आपको एक भरोसेमंद ट्रिगर देता है (उपयोगकर्ता के साथ “मैं ठीक हूं” विंडो रद्द करें)। एक SOS प्रवाह प्रारंभ करें.

आप किसी भी संयोजन को सक्षम कर सकते हैं - वे स्वतंत्र हैं।

1. ड्राइविंग इवेंट (टेलीमैटिक्स)

30 सेकंड का संस्करण

// 1. Turn it on (e.g. with a 50 km/h limit for speeding)
await Tracelet.ready(Config(
  telematics: TelematicsConfig(
    enableDrivingEvents: true,
    speedLimitKmh: 50,
  ),
));
 
// 2. Listen
Tracelet.onDrivingEvent((event) {
  print('${event.kind} — severity ${event.severity}');
});
 
// 3. Start tracking as usual
await Tracelet.start();

इतना ही। जैसे ही उपकरण चलेगा, आपको इस तरह की घटनाएं मिलेंगी:

harsh_braking — severity 0.82
speeding — severity 0.40

प्रत्येक फ़ील्ड का क्या अर्थ है

प्रत्येक DrivingEvent में है:

दहलीज़ को ट्यून करना

सभी सीमाएं g (1 g ≈ 9.81 m/s², गुरुत्वाकर्षण का खिंचाव) में हैं। डिफ़ॉल्ट सामान्य बीमा/बेड़े अभ्यास का पालन करें - आपको शायद ही कभी उन्हें बदलने की आवश्यकता होगी:

2. परिवहन साधन

आपको बताता है कि क्या उपयोगकर्ता still, walking, running, cycling, या में है जीपीएस स्पीड के साथ एक्सेलेरोमीटर मूवमेंट को जोड़कर vehicle।

await Tracelet.ready(Config(
  classifier: ClassifierConfig(enableFusedClassifier: true),
));
 
Tracelet.onModeChange((event) {
  print('Now: ${event.mode} (confidence ${event.confidence})');
});

स्थान फ़िल्टर को स्वतः ट्यून करना

दूरी-सटीक ट्रैकिंग के लिए अलग-अलग फ़िल्टर थ्रेशोल्ड की आवश्यकता होती है गतिविधियाँ। चलना कठिन मामला है: ~1.4 मीटर/सेकेंड पर जीपीएस शोर तल बड़ा है आप वास्तव में कितनी दूर चले गए इसका एक अंश, इसलिए एक ढीला फ़िल्टर घबराहट को रिकॉर्ड करता है दूरी। एक कार में विपरीत स्थिति कायम रहती है - तंग दहलीज असली चीज़ को ख़त्म कर देती है आंदोलन।

आप सामने से एक सेट अप नहीं चुन सकते. आपके उपयोगकर्ता यह घोषणा नहीं करते कि “मैं अब जॉगिंग कर रहा हूं”, और एक एकल सत्र में नियमित रूप से ट्रेलहेड तक चलना, दौड़ना और शामिल होता है वापस जाओ। तो क्लासिफायरियर को निर्णय लेने दें:

await Tracelet.ready(Config(
  classifier: ClassifierConfig(
    enableFusedClassifier: true,        // required
    autoTuneFromTransportMode: true,
  ),
));

जब कोई मोड प्रतिबद्ध होता है, तो ट्रैसलेट इसके अनुकूल मानों के लिए चार थ्रेसहोल्ड को स्वैप करता है:

जॉगिंग में जानबूझकर कोई पंक्ति नहीं है - यह running बैंड (6-20 किमी/घंटा) के अंदर आता है, यही कारण है कि उपयोगकर्ता-सामना करने वाला “जॉगिंग प्रीसेट” काल्पनिक रहा होगा।

यह कैसे पूर्वानुमानित रहता है:

• रीट्यूनिंग केवल प्रतिबद्ध मोड परिवर्तन पर होती है - पहले से ही आत्मविश्वास से भरपूर और modeSwitchDwellMs द्वारा खारिज कर दिया गया - प्रति सेंसर रीडिंग कभी नहीं, इसलिए थ्रेसहोल्ड बकबक नहीं कर सकते.
• थ्रेसहोल्ड की अदला-बदली स्थान-स्थान पर की जाती है। आपका ओडोमीटर एक के पार निरंतर रहता है एक खंड खोने के बजाय मोड परिवर्तन।
• लागू मान onModeChange ईवेंट और डिबग लॉग में आते हैं, इसलिए एक ऑटो-ट्यून कभी चुप नहीं रहता.
• unknown आपने जो कुछ भी कॉन्फ़िगर किया है उसे पुनर्स्थापित करता है। ट्रेसलेट को अंदाज़ा नहीं है कि यह कब होगा पता नहीं।
• autoTuneFromTransportMode (या enableFusedClassifier) को बंद किया जा रहा है रनटाइम आपके कॉन्फ़िगर किए गए थ्रेशोल्ड को तुरंत पुनर्स्थापित करता है - सुविधा कभी नहीं एक बार जब आप इसे बंद कर देते हैं तो यह अपना प्रभाव छोड़ देता है।

जो लगाया गया उसे देखकर

ModeChangeEvent.appliedTuning में वे चार सीमाएँ शामिल हैं जो डाली गई थीं बल। ऑटो-ट्यूनिंग बंद होने पर यह null है, और जब मोड unknown है (जो आपके अपने मूल्यों को पुनर्स्थापित करता है):

Tracelet.onModeChange((event) {
  final tuning = event.appliedTuning;
  if (tuning == null) {
    print('${event.mode} — your configured thresholds are in force');
  } else {
    print('${event.mode} → distanceFilter ${tuning.distanceFilter} m, '
        'odometerAccuracyThreshold ${tuning.odometerAccuracyThreshold} m');
  }
});

debug: true और logLevel: verbose के साथ लॉग में समान मान दिखाई देते हैं:

auto-tune: 'walking' → distanceFilter=8.0m trackingAccuracy=15m odometerAccuracy=10m maxImpliedSpeed=4m/s

अभी जो लागू है उसे पढ़ रहा हूँ

onModeChange आपको उस पल के बारे में बताता है जो एक मोड शुरू करता है। यह पूछने के लिए कि क्या फ़िल्टर का उपयोग किसी भी बिंदु पर किया जा रहा है - जिसमें तब भी शामिल है जब कोई मोड परिवर्तन नहीं हुआ हो घंटे - Tracelet.getCurrentLocationTuning() का उपयोग करें:

final tuning = await Tracelet.getCurrentLocationTuning();
print('in force: distanceFilter ${tuning?.distanceFilter} m, '
    'trackingAccuracyThreshold ${tuning?.trackingAccuracyThreshold} m');

यह मूल स्थान प्रोसेसर से वापस पढ़ता है, आपके कॉन्फ़िगरेशन से नहीं तय करना। यह अंतर मायने रखता है: Tracelet.activeConfig एक डार्ट-साइड मिरर है आपने अंतिम Config पास किया था, इसलिए यह रिपोर्ट करता है कि आपने क्या मांगा, न कि क्या फ़िल्टर वास्तव में उपयोग कर रहा है - और यह आपको बिल्कुल भी ऑटो-ट्यून नहीं दिखा सकता है, क्योंकि एक ऑटो-ट्यून बिना किसी कॉन्फिग कॉल के थ्रेशोल्ड को बदल देता है।

किसी ट्रैकिंग सत्र में प्रोसेसर बनने से पहले null लौटाता है, और हमेशा वेब पर null, जिसकी कोई समकक्ष फ़िल्टर स्थिति नहीं है।

3. दुर्घटना एवं गिरावट का पता लगाना

संभावित दुर्घटना का पता लगाता है (एक कठिन प्रभाव चलते समय) या, वैकल्पिक रूप से, ए व्यक्तिगत गिरावट. क्योंकि झूठे अलार्म महंगे होते हैं, इसलिए पता लगाना पुष्ट होता है (अकेला एक बड़ा झटका कभी भी पर्याप्त नहीं होता) और उपयोगकर्ता को रद्द करने के लिए उलटी गिनती देता है।

await Tracelet.ready(Config(
  impact: ImpactConfig(
    enableCrashDetection: true,
    confirmWindowMs: 15000,   // 15s for the user to say "I'm fine"
  ),
));
 
Tracelet.onImpact((event) async {
  if (event.isPotential) {
    // Show a big "Are you OK?" countdown screen.
    // If the user taps "I'm fine":
    await Tracelet.cancelImpact(event.id);
    // If they tap "Get help now":
    // await Tracelet.confirmImpact(event.id);
  } else {
    // event.kind == 'crash' (or 'fall') — confirmed.
    // The user didn't cancel in time → start your SOS flow.
  }
});

प्रवाह कैसे काम करता है

1. तेजी से चलते समय एक कठिन प्रभाव → आपको potential_crash ईवेंट मिलता है एक confirmDeadline।
2. उलटी गिनती यूआई दिखाएं। उपयोगकर्ता रद्द (cancelImpact) या अभी पुष्टि कर सकता है (अनुवादित नहीं)।
3. यदि वे समय सीमा से पहले कुछ नहीं करते हैं → पुष्टि की गई crash घटना सक्रिय हो जाती है।

पुष्टिकरण ऐप के ख़त्म होने से बच जाता है

एक हिंसक प्रभाव अक्सर ओएस द्वारा ऐप को ख़त्म करने के साथ समाप्त होता है - फ़ोन फेंक दिया जाता है, वाहन रुक जाता है, उपकरण डोज़ में चला जाता है। यदि रद्द-उलटी गिनती केवल स्मृति में रहता था, पुष्टि की गई crash/fall चुपचाप कभी सक्रिय नहीं होगी। ट्रेसलेट उलटी गिनती को प्रक्रिया-मृत्यु को सुरक्षित बनाता है: तत्काल ए potential_crash/potential_fall बढ़ा दिया गया है, यह डिस्क पर कायम है और a वेक-अप समय सीमा के ठीक बाद के लिए सशस्त्र है। यदि ऐप अभी भी जीवित है सामान्य रूप से पुष्टि करता है और वेक-अप को निष्क्रिय कर देता है; यदि यह मारा गया, तो जाग जाओ एक ताजा प्रक्रिया से पुष्टि की गई घटना को पुनः उत्सर्जित करता है ताकि आपका एसओएस प्रवाह अभी भी चलता रहे।

एक उपयोगकर्ता रद्द करें मौजूदा उम्मीदवार को हटा देता है और वेक-अप को निष्क्रिय कर देता है, इसलिए a पुनः आरंभ करने के बाद रद्द किए गए उम्मीदवार की दोबारा पुष्टि नहीं की जाती है।

अतिरिक्त सुराग जो वास्तविक दुर्घटना या गिरावट की पुष्टि करते हैं

अपने आप में एक बड़ा झटका पर्याप्त नहीं है - यह बहुत सारे झूठे अलार्म पैदा करेगा। इसलिए ट्रैसलेट अतिरिक्त वास्तविक दुनिया के सुरागों की तलाश करता है जो आम तौर पर वास्तविकता के दौरान घटित होते हैं दुर्घटना या गिरना. वह जितने अधिक सुराग देखता है, वह उतना ही अधिक आश्वस्त होता है। ये सुराग ही कर सकते हैं ट्रैसलेट को अधिक आश्वस्त बनाएं - वे कभी भी किसी वास्तविक घटना को रद्द नहीं करते हैं।

• फोन गिर रहा था - इससे ठीक पहले कि कोई अपना फोन गिराए या उठाए गिरने पर, फ़ोन कुछ समय के लिए भारहीन हो जाता है। स्पॉटिंग से गिरावट अधिक होती है विश्वसनीय.
• बाद में सब कुछ स्थिर हो गया - वास्तविक गिरावट के बाद, व्यक्ति और फोन आमतौर पर हिलना बंद कर दें। वह अचानक शांति एक मजबूत संकेत है।
• कार अचानक रुक गई - वास्तविक दुर्घटना में वाहन तेजी से आगे बढ़ता है एक या दो सेकंड में लगभग रुक गया। गति में तेज गिरावट दुर्घटना का कारण बनती है।
• एक दबाव “पॉप” - एक गंभीर दुर्घटना (या एक एयरबैग बंद हो जाना) के कारण त्वरित दुर्घटना होती है कार के अंदर हवा के दबाव में बदलाव. जिन फ़ोनों में प्रेशर सेंसर हो सकता है इस पर ध्यान दें; बिना किसी नकारात्मक पक्ष के फ़ोन इस जांच को छोड़ देते हैं।

वैकल्पिक: लाइसेंस प्राप्त AI क्रैश मॉडल

डिफ़ॉल्ट रूप से क्रैश डिटेक्शन एक नियम इंजन (जी-थ्रेसहोल्ड + स्पीड) का उपयोग करता है उपरोक्त पुष्टि) - कोई अतिरिक्त सेटअप नहीं, बॉक्स से बाहर काम करता है। उच्च सटीकता के लिए आप एआई क्रैश मॉडल को सक्षम कर सकते हैं: एक प्रशिक्षित मॉडल जो गेट्स पर क्रैश हो जाता है एक निश्चित सीमा के बजाय सीखी गई संभाव्यता।

यह ऑप्ट-इन है और मांग पर डाउनलोड किया जाता है (एम्बेडेड नहीं), इसलिए आधार एसडीके आकार अपरिवर्तित है. इसे चालू करने के लिए, एक लाइसेंस कुंजी प्राप्त करें और अपनी कॉन्फ़िगरेशन को उस पर इंगित करें:

await Tracelet.ready(Config(
  impact: ImpactConfig(
    enableCrashDetection: true,
    crashModelUnlockUrl: 'https://unlock.ikolvi.com/unlock',
    crashModelLicenseKey: '<your license key>',
    crashModelThreshold: 0.5074,   // rf_probability_threshold from training
  ),
));

यदि मॉडल किसी भी कारण से सक्रिय नहीं हो पाता है (ऑफ़लाइन, अमान्य कुंजी) तो SDK स्वचालित रूप से नियम इंजन पर वापस आ जाता है - आपका ऐप काम करता रहता है।

लाइसेंस प्राप्त करें

लाइसेंस प्राप्त करें पृष्ठ से एक कुंजी लें: साइन इन करें, अपना दर्ज करें एप्लिकेशन आईडी, और रेडी-टू-पेस्ट कुंजी (या पूर्ण ImpactConfig) की प्रतिलिपि बनाएँ स्निपेट)।

• डेव लाइसेंस - डिबग बिल्ड और एमुलेटर के लिए। बस आपकी ऐप आईडी, कोई अतिरिक्त नहीं स्थापित करना।
• उत्पाद लाइसेंस — आपके भेजे गए ऐप के लिए; आपके ऐप साइनिंग-सर्टिफिकेट की भी आवश्यकता है SHA-256 (प्ले कंसोल → ऐप अखंडता → ऐप साइनिंग, या ./gradlew signingReport)।

पोर्टल आपकी जारी की गई चाबियों को भी सूचीबद्ध करता है और आपको तुरंत निरस्त करने देता है।

ड्राइविंग (सिमुलेशन) और डेटाबेस एक्सेस के बिना इसे आज़माना

ट्रैसलेट में टेलीमैटिक्स घटनाओं को संग्रहीत करने के लिए समर्पित डेटाबेस टेबल और डायग्नोस्टिक एपीआई का एक सेट शामिल है। ट्रेसलेट डॉक्टर डायग्नोस्टिक ओवरले द्वारा इनका भारी उपयोग किया जाता है, लेकिन आप इन्हें सीधे अपने ऐप में कस्टम डायग्नोस्टिक स्क्रीन बनाने या कार को भौतिक रूप से चलाने या दुर्घटनाग्रस्त करने की आवश्यकता के बिना अपने सुरक्षा प्रवाह का परीक्षण करने के लिए भी उपयोग कर सकते हैं।

डेटाबेस से टेलीमैटिक्स पुनर्प्राप्त करना

प्रत्येक ड्राइविंग और प्रभाव घटना स्वचालित रूप से स्थानीय SQLite डेटाबेस में बनी रहती है। जोखिम भरे ड्राइविंग व्यवहार का इतिहास प्रदर्शित करने के लिए आप इन संरचित रिकॉर्ड को पुनः प्राप्त कर सकते हैं:

// Fetch the 50 most recent telematics events from the database
final events = await Tracelet.getTelematicsEvents(50);
 
for (final event in events) {
  print('Event Type: \${event.eventType}');   // e.g. harsh_braking, crash
  print('Severity: \${event.severity}');
  print('Location: \${event.latitude}, \${event.longitude}');
}

इवेंट नवीनतम पहले वापस आते हैं, और समन्वयन उन्हें इससे नहीं हटाता है देखें - syncTelematics को सक्षम करने से ईवेंट अपलोड हो जाते हैं लेकिन आपका स्थानीय इतिहास छूट जाता है अखंड।

उन्हें आपके बैकएंड पर भेजा जा रहा है

HttpConfig.syncTelematics: true सेट करें और अनसिंक किए गए ईवेंट आपके सामान्य रूप में चलते हैं स्थान सिंक - एक ही पोस्ट पर एक रूट-स्तरीय telematics सरणी, या उनका अपना जब आप HttpConfig.telematicsUrl सेट करें तो अनुरोध करें। विफल अपलोड ईवेंट बनाए रखते हैं उन्हें छोड़ने के बजाय कतारबद्ध किया गया। वायर स्कीमा के लिए, बैचिंग सीमाएं और अलग-अंतबिंदु व्यापार-बंद, देखें टेलीमैटिक्स सिंक 📖।

घटनाओं का अनुकरण

आप मॉक टेलीमैटिक्स इवेंट को सीधे देशी ट्रैकिंग इंजन में इंजेक्ट कर सकते हैं। यह आपके ऐप की प्रतिक्रिया (जैसे किसी क्रैश पर एसओएस स्क्रीन दिखाना) या आपके यूआई घटकों का परीक्षण करने के लिए बिल्कुल सही है। उदाहरण ऐप का ड्राइविंग और सुरक्षा पृष्ठ और ट्रैसलेट डॉक्टर ओवरले इस एपीआई का उपयोग डेवलपर्स को बटन के माध्यम से घटनाओं को ट्रिगर करने की अनुमति देने के लिए करते हैं।

// Simulate a harsh braking event (named arguments)
await Tracelet.simulateTelematicsEvent(
  eventType: 'harsh_braking',
  severity: 0.85, // 0.0 to 1.0
  latitude: 37.422,
  longitude: -122.084,
);

डेटाबेस साफ़ करना

यदि आपको डायग्नोस्टिक स्थिति को रीसेट करने या स्थानीय डेटाबेस से टेलीमैटिक्स घटनाओं के इतिहास को साफ़ करने की आवश्यकता है, तो आप कतार को शुद्ध कर सकते हैं:

await Tracelet.destroyTelematicsEvents();

स्वचालित परीक्षणों में, आप इंजन को सीधे डार्ट से भी चला सकते हैं (वे flutter_rust_bridge के माध्यम से उजागर होते हैं) - example/integration_test/behavior_simulation_test.dart देखें।

अनुमतियां

• ड्राइविंग इवेंट को केवल उस स्थान की अनुमति की आवश्यकता है जिसके लिए आप पहले से ही उपयोग कर रहे हैं ट्रैकिंग - कुछ भी अतिरिक्त नहीं।
• ट्रांसपोर्ट मोड और क्रैश/फ़ॉल एक्सेलेरोमीटर का उपयोग करें। एंड्रॉइड पर वह है गति पहचान के लिए पहले से ही चल रहा है (कोई नई अनुमति नहीं)। iOS पर, जोड़ रहा हूँ मोशन और फिटनेस उपयोग विवरण सटीकता में सुधार करता है। देखें आईओएस और एंड्रॉइड सेटअप पेज।

जानकर अच्छा लगा

• ऑन-डिवाइस और नियतात्मक - सभी पहचान साझा रस्ट कोर में चलती है। नहीं नेटवर्क, कोई क्लाउड मॉडल नहीं, Android और iOS पर समान परिणाम।
• ड्राइविंग इवेंट वेब पर भी काम करते हैं (वे जीपीएस-व्युत्पन्न हैं)।
• साइड-चैनल - ये घटनाएँ आपके सामान्य के साथ-साथ वितरित की जाती हैं onLocation स्ट्रीम; वे कभी भी आपका स्थान या ओडोमीटर नहीं बदलते, और वे अपने सिंक पेलोड से तभी जुड़ें जब आप syncTelematics के साथ ऑप्ट इन करते हैं।