सेशन

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

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

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 में:

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

पहली इमेज में दिखाया गया है कि फ़िटनेस स्टोर में वह टाइम इंटरवल दिखता है या नहीं जिसके दौरान ऐप्लिकेशन 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 तरीका. इस जानकारी का इस्तेमाल अपने ऐप्लिकेशन में करके, उपयोगकर्ताओं को यह दिखाया जा सकता है कि फ़िटनेस सेशन किस ऐप्लिकेशन ने जोड़े हैं. आप इसके लिए आइकन दिखा सकते हैं इनमें से हर एक ऐप्लिकेशन का इस्तेमाल किया जा सकता है.

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

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

REST

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

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