सेशन

सेशन की मदद से उपयोगकर्ता अपनी सभी मुख्य गतिविधियों की सूची तुरंत और आसानी से देख सकते हैं. ये 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()

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

आराम

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

  • ऐसे सेशन जिनमें नींद से जुड़ी अलग-अलग तरह की गतिविधियां की गई हैं:
    • 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 का इस्तेमाल किया जा सकता है:

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

आराम

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

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

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

Google Fit में:

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

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

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

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

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

आपके पास यह बताने का विकल्प है कि हर सेशन और डेटासेट को किस ऐप्लिकेशन ने शामिल किया है.

सेशन बनाना

सेशन अलग-अलग तरीकों से बनाए जा सकते हैं:

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

सेशन कब बनाएं

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

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

पढ़ने के सेशन

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

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

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

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

Android

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

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

सेशन बनाने वाले सोर्स को ढूंढने के बारे में ज़्यादा जानें.

आराम

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

सेशन बनाने वाले सोर्स को ढूंढने के बारे में ज़्यादा जानें.