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

‫Health Platform API هي واجهة برمجة تطبيقات لنظام Android توفّر للمطوّرين واجهة واحدة لقراءة بيانات الصحة والعافية واللياقة البدنية السابقة للمستخدم وكتابتها ومشاركتها. تتيح "منصة الصحة" للمستخدمين التحكّم في بياناتهم. يتحكّم المستخدمون في التطبيقات التي يمكنها قراءة أنواع مختلفة من البيانات أو تعديلها. تشمل أنواع بيانات Health Platform API الطول ومعدّل نبضات القلب وغير ذلك.

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

توفّر حزمة تطوير البرامج (SDK) الخاصة بواجهة Health Platform API لمطوّري تطبيقات Android كل ما يحتاجون إليه لمنح المستخدمين إذن الوصول إلى بيانات الصحة والعافية على أجهزة Samsung محدّدة، كما تتيح للتطبيقات تنفيذ عمليات مجمّعة، مثل إدراج البيانات وحذفها وقراءتها.

البدء

عند استخدام "منصة الصحة"، يُرجى مراعاة ما يلي:

• يجب أن تحصل تطبيقات العميل على أذونات دقيقة للوصول إلى البيانات للقراءة أو الكتابة من المستخدم.
• يمكن للمستخدم رفض الأذونات أو إلغاؤها في أي وقت بعد ذلك.
• تتوافق Health Platform API مع أجهزة Samsung محدّدة فقط.
• ‫HealthDataClient هو عميل "منصة الصحة" ونقطة دخول إليها.

تعرض الصورة التالية خطوات الدمج اللازمة التي يجب أن يتّبعها المطوّرون:

ملفات الإصدار

يتضمّن الإصدار الأول من "منصة الصحة" ما يلي:

• حزمة تطوير البرامج (SDK) للعميل: أدرِج هذه الحزمة في تطبيقك لاستخدام واجهة برمجة التطبيقات Health Platform API. حزمة SDK هي مستودع Maven يمكنك تضمينه مباشرةً في ملفات إنشاء Gradle الخاصة بتطبيقك.

تثبيت "منصة الصحة"

ثبِّت Health Platform باتّباع الخطوات التالية:

في ملف build.gradle الجذر الخاص بالتطبيق، أضِف المستودع كما هو موضّح في المثال التالي:

allprojects {
    . . .
    repositories {
        . . .
        google()
    }
}

أضِف اعتمادية على حزمة تطوير البرامج (SDK) لمنصة Health Platform في ملف build.gradle الخاص بالوحدة، كما هو موضّح في المثال التالي:

البيانات

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

في ما يلي نظرة على العناصر الأساسية في "منصة الصحة" والاختلافات بينها:

• RawData: قياس وسجلّ بيانات
• DataType: أداة تحديد لأنواع البيانات الشائعة المتعلقة بالصحة واللياقة البدنية، مثل معدّل نبضات القلب أو نسبة الدهون في الجسم أو درجة حرارة الجسم، وتنسيقاتها، مثل الحقول أو القراءة فقط أو البيانات الاختيارية
• ‫SampleData: هو عنصر RawData يمثّل قياسًا فوريًا، مثل معدّل نبضات القلب أو ضغط الدم أو سرعة الجري.
• IntervalData: هو عنصر RawData يمثّل قياسًا تراكميًا تمّ تسجيله على مدار فترة زمنية، مثل عدد الخطوات التي تمّ اتّخاذها أو المسافة المقطوعة أو السعرات الحرارية المحروقة.
• SeriesData: عنصر RawData يضم سلسلة من القياسات على مدار فترة زمنية. SeriesData مناسبة بشكل خاص لبيانات أجهزة الاستشعار العالية التردد، مثل عيّنات معدّل نبضات القلب المستمرة أثناء جلسة نشاط.

يتوافق كل من فئات RawData الثلاث مع فئة فرعية محددة من DataType: تتوافق SampleData وIntervalData وSeriesData مع SampleDataType وIntervalDataType وSeriesDataType على التوالي.

يتم تخصيص معرّف فريد (UID) لكل عنصر RawData من خلال Health Platform عند إدراجه. يمكنك استخدام معرّف UID هذا للإشارة إلى RawData كائن معيّن في طلبات القراءة أو التعديل أو الحذف.

أنواع البيانات

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

يتم تحديد كل نوع بيانات من خلال تنسيق البيانات الخاص به، والذي يتضمّن ما يلي:

• الحقول: حقول محدّدة أو عامة مرتبطة بنوع البيانات على سبيل المثال، يحتوي نوع بيانات نسبة تشبّع الدم بالأكسجين (SpO2) على حقول مثل "العنوان" و"الملاحظات" و"النسبة المئوية".
• النوع: طويل أو مزدوج أو سلسلة أو تعداد
• السمة: للقراءة فقط أو مطلوبة أو اختيارية أو نطاق التحقّق

قائمة بأنواع البيانات

يمكنك الاستفادة إلى أقصى حد من "منصة الصحة" من خلال فهم أنواع البيانات المتاحة. يتيح تطبيق "منصة الصحة" أنواع البيانات الموضّحة في الجدول التالي. يتم تنظيم أنواع البيانات وفقًا لتنسيقها: عينة أو فاصل زمني أو سلسلة.

SampleData الأنواع:

IntervalData الأنواع:

SeriesData الأنواع:

وظائف المطوّرين

يوضّح ما يلي مجموعة دوال البيانات العادية المتوفّرة في Health Platform. توفّر المنصة وظائف الإدراج والتعديل والحذف القياسية للبيانات الأولية.

Read AggregatedData

تتيح المنصة للعملاء تطبيق دالة تجميع على الأنواع التالية من AggregatedData:

• StatisticalData: القيم المتوسطة أو الدنيا أو القصوى في مجموعة من SampleData أو SeriesData، مثل الحد الأدنى والأقصى لمعدّل نبضات القلب خلال جلسة نشاط
• CumulativeData: مجموع قيم IntervalData، مثل إجمالي عدد الخطوات خلال فترة زمنية يومية
• CountData: عدد عناصر RawData الأساسية، مثل عدد جلسات النشاط في أسبوع معيّن. يمكن احتساب بيانات العدد لأنواع بيانات العيّنات والفواصل الزمنية والسلاسل.

الربط بواجهة برمجة التطبيقات Health Platform API

‫HealthDataClient هي نقطة الدخول إلى واجهة برمجة التطبيقات Health Platform API.

توضّح الخطوات التالية كيفية الاتصال بمنصّة Health Platform:

1. استخدِم HealthDataService.getClient لإنشاء مثيلات جديدة من HealthDataClient.
2. بعد ذلك، يجب أن يطلب تطبيق العميل إذنًا من المستخدم باستخدام طريقة requestPermissions (Set).

HealthDataClient يدير تلقائيًا عملية الربط بطبقة التخزين الأساسية ويتعامل مع جميع عمليات الاتصال بين العمليات (IPC) وتسلسل الطلبات الصادرة والردود الواردة.