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

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

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

قراءة بيانات أداة الاستشعار

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

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

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

مخطّط Google Fit
الشكل 1. تطبيق Google Fit على Android

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

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

الجلسات

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

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

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