الصحة

تحديد التبعيات

لإضافة تبعية على Health، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

dependencies {
    implementation "androidx.health:health-services-client:1.1.0-alpha05"
}

dependencies {
    implementation("androidx.health:health-services-client:1.1.0-alpha05")
}

الملاحظات

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

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

إصدار برنامج Health Connect Client 1.0

الإصدار 1.0.0-alpha04

24 آب (أغسطس) 2022

اعتبارًا من الإصدار 1.0.0-alpha04، تم نقل androidx.health:health-connect-client إلى androidx.health.connect:connect-client. بالنسبة إلى الإصدارات المستقبلية، يُرجى استخدام androidx.health.connect:connect-client وملاحظات الإصدار المرتبطة بها في صفحة Health Connect.

لنقل البيانات، ما عليك سوى تغيير استيراد الملحقات من androidx.health:health-connect-client:1.0.0-alpha03 إلى androidx.health.connect:connect-client:1.0.0-alpha04.

الإصدار 1.0.0-alpha03

27 تموز (يوليو) 2022

تم إصدار androidx.health:health-connect-client:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

الميزات الجديدة

• ملخّص التغييرات الجديدة في واجهة برمجة التطبيقات: تمت إضافة مجموعة من الوحدات إلى واجهات برمجة التطبيقات الخاصة بالقراءة والكتابة والتجميع. يمكن للتطبيقات الآن استرداد السجلات أو كتابتها باستخدام الوحدة التي تختارها، مثل الجرام أو الملليغرام للعناصر الغذائية NutritionRecord.

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

• يجب تصحيح List<DataOrigin> ليصبح Set<DataOrigin> في عناصر استجابة الطلبات المختلفة. (I42342)
• يمكنك ضبط وحدة إجمالي السعرات الحرارية الأساسية من Power (الطاقة)->Energy (الطاقة). (I0b429)
• تم نقل فئات نماذج السلاسل داخل سجلات السلاسل (Ica9bb):
  • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
  • HeartRate -> HeartRateRecord.Sample
  • StepsCadence -> StepsCadenceRecord.Sample
• إيقاف فئة HealthDataRequestPermission نهائيًا، واستبدالها بفئة PermissionController.createRequestPermissionActivityContract، ما يعزّز قابلية الاكتشاف بشكل أفضل وإعداد المَعلمات بشكل موحّد (I81e7f)
• تمت إضافة أوقية أمريكية إلى "الحجم". (I5f03d)
• تمت إضافة نوع وحدة السرعة (I1d574)
• تمت إضافة نوع وحدة النسبة المئوية (I08f23)
• تمت إضافة نوع وحدة الضغط (Ifb01f)
• نوع وحدة الكتلة المضافة (Ifd81a)
• تمت إضافة نوع وحدة مستوى الصوت (I59ad1)
• تمت إضافة نوع وحدة الطاقة. تم نقل صف نموذج سلسلة Power إلى الصف PowerRecord. (I5b1e5)
• تمت إضافة نوع وحدة الطاقة (I983ae)
• تمت إضافة نوع وحدة درجة الحرارة (I4cdb5)
• إعادة تسمية إشارات النشاط لتكون محصورة بالتمارين، بما في ذلك (I3f936):
  • تمت إعادة تسمية ActivityLap إلى ExerciseLapRecord
  • تمت إعادة تسمية ActivityEvent إلى ExerciseEventRecord
  • تمت إعادة تسمية Repetitions إلى ExerciseRepetitionsRecord
  • تمت إعادة تسمية ActivitySession إلى ExerciseSessionRecord
• تم نقل البيانات الوصفية للحزمة التي تمّ تداخلها ضمن السجلّات. (Ie0835)
• وحدة الطول المستخدَمة في جميع السجلّات المتبقية (Ib10dd):
  • ActivityLapRecord
  • ElevationGainedRecord
  • HeightRecord
  • HipCircumferenceRecord
  • WaistCircumferenceRecord
• تمّت إضافة نوع وحدة الطول (Idae39)
• تعديل مصطلحات وصف CervicalMucus (I25a2b):
  • CervicalMucus.Amount -> CervicalMucusRecord.Texture
  • CervicalMucus.Appearance -> CervicalMucusRecord.Sensation
• تمت إضافة اللاحقة "سجلّ" إلى جميع أسماء فئات السجلّات (I1ffc2).

إصلاح الأخطاء

• حلّ مشاكل Proguard عند إنشاء المكتبة باستخدام نكهة الإصدار وminifyEnabled true (I78933)
• إخفاء المستندات غير المخصّصة للاستخدام العام (I7a08f)
• حلّ المشكلة في العملاء الذين قد يكون لديهم تبعيات protobuf خاصة بهم (https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430)

الإصدار 1.0.0-alpha02

1 حزيران (يونيو) 2022

تم إصدار androidx.health:health-connect-client:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه المراجعات.

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

• إيقاف عاملَي التشغيل hasMetric وgetMetric نهائيًا في AggregationResult، وإضافة عاملَي التشغيل يحتوي على وget (I7cc7c)
• يضيف OvulationTest.Result.HIGH وOvulationTest.Result.INCONCLUSIVE. (I9f9c4)

إصلاح الأخطاء

• تقليل متطلبات حزمة SDK إلى 26 (I6d201)

الإصدار 1.0.0-alpha01

11 أيار (مايو) 2022

تم إصدار androidx.health:health-connect-client:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

الميزات الجديدة

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

الإصدار 1.1 من برنامج Health Services Client

الإصدار 1.1.0-alpha05

11 كانون الأول (ديسمبر) 2024

تم إصدار androidx.health:health-services-client:1.1.0-alpha05 وandroidx.health:health-services-client-external-protobuf:1.1.0-alpha05 وandroidx.health:health-services-client-proto:1.1.0-alpha05. يتضمّن الإصدار 1.1.0-alpha05 عمليات الربط هذه.

الميزات الجديدة

• يتضمّن الآن قواعد Proguard لتجنُّب إزالة الفئات الضرورية. (65d0c3f)

إصلاح الأخطاء

• تستخدم هذه المكتبة الآن تعليقات توضيحية حول عدم تحديد قيمة JSpecify، وهي عبارة عن استخدام نوع. على مطوّري لغة Kotlin استخدام وسيطة المُجمِّع التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مُجمِّع Kotlin). (Iaf73a، b/326456246)

الإصدار 1.1.0-alpha04

16 أكتوبر 2024

تم إصدار androidx.health:health-services-client:1.1.0-alpha04 وandroidx.health:health-services-client-external-protobuf:1.1.0-alpha04 وandroidx.health:health-services-client-proto:1.1.0-alpha04. يتضمّن الإصدار 1.1.0-alpha04 عمليات الربط هذه.

إصلاحات الأمان

• اعتبارًا من هذا التغيير، يتم تجميع حِزم androidx باستخدام protobuf 4.28.2 لحلّ المشكلة CVE-2024-7254. عليك ترقية الإصدار المُستخدَم من androidx.health:health-services-client إلى أحدث إصدار 1.1.0-alpha04 لحلّ مشكلة التعرّض للثغرة الأمنية.

الإصدار 1.1.0-alpha02

13 كانون الأول (ديسمبر) 2023

تم إصدار androidx.health:health-services-client:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.

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

• استخدِم مصدرًا واحدًا للحقائق المتعلّقة بالExerciseEvent المسموح بها. (I03308)

إصلاح الأخطاء

• إصلاحات أخطاء بسيطة وتحسينات على المستندات

الإصدار 1.1.0-alpha01

9 آب (أغسطس) 2023

تم إصدار androidx.health:health-services-client:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.

الميزات الجديدة

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

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

• فعِّل عملاء حزمة تطوير البرامج (SDK) في WHS لاستخدام وظائف GolfShotEvent. (I76b03)

إصلاح الأخطاء

• بدلاً من طرح استثناءات بشكل عدائي عند رؤية إمكانات غير معروفة لأحداث التمارين الرياضية، يمكنك فلترتها من القائمة. (I06afc)

الإصدار 1.0 من برنامج Health Services Client

الإصدار 1.0.0

7 أيار (مايو) 2025

تم إصدار androidx.health:health-services-client:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

الميزات الرئيسية في الإصدار 1.0.0

• نهدف من خلال هذا الإصدار إلى ترقية الإصدار 1.0.0-rc02 ليصبح الإصدار الثابت من Health Services Client. ما مِن تغييرات عن الإصدار 1.0.0-rc02.

الإصدار 1.1.0-alpha03

14 أيار (مايو) 2024

تم إصدار androidx.health:health-services-client:1.1.0-alpha03. يتضمّن الإصدار 1.1.0-alpha03 عمليات الربط هذه.

الميزات الجديدة

• تمّت إضافة DebouncedGoal واجهة برمجة تطبيقات تتيح تتبُّع هدف لنوع بيانات عيّنة أو نوع بيانات عيّنة الإحصاءات أثناء التمرين باستخدام ميزات إزالة الارتعاش(initialDelay وdurationAtThreshold). (I09be9)
• تمت إضافة نموذج المقاييس المتقدّمة التالية للجري وDataTypes الإحصائية. (I0b8b5):
  • Ground Contact Time
  • Vertical Oscillation
  • Vertical Ratio
  • Stride Length

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

• تمت إضافة ELEVATION_GAIN_DAILY DataType. (I059d1)
• تمت إضافة SWIM_LAP_COUNT_TOTAL DataType كDataType مجمّع لـ SWIM_LAP_COUNT. (I0beeb)

إصلاح الأخطاء

• تم إصلاح مشاكل مختلفة لتحسين موثوقية واجهة برمجة التطبيقات.

الإصدار 1.0.0-rc02

3 نيسان (أبريل) 2024

تم إصدار androidx.health:health-services-client:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 عمليات الربط هذه. هذا الإصدار مخصّص لإصلاح الأخطاء فقط ولا يحتوي على تغييرات في واجهة برمجة التطبيقات.

إصلاح الأخطاء

• تم إصلاح مشاكل مختلفة لتحسين موثوقية IPC
• تم إصلاح مشكلة تؤدي إلى ظهور ConcurrentModificationException (4e37773) عند الاتصال برقم startExercise في الوقت نفسه الذي يتم فيه الاتصال برقم prepareExercise.
• مستندات محسَّنة

الإصدار 1.0.0-rc01

26 تموز (يوليو) 2023

تم إصدار androidx.health:health-services-client:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.

الميزات الجديدة

• تم نقل Health Services إلى الإصدار 1.0.0-rc01 بعد استقرار الإصدار التجريبي.

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

• تم دمج ملفات واجهات برمجة التطبيقات العلنية والتجريبية للمسارات من h إلى m. (Ic4630، b/278769092)
• لا، إنّ تغييرات ملفات واجهة برمجة التطبيقات هي مجرد طرق لإعادة الترتيب. (I5fa95)

الإصدار 1.0.0-beta03

5 نيسان (أبريل) 2023

تم إصدار androidx.health:health-services-client:1.0.0-beta03. يحتوي الإصدار 1.0.0-beta03 على هذه المراجعات.

الميزات الجديدة

يمكن الآن ضبط BatchingMode لإرسال بيانات التمارين المجمّعة في الفاصل الزمني الذي تم ضبطه بدلاً من الإعداد التلقائي أثناء التمرين النشط، إما عند بدء التمرين من خلال ExerciseConfig أو أثناء التمرين باستخدام طريقة إلغاء. سيتم تفعيل هذه الميزة في إصدار قادم من "خدمات الصحة" في "متجر Google Play"، ويمكن التحقّق منها من خلال ميزات التمارين الرياضية. ملاحظة: تسري أوضاع تجميع البيانات عندما يكون الجهاز في حالة طاقة غير تفاعلية، ما يؤدي إلى زيادة استهلاك الطاقة.

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

• طرح HealthServicesException عند تعذُّر تعليق الدالة overrideBatchingModesForActiveExercise (Ifd387)
• تمّت إضافة دوالّ تعليق لواجهة برمجة التطبيقات overrideBatchingModesForActiveExercise غير المتزامنة، ما يجعلها أكثر توافقًا مع Kotlin (I7dd15).
• BatchingMode تلغي القيمة الاختيارية في ExerciseConfig (Id22e9)

إصلاح الأخطاء

• ‫DataType وExerciseUpdate: إصلاحات طفيفة (5e185f)

الإصدار 1.0.0-beta02

11 كانون الثاني (يناير) 2023

تم إصدار androidx.health:health-services-client:1.0.0-beta02. يحتوي الإصدار 1.0.0-beta02 على هذه المراجعات.

الميزات الجديدة

• تمت إضافة دالّات إضافة suspend لواجهات برمجة التطبيقات الحالية غير المتزامنة ListenableFuture في ExerciseClient وPassiveMonitoringClient وMeasureClient لتوفير توافق أفضل مع Kotlin. (Iadea4)
• تمت إضافة واجهة برمجة التطبيقات ExerciseTypeConfig التي تتيح إجراء التعديلات أثناء تمرين جاري. تمت إضافة GolfExerciseTypeConfig للسماح بتعديل ExerciseTypeConfig أثناء تمارين الغولف. (I4c539)

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

• رمي HealthServicesException على وظائف تعليق التنفيذ (I5e509)
• إضافة مُنشئ آخر للتوافق مع الإصدارات السابقة (Iddeda)
• طرح RuntimeException في دوال التعليق (I53bca)
• إزالة التنفيذ التلقائي لرمي الاستثناء (Id947f)
• إضافة تعليق توضيحي @JvmDefaultWithCompatibility (I8f206)

إصلاح الأخطاء

• إضافة إلى kdoc للتوضيح (Ide285)
• السماح بتتبُّع المراقبة السلبية للأهداف فقط في حال تتبُّع أنواع البيانات نفسها أيضًا (Ibed8d)

الإصدار 1.0.0-beta01

24 تشرين الأول (أكتوبر) 2022

تم إصدار androidx.health:health-services-client:1.0.0-beta01. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.

الميزات الجديدة

• تمت إضافة إمكانية الاستماع إلى الأحداث الصحية من خلال PassiveMonitoringClient مع الحدث الأول: HealthEvent.FALL_DETECTED.

• أنواع التمارين الجديدة:

  • ALPINE_SKIING
  • BACKPACKING
  • CROSS_COUNTRY_SKIING
  • HORSE_RIDING
  • INLINE_SKATING
  • MOUNTAIN_BIKING
  • ORIENTEERING
  • ROLLER_SKATING
  • YACHTING

• أنواع البيانات الجديدة:

  • ELEVATION_LOSS
  • GOLF_SHOT_COUNT

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

• تعديل طريقة وضع نماذج للبيانات: تمّت إعادة النظر في نموذج البيانات وطريقة تمثيل DataType وDataPoint والقيم الأساسية. ويتمثل التأثير على المستوى الأعلى في أنّ واجهات برمجة التطبيقات أصبحت الآن أكثر وضوحًا وأمانًا من حيث النوع.
• لم يعُد يتم تمثيل المواقع الجغرافية DataPoint على أنّها DoubleArray، بل كعنصر LocationData من النوع الثابت.
• تم نقلها إلى مجموعة جديدة من واجهات برمجة التطبيقات للمستمعين السلبيين:
  • تم استبدال البث بـ PassiveListenerService.
  • تم استبدال المستمعين الحاليين بمستمع واحد: PassiveListenerCallback.
• تمت إضافة علامة <queries> إلى بيان Health Services لكي لا تحتاج التطبيقات إلى تحديد ذلك في بيانها الخاص (شرط تفعيل دمج البيان في نظام الإنشاء).
• تم إيقاف استخدام العديد من الرموز ExerciseState للإشارة إلى أنّ التمرين قيد الانتهاء أو انتهى، وتمّت إضافة حالتَي التمرين الجديدتَين ENDING وENDED. ويتم الآن دمج هذه الرموز مع ExerciseEndReason لتمثيل المجموعة الكاملة من الحالات السابقة.
• تمت إعادة تسمية PassiveListenerConfig setPassiveGoals إلى setDailyGoals لتوضيح أنّنا نوفّر الأهداف اليومية غير التفاعلية فقط.
• أصبحت PassiveGoal دائمًا REPEATED، وتمّت إزالة TriggerFrequency السلبي.
• تمت إضافة تعليقات توضيحية إلى جميع مَعلمات Long وDouble باستخدام @FloatRange.
• تمت إضافة السمة swimmingPoolLengthMeters إلى ExerciseConfig التي يمكن تحديدها اختياريًا لتحسين عمليات احتساب المسافة للسباحة في المسبح.
• تم إيقاف ExerciseUpdate.activeDuration نهائيًا. استخدِم ExerciseUpdate.activeDurationCheckpoint بدلاً من ذلك.
• تمت إعادة تسمية واجهة برمجة التطبيقات flushExerciseAsync() إلى flushAsync() في ExerciseClient.
• تمت إعادة تسمية Measure.registerCallback إلى Measure.registerMeasureCallback.
• التغييرات العامة في عملية التسمية:
  • تحتوي مواقع المسافة الآن على اللاحقة meters.
  • أصبحت أسماء طرق ردّ الاتصال الآن في صيغة الماضي.
  • تمّت إزالة معظم الاختصارات (HrAccuracy هي الآن HeartRateAccuracy).
  • تم الآن تسمية المواقع التي تتّبع النمط enableFoo باسم isFooEnabled.
• تم نقلها بعيدًا عن Enums.
• تم استبدال الرمز Double برمز Duration للإشارة إلى الأوقات.
• الدوالّ التي كانت تُرجع ListenableFuture<Void?> أصبحت تُرجع ListenableFuture<Void>.
• في الدوالّ التي تقبل دالة ردّ اتصال، تظهر دالة ردّ الاتصال دائمًا كمَعلمة أخيرة.
• تحتوي الآن دائمًا الفصول التي تتضمّن أدوات إنشاء على وظائف إنشاء عامة.
• لم تعُد دوال التسجيل تعرِض ListenableFuture، بل تُرسِل حالة التسجيل بدلاً من ذلك إلى دالة ردّ الاتصال المقدَّمة.
• تم تحسين ميزة "مستندات Google".
• لم تعُد الصفوف العامة تمتد إلى ProtoParcelable.

إصلاح الأخطاء

• تحسينات عامة على موثوقية واجهة برمجة التطبيقات (I3b1e2)

الإصدار 1.0.0-alpha03

3 تشرين الثاني (نوفمبر) 2021

تم إصدار androidx.health:health-services-client:1.0.0-alpha03. يحتوي الإصدار 1.0.0-alpha03 على هذه المراجعات.

الميزات الجديدة

• ستعيد حزمة SDK تسجيل طلبات تسجيل عمليات تسجيل القياس والاستماع إلى التمارين الرياضية وعمليات تسجيل الاستدعاء للمراقبة السلبية تلقائيًا في حال انقطاع الاتصال بين واجهة برمجة التطبيقات (IPC) وملف APK الخاص بخدمات الصحة.

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

• تمّ رفع قيمة minSdkVersion لـ مكتبة حزمة تطوير البرامج (SDK) إلى المستوى 30 لواجهة برمجة التطبيقات، لأنّ "عميل خدمات الصحة" متوافق حاليًا مع Wear3 فقط.

الإصدار 1.0.0-alpha02

29 أيلول (سبتمبر) 2021

تم إصدار androidx.health:health-services-client:1.0.0-alpha02. يحتوي الإصدار 1.0.0-alpha02 على هذه المراجعات.

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

• يتيح تطبيق ExerciseClient الآن إعداد تمرين. يتيح ذلك للعملاء تجهيز الحساسات والانتظار إلى أن يتم تصحيح بيانات نظام تحديد المواقع الجغرافية (GPS) قبل بدء التمرين.
• تعرِض فئات CumulativeDataPoints وStatisticalDataPoints AggregateDataPoint لإنشاء نماذج أفضل للمقاييس المجمّعة التي يتم تتبُّعها أثناء ممارسة التمارين الرياضية. تحتفظ CumulativeDataPoints بالقيم التراكمية لأنواع البيانات المجمّعة للفواصل الزمنية (مثل إجمالي المسافة خلال التمرين)، في حين تنشئ StatisticalDataPoints نماذج للقيم المجمّعة لنقاط البيانات المستندة إلى عيّنات (مثل الحد الأدنى والحد الأقصى ومتوسط HeartRateBpm). ويحلّ هذا الإجراء محلّ أنواع البيانات السابقة AGGREGATE_*، ويمكن الوصول إليه في ExerciseUpdate من خلال getLatestAggregateMetrics(). لم تعُد أنواع البيانات AGGREGATE_* متوافقة.
• تمّت إعادة تسمية PassiveMonitoring Events إلى PassiveGoals التي تتيح ضبط الأهداف وتلقّي إشعارات عند تحقيق هذه الأهداف لأنواع البيانات، مثل المقاييس اليومية (مثل DAILY_STEPS).
• تم تحسين وضع نماذج لدقة ومدى توفّر معدل ضربات القلب والموقع الجغرافي من خلال تقديم فئات HrAccuracy وLocationAccuracy وLocationAvailability الجديدة.
• تحسين تسمية حقل ExerciseConfig وإضافة حقل PassiveMonitoringConfig جديد وتقديم حقل ExerciseConfig.shouldEnableGps لطلب البيانات المستندة إلى نظام تحديد المواقع العالمي (GPS)

إصلاح الأخطاء

• نقل البيانات إلى بروتوكول IPC مدعوم من proto لتوفير دعم أفضل للتوافق مع الإصدارات القديمة

الإصدار 1.0.0-alpha01

18 أيار (مايو) 2021

تم إصدار androidx.health:health-services-client:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.

ميزات الإصدار الأولي

توفّر مكتبة Health Services مجموعة موحّدة من واجهات برمجة التطبيقات للمطوّرين لدمج عمليات تنفيذ أجهزة الاستشعار الخاصة بالأجهزة. وستعمل هذه الميزة تلقائيًا مع محاكيات Wear OS 3 والأجهزة القادمة، وستتوفّر منصات إضافية متوافقة في المستقبل. يتضمّن هذا الإصدار الأولي ثلاث مساحات عرض لواجهات برمجة التطبيقات من المستوى الأعلى: ExerciseClient وPassiveMonitoringClient وMeasureClient.

ExerciseClient

تم تصميم ExerciseClient للتطبيقات التي تتبّع التمارين الرياضية النشطة، مع ما يصل إلى 82 ExerciseType مختلفًا من المشي والجري إلى الرقص وكرة الماء. أثناء تتبُّع هذه التمارين، تتوفّر مجموعة من 50 DataType مختلفة حسب نوع التمرين والأجهزة المتوفّرة على الجهاز. للبدء، ما عليك سوى تحديد المعلومات ذات الصلة في ExerciseConfig، والاتصال برقم exerciseClient.startExercise والاستماع إلى مستوى التقدّم في أداة الاستماع إلى التحديثات.

PassiveMonitoringClient

يُعدّ PassiveMonitoringClient خيارًا رائعًا إذا كان تطبيقك يتتبّع نشاط المستخدم على مدار اليوم. يمكنك تسجيل PendingIntent مع مجموعة من DataType وتنشيطها لمعالجة التغييرات المجمّعة. بدلاً من ذلك، يمكنك تحديد Event مثل الوصول إلى عدد معيّن من الخطوات.

MeasureClient

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