واجهات برمجة تطبيقات Android

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

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

قراءة بيانات أجهزة الاستشعار

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

تسجيل البيانات

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

مخطّط Google Fit
الشكل 1. ‫Google Fit على Android

البيانات السابقة

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

الجلسات

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

عرض الأهداف وتحديدها

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