الجلسات

تُعد الجلسات وسيلة للمستخدمين للاطلاع بسرعة وسهولة على قائمة بجميع الأنشطة الرئيسية التي فعلوها. وتظهر هذه الملاحظات في صفحة دفتر اليوميات في تطبيق 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 دقيقة (الجلسة) ولكنه سار قليلاً خلال ذلك، فيمكن تقسيم ذلك إلى أجزاء. سيكون هناك جزء للجري، ثم استراحة المشي، ثم الجري مرة أخرى.
الشكل 1: تضيف التطبيقات المختلفة جلسات ومجموعات بيانات إلى [fitness store].

يوضح الشكل 1 فاصلاً زمنيًا في متجر اللياقة البدنية تم خلاله إدراج بعض مجموعات البيانات والجلسات في التطبيقات A وB وC:

  • أدرج التطبيق "أ" مجموعات البيانات A1 وA2 مع الجلسة 1 وA3 بشكل مستقل عن أي جلسات.
  • أدرج التطبيق "ب" مجموعتي البيانات B1 وB2 مع الجلسة 2.
  • أدرج التطبيق C مجموعة البيانات C1 بشكل مستقل عن أي جلسات.

عند قراءة بيانات الجلسة من متجر اللياقة البدنية، يتم تلقائيًا ربط جميع بيانات اللياقة البدنية التي تقع ضمن الفاصل الزمني للجلسة بهذه الجلسة، حتى إذا أدخلت البيانات بعد إنشاء الجلسة، أو تم إنشاء جلسة بعد تتبُّع البيانات بشكلٍ سلبي. على سبيل المثال، سيعرض استعلام عن بيانات اللياقة البدنية من الجلسة 1 ما يلي:

  • مجموعة البيانات A1
  • مجموعة البيانات A2
  • جزء مجموعة البيانات A3 بين t1 وt2
  • جزء مجموعة البيانات C1 بين t1 وt2

يمكنك معرفة التطبيق الذي أدرج كل جلسة ومجموعة بيانات.

إنشاء الجلسات

يمكن إنشاء الجلسات بعدة طرق مختلفة:

  • يمكن لتطبيقك إنشاء جلسة بشكل نشط في:
    • في الوقت الفعلي عندما يتتبّع المستخدم نشاطًا بشكل نشط على جهاز (نظام التشغيل Android فقط)، أو
    • من خلال إدراجها يدويًا
  • عندما يضيف المستخدم يدويًا تمرينًا أو نشاطًا في تطبيق Google Fit.

حالات إنشاء جلسة

هل تضيف بيانات النوم؟

  • نعم - أنشئ جلسة وأدرجها يدويًا في متجر اللياقة البدنية. على سبيل المثال، إدراج جلسة نوم. وذلك لأن المستخدمين الذين لديهم تطبيقات أو أجهزة لتتبع النوم لن يتفاعلوا مع الأجهزة لبدء نشاط النوم وإيقافه (يتم تتبع ذلك بشكل سلبي).
  • لا، هل يسمح تطبيقك للمستخدمين ببدء الأنشطة وإيقافها؟

جلسات القراءة

يمكن لتطبيقك قراءة الجلسات بعدة طرق:

  • البحث عن جلسة معيّنة أنشأها/إدراجها
    • الاسم أو
    • رقم التعريف
  • البحث عن جميع الجلسات التي أنشأها/أدرجها، حسب الفترة الزمنية
  • البحث عن جميع الجلسات المتاحة التي أنشأتها جميع التطبيقات (بما في ذلك Google Fit) حسب الفترة الزمنية

التعرُّف على المصادر التي أنشأت جلسة

يمكنك أن تعرض للمستخدمين التطبيق أو الجهاز الذي أنشأ كل جلسة من جلساتهم. لكل جلسة مصدر بيانات مرتبط يحتوي على معلومات حول التطبيق أو الجهاز الذي جمع البيانات أو حوّلها.

Android

يمكنك حاليًا الحصول على اسم الحزمة لجلسة ما مكتوبة بواسطة عميل Android. للحصول على اسم حزمة التطبيق الذي أنشأ جلسة، استخدِم طريقة getAppPackageName. يمكنك استخدام هذه المعلومات في تطبيقك لإطلاع المستخدمين على التطبيقات الأخرى التي أدرجت جلسات اللياقة البدنية. يمكنك عرض رمز كل تطبيق من هذه التطبيقات لمساعدة المستخدمين في التعرف عليها.

يمكنك أيضًا تنشيط نية لإطلاق تطبيقات أخرى لعرض تفاصيل الجلسات التي أنشأها. يمكن للتطبيقات الأخرى أيضًا تنشيط هدف إطلاق تطبيقك.

اطّلِع على مزيد من المعلومات حول العثور على المصدر الذي أنشأ جلسة.

راحة

للحصول على اسم حزمة تطبيق Android الذي أنشأ الجلسات، استخدِم السمة session.application. بالنسبة إلى الجلسات التي تم إنشاؤها باستخدام REST API، استخدِم السمة session.name بدلاً من ذلك. يمكنك استخدام هذه المعلومات في تطبيقك لتظهر للمستخدمين التطبيقات الأخرى التي أدرجت جلسات اللياقة البدنية. يمكنك عرض رمز كل تطبيق من هذه التطبيقات لمساعدة المستخدمين في التعرف عليها.

اطّلِع على مزيد من المعلومات حول العثور على المصدر الذي أنشأ جلسة.