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

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

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

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

البدء

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

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

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

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

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

• حزمة تطوير البرامج (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) على حقول مثل "العنوان" و"الملاحظات" و"النسبة المئوية".
• النوع: long أو double أو string أو enum
• السمة: للقراءة فقط أو مطلوبة أو اختيارية أو نطاق التحقّق

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

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

SampleData الأنواع:

IntervalData الأنواع:

SeriesData الأنواع:

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

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

Read AggregatedData

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

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

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

‫HealthDataClient هي نقطة الدخول إلى Health Platform API.

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

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

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