सेशन

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

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

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

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

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

  • उपयोगकर्ताओं के लिए मददगार: सेशन की मदद से, गतिविधि के डेटा और वर्कआउट को उपयोगकर्ताओं के लिए बेहतर तरीके से व्यवस्थित किया जा सकता है. वे 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()

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

REST

स्कोप के लिए इस तरह अनुरोध करें:

  • नींद से जुड़ी गतिविधि वाले सेशन:
    • 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

Sessions API का इस्तेमाल इन कामों के लिए किया जा सकता है:

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

REST

Sessions API का इस्तेमाल इन कामों के लिए किया जा सकता है:

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

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

Google Fit में:

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

पहली इमेज में, फ़िटनेस स्टोर में एक समयावधि दिखाई गई है. इस दौरान, ऐप्लिकेशन A, B, और C ने कुछ डेटासेट और सेशन डाले हैं:

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

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

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

आपको यह पता चल सकता है कि कौनसा ऐप्लिकेशन, कौनसा सेशन और डेटासेट डालता है.

सेशन बनाना

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

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

सेशन कब बनाना चाहिए

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

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

पढ़ने के सेशन

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

  • उसने कौनसी सेशन कुकी बनाई/इंसर्ट की है, यह देखने के लिए
    • नाम या
    • आईडी
  • समयसीमा के हिसाब से, उन सभी सेशन को ढूंढें जिन्हें इसने बनाया/जोड़ा है
  • समय के हिसाब से, सभी ऐप्लिकेशन (Google Fit भी शामिल है) के बनाए गए सभी उपलब्ध सेशन ढूंढें

जानें कि किन सोर्स से सेशन बनाया गया है

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

Android

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

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

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

REST

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

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