सेशन

सेशन की मदद से, उपयोगकर्ता अपनी सभी मुख्य गतिविधियों की सूची को तेज़ी से और आसानी से देख सकते हैं. ये Google Fit ऐप्लिकेशन के जर्नल पेज पर दिखते हैं. उदाहरण के लिए, सांस के सेशन, सैर, दौड़ने या रात की नींद के सभी उदाहरण सेशन के उदाहरण हैं.

सेशन, किसी खास समयावधि में इकट्ठा किए गए डेटासेट को इकट्ठा करते हैं. इन्हें किसी गतिविधि के दौरान इकट्ठा किया जाता है. उदाहरण के लिए, अगर किसी उपयोगकर्ता ने 3 किलोमीटर की दौड़ शुरू करने और खत्म करने पर ट्रैक किया है, तो एक सेशन बनाया जा सकता है और उस समय के अंदर आने वाला सभी फ़िटनेस डेटा (जैसे, कदम, रफ़्तार, दूरी) को उस सेशन के साथ जोड़ा जाएगा.

सेशन में गतिविधि के बारे में जानकारी शामिल नहीं होती. यह डेटासेट में है. सेशन में ये प्रॉपर्टी होती हैं:

  • आसान और जानकारी देने वाला नाम (जैसे, "मॉर्निंग रन")
  • वर्णन
  • एक यूनीक आइडेंटिफ़ायर
  • वह किस तरह की गतिविधि कैप्चर करती है (उदाहरण के लिए, दौड़)

सेशन इस्तेमाल करने के फ़ायदे

  • उपयोगकर्ताओं के लिए उपयोगी: सेशन की मदद से, आप गतिविधि का डेटा और कसरतों को उपयोगकर्ताओं के लिए आसानी से व्यवस्थित कर सकते हैं. वे दिन भर की अपनी सभी गतिविधियां, Google Fit ऐप्लिकेशन के जर्नल पेज पर देख सकते हैं.
  • ऐप्लिकेशन का एक जैसा अनुभव: अगर आपका ऐप्लिकेशन या साथी डिवाइस, गतिविधि को ट्रैक करने (जहां उपयोगकर्ता किसी गतिविधि को शुरू कर सकते हैं और बंद कर सकते हैं) की अनुमति देता है, तो इन कसरतों के सेशन होने से उपयोगकर्ता दोनों ऐप्लिकेशन पर अपनी गतिविधि देख सकते हैं.
  • ज़्यादा पूरा डेटा: Google Fit भी कई स्रोतों से मिले डेटा को मर्ज करता है, ताकि आपके सेशन की जानकारी को बेहतर बनाने में मदद मिल सके. इससे उपयोगकर्ताओं को उनकी गतिविधि की पूरी जानकारी मिलती है.
  • Google Fit प्लैटफ़ॉर्म का फ़ायदा उठाएं: अगर आपके उपयोगकर्ता अपनी गतिविधि ट्रैक नहीं करते या आपके ऐप्लिकेशन में ट्रैकिंग की सुविधा नहीं है, तो भी आप Google Fit में सेशन पढ़ सकते हैं. आप फ़िटनेस स्टोर से ज़्यादा जानकारी वाला या क्वेरी करके डेटा इकट्ठा कर सकते हैं. साथ ही, उपलब्ध स्कीमा की मदद ले सकते हैं. इसके लिए, आपको अपना स्कीमा और स्टोरेज लागू करने की ज़रूरत नहीं है.
  • यूज़र ऐक्टिविटी में बढ़ोतरी: आप अपने उपयोगकर्ताओं को उपलब्ध सेशन और उन्हें बनाने वाले ऐप्लिकेशन दिखा सकते हैं. इस तरह दूसरे फ़िटनेस ऐप्लिकेशन के साथ इंटरैक्ट करने से, आपका यूज़र ऐक्टिविटी बढ़ सकती है.

सेशन के लिए उपयोगकर्ता की अनुमति पाना

अगर आप सत्र पढ़ना या लिखना चाहते हैं, तो आपके ऐप्लिकेशन को उपयोगकर्ता की अनुमति लेनी होगी. सेशन के ऐक्सेस की सुविधा में, डेटा टाइप के तौर पर उन अनुमति के दायरे का इस्तेमाल होता है जिनका अनुरोध आपको इस तरह से करना चाहिए:

Android

FitnessOptions में बताए गए सही तरीकों का इस्तेमाल करके, बताएं कि आपका ऐप्लिकेशन किस तरह का सेशन ऐक्सेस करना चाहता है. उदाहरण के लिए, दौड़ने से जुड़े सेशन पढ़ने के लिए, आप इनमें से कोई विकल्प चुन सकते हैं:

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

इस उदाहरण से पता चलता है कि आपका ऐप्लिकेशन, गतिविधि के सेशन का मेटाडेटा ऐक्सेस करना चाहता है. साथ ही, यह ऐसे डेटा टाइप भी बताता है जिन्हें वह उन सेशन में पढ़ना चाहता है. इस उदाहरण में, धड़कन की दर, रफ़्तार, और जगह की जानकारी के डेटा का इस्तेमाल किया जाता है.

बाकी

दायरों का अनुरोध इस तरह से करें:

  • नींद के गतिविधि सेशन वाले सेशन:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • अन्य सभी सेशन:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

सेशन का इस्तेमाल किया जा रहा है

Android

आप सेशन एपीआई का इस्तेमाल करके ये काम कर सकते हैं:

  • रीयल टाइम में सेशन बनाएं
  • फ़िटनेस स्टोर में सेशन डालें
  • कसरत के दौरान रोकने के लिए, गतिविधि सेगमेंट जोड़ें
  • उनसे जुड़े सेशन और डेटासेट पढ़ें
  • सेशन के बारे में जानकारी देने के लिए, दूसरा ऐप्लिकेशन लॉन्च करें
  • जब कोई दूसरा ऐप्लिकेशन सेशन शुरू करे, तब इंटेंट पाएं

बाकी

आप सेशन एपीआई का इस्तेमाल करके ये काम कर सकते हैं:

  • रीयल टाइम में सेशन बनाएं
  • फ़िटनेस स्टोर में सेशन डालें
  • कसरत के दौरान रोकने के लिए, गतिविधि सेगमेंट जोड़ें
  • उनसे जुड़े सेशन और डेटासेट पढ़ें

डेटासेट और सेगमेंट, सेशन के साथ कैसे इंटरैक्ट करते हैं

Google Fit में:

  • डेटासेट में, किसी खास समयावधि के दौरान, किसी खास डेटा सोर्स के डेटा पॉइंट के सेट को दिखाया जाता है. डेटासेट खुद शामिल किए जा सकते हैं. हालांकि, अगर आप एक सेशन बना रहे हैं, तो सेशन और उसके डेटासेट को आसानी से एक साथ बनाएं.
  • कोई सेगमेंट, सेशन में डेटासेट को उपयोगकर्ता की उस सटीक गतिविधि के हिसाब से ग्रुप करता है जो उपयोगकर्ता सेशन में कर रहा था. उदाहरण के लिए, अगर उपयोगकर्ता 30 मिनट की दौड़ (सेशन) को ट्रैक करता है, लेकिन इस दौरान थोड़ी देर चला, तो उसे सेगमेंट में बांटा जा सकता है. दौड़ने के लिए एक सेगमेंट होगा, फिर वॉकिंग ब्रेक और फिर फिर से चलाया जाएगा.
पहली इमेज: अलग-अलग ऐप्लिकेशन, [fitनेस स्टोर] में सेशन और डेटासेट जोड़ते हैं.

इमेज 1, फ़िटनेस स्टोर में समय अंतराल दिखाता है, जिसके दौरान ऐप्लिकेशन A, B, और C ने कुछ डेटासेट और सेशन डाले हैं:

  • ऐप्लिकेशन A ने सत्र 1 और A3 के साथ, किसी भी सत्र के साथ अलग से डेटासेट A1 और A2 डाले.
  • ऐप्लिकेशन B ने सत्र 2 में डेटासेट B1 और B2 को एक साथ शामिल किया.
  • ऐप्लिकेशन C ने किसी भी सेशन से अलग, डेटासेट C1 डाला.

फ़िटनेस स्टोर से सत्र डेटा पढ़ते समय, सत्र का समय अंतराल के अंदर आने वाला सभी फ़िटनेस डेटा उस सत्र के साथ अपने आप जुड़ जाता है, भले ही आप सत्र बनाने के बाद डेटा डालते हैं या डेटा को शांत तरीके से ट्रैक किए जाने के बाद सत्र बनाते हैं. उदाहरण के लिए, सत्र 1 के फ़िटनेस डेटा की क्वेरी लौटेगी:

  • डेटासेट A1
  • डेटासेट A2
  • t1 और t2 के बीच, डेटासेट A3 का हिस्सा
  • t1 और t2 के बीच, डेटासेट C1 का हिस्सा

इसकी मदद से यह बताया जा सकता है कि कौनसा ऐप्लिकेशन हर सेशन और डेटासेट को शामिल कर रहा है.

सेशन बनाना

सेशन कई तरीकों से बनाए जा सकते हैं:

  • आपका ऐप्लिकेशन इनमें से किसी एक विकल्प की मदद से सेशन बना सकता है
    • रीयल टाइम में, जब कोई उपयोगकर्ता किसी डिवाइस पर सिर्फ़ ऐक्टिविटी ट्रैक करता है (सिर्फ़ Android) या
    • मैन्युअल रूप से शामिल करके.
  • जब कोई उपयोगकर्ता, मैन्युअल तरीके से Google Fit ऐप्लिकेशन में कसरत या गतिविधि जोड़ता है.

सेशन कब बनाएं

क्या आप नींद का डेटा जोड़ रहे हैं?

  • हां - कोई सेशन बनाएं और उसे फ़िटनेस स्टोर में मैन्युअल तरीके से डालें. उदाहरण के लिए, स्लीप सेशन शामिल करना. ऐसा ऐसा इसलिए है, क्योंकि नींद के पैटर्न पर नज़र रखने वाले ऐप्लिकेशन या डिवाइस की मदद से, उपयोगकर्ता अपनी नींद से जुड़ी गतिविधि शुरू और बंद करने के लिए, डिवाइस के साथ इंटरैक्ट नहीं करते हैं. इसे शांत तरीके से ट्रैक किया जाता है.
  • नहीं - क्या आपका ऐप्लिकेशन, उपयोगकर्ताओं को गतिविधियों को शुरू करने और रोकने की सुविधा देता है?

किताबें पढ़ने के सेशन

आपका ऐप्लिकेशन कई तरीकों से सेशन पढ़ सकता है:

  • वह खास सेशन खोजें जिसे उसने बनाया/शामिल किया है
    • नाम या
    • इंडोनेशिया
  • समयावधि के अनुसार बनाए गए/शामिल किए गए सभी सेशन देखें
  • समयावधि के अनुसार सभी ऐप्लिकेशन (Google Fit सहित) के ज़रिए बनाए गए सभी सेशन देखें

जानें कि किन स्रोतों ने सेशन बनाया

आप अपने उपयोगकर्ताओं को दिखा सकते हैं कि उनके हर सेशन को किस ऐप्लिकेशन या डिवाइस ने बनाया है. हर सेशन में उससे जुड़ा डेटा सोर्स होता है, जिसमें डेटा को इकट्ठा या बदलने वाले ऐप्लिकेशन या डिवाइस के बारे में जानकारी होती है.

Android

फ़िलहाल, आप सिर्फ़ Android क्लाइंट के लिखे गए सेशन का पैकेज नाम पा सकते हैं. सेशन बनाने वाले ऐप्लिकेशन का पैकेज नाम पाने के लिए, getAppPackageName तरीके का इस्तेमाल करें. अपने ऐप्लिकेशन में इस जानकारी का इस्तेमाल करके, उपयोगकर्ताओं को बताया जा सकता है कि किन दूसरे ऐप्लिकेशन ने फ़िटनेस सेशन शामिल किए हैं. इन ऐप्लिकेशन के लिए आइकॉन दिख सकता है, ताकि उपयोगकर्ता उन्हें पहचान सकें.

उनके बनाए गए सेशन की जानकारी देखने के लिए, इंटेंट से अन्य ऐप्लिकेशन भी लॉन्च किए जा सकते हैं. दूसरे ऐप्लिकेशन भी आपके ऐप्लिकेशन को लॉन्च करने की इच्छा पैदा कर सकते हैं.

सेशन बनाने वाले सोर्स का पता लगाने के बारे में ज़्यादा जानें.

बाकी

सेशन बनाने वाले Android ऐप्लिकेशन के पैकेज का नाम पाने के लिए, session.application प्रॉपर्टी का इस्तेमाल करें. REST API का इस्तेमाल करके बनाए गए सेशन के लिए, इसके बजाय session.name प्रॉपर्टी का इस्तेमाल करें. आप अपने ऐप्लिकेशन में इस जानकारी का इस्तेमाल यह दिखाने के लिए कर सकते हैं कि किन दूसरे ऐप्लिकेशन ने फ़िटनेस सेशन बनाए हैं. आप उनमें से हर एक ऐप्लिकेशन का आइकॉन दिखा सकते हैं, ताकि उपयोगकर्ता उन्हें पहचान सकें.

सेशन बनाने वाले सोर्स का पता लगाने के बारे में ज़्यादा जानें.