الجلسات

تتيح الجلسات للمستخدمين الاطّلاع بسرعة وبسهولة على قائمة بجميع الأنشطة الرئيسية التي أدوها. وتظهر هذه الكتب في صفحة تسجيل الرسائل في تطبيق Google Fit. على سبيل المثال، جلسة التنفّس أو المشي أو الركض أو النوم ليلاً هي كل الأمثلة على الجلسة.

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

ولا تحتوي الجلسات بحدّ ذاتها على تفاصيل عن النشاط. وهي مجموعة بيانات. تتميز الجلسات بالخصائص التالية:

  • اسم وصفي ودود (على سبيل المثال، "التشغيل الصباحي&)
  • وصف
  • معرّف فريد
  • نوع النشاط الذي يتم تسجيله (مثل الركض)

مزايا استخدام الجلسات

  • المفيدة للمستخدمين: تساعدك الجلسات على تنظيم بيانات الأنشطة والتمارين الرياضية بطريقة مفيدة للمستخدمين. يُمكنهم الاطّلاع على جميع أنشطتهم اليومية في صفحة Journal في تطبيق 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

يمكنك استخدام واجهة برمجة تطبيقات الجلسات من أجل:

  • إنشاء جلسات في الوقت الفعلي
  • إدراج الجلسات في متجر اللياقة البدنية
  • يمكنك إدراج شرائح من النشاط البدني لدعم عمليات الإيقاف المؤقت أثناء التمارين.
  • قراءة الجلسات ومجموعات البيانات المرتبطة بها
  • شغِّل تطبيقًا آخر لعرض معلومات عن الجلسة التي تم إنشاؤها.
  • تلقّي نية intent عند بدء تطبيق آخر جلسة

راحة

يمكنك استخدام واجهة برمجة تطبيقات الجلسات من أجل:

  • إنشاء جلسات في الوقت الفعلي
  • إدراج الجلسات في متجر اللياقة البدنية
  • يمكنك إدراج شرائح من النشاط البدني لدعم عمليات الإيقاف المؤقت أثناء التمارين.
  • قراءة الجلسات ومجموعات البيانات المرتبطة بها

كيفية تفاعل مجموعات البيانات والشرائح مع الجلسات

في Google Fit:

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

يوضّح الشكل 1 الفاصل الزمني في متجر اللياقة البدنية الذي تم خلاله إدراج التطبيقات (أ) و(ب) و(ج) بعض مجموعات البيانات والجلسات:

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

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

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

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

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

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

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

وقت إنشاء جلسة

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

  • نعم - أنشئ جلسة وأدرِجها يدويًا في متجر اللياقة البدنية. على سبيل المثال، إدراج جلسة نوم. ويرجع ذلك إلى أنّ المستخدمين الذين لديهم تطبيقات أو أجهزة تتبُّع النوم لن يتفاعلوا مع الأجهزة لبدء نشاط السكون (أو تتبُّعه بشكل سلبي) أو إيقافه.
  • لا - هل يتيح تطبيقك للمستخدمين بدء الأنشطة وإيقافها؟
    • لا - عدم إنشاء جلسة. أضِف مجموعات بيانات من تطبيقك فقط.
    • نعم: باستخدام واجهة برمجة تطبيقات Android، يمكنك إنشاء جلسة في الوقت الفعلي إذا كان المستخدمون يتتبّعون أنشطتهم، أو يدويًا. باستخدام REST API، يمكنك إنشاء جلسة وإدراجها يدويًا في متجر اللياقة البدنية.
    • هل يمكن لتطبيقك اكتشاف الحالات التي يُجري فيها المستخدم أنشطة مختلفة على مستوى أكثر تفصيلاً (على سبيل المثال، المشي مقابل الجري)؟
      • نعم: أضِف شرائح.
      • لا - إضافة مجموعات البيانات فقط تجاهل الشرائح حاليًا، واسمح لتطبيق Google Fit بإنشاء هذه الشرائح بشكل سلبي.

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

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

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

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

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

Android

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

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

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

راحة

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

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