مراجعة وظيفة Health Connect
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضِّح هذه الصفحة الوظائف الرئيسية لواجهة برمجة التطبيقات Health Connect API.
عمليات CRUD على السجلّات ومزامنتها
توفّر المنصة وظائف إدراج وتعديل وحذف عادية للبيانات المسجّلة. يتضمّن Health Connect أيضًا وظائف تتيح للتطبيقات العميلة
مزامنة البيانات خارج Health Connect. يؤدي ذلك إلى إنشاء سجلّ لتغييرات البيانات
الذي يعرض للمطوّر والمستخدم ما إذا كانت تطبيقات أخرى قد أدخَلت أو حذفت أنواع بيانات معيّنة.
دوال التجميع الأساسية
يمكن للعملاء تطبيق دالة تجميع على البيانات الأساسية، ما يوفر ما يلي:
- متوسط القيم أو الحد الأدنى أو الحد الأقصى (على سبيل المثال، الحد الأدنى
والأقصى لمعدّل نبضات القلب أثناء جلسة نشاط)
- المجموع الإجمالي (على سبيل المثال، إجمالي عدد الخطوات في فاصل زمني يومي)
- عدد بسيط لعدد القياسات الأساسية (مثل
عدد جلسات النشاط في أسبوع معيّن)
- إجمالي المدة لأنواع البيانات المتوافقة (على سبيل المثال، الوقت الذي قضيته في النوم العميق هذا الأسبوع أو إجمالي مدة جلسات النشاط اليوم)
عمليات التحقّق من مدى التوفّر
يتوافق Health Connect مع الإصدار 28 (Pie) من حزمة تطوير البرامج (SDK) لنظام التشغيل Android والإصدارات الأحدث.
تسمح حزمة تطوير البرامج (SDK) لتطبيقات العميل بتحديد ما إذا كانت واجهة برمجة التطبيقات Health Connect API مفعّلة على
جهاز Android الخاص بالمستخدم. وإذا لم يكن كذلك، يبدأ Health Connect عملية
التحقّق من مدى التوفّر لتحديد ما إذا كان جهاز المستخدم متوافقًا.
عمليات التحقّق من الأذونات
يتطلب منك Health Connect طلب إذن المستخدم لقراءة بيانات الصحة واللياقة البدنية و
تعديلها على أساس كل تطبيق. ويتيح لك أيضًا معرفة الأذونات التي منحها المستخدم أو رفضها.
القراءة باستخدام Health Connect
القراءة في المقدّمة
يمكنك عادةً قراءة البيانات من Health Connect عندما يكون تطبيقك
في المقدّمة. في هذه الحالات، يمكنك استخدام خدمة تعمل في المقدّمة
لتشغيل هذه العملية في حال وضع المستخدم أو النظام تطبيقك
في الخلفية أثناء عملية القراءة.
في الحالات التي قد يتوقّع فيها تطبيقك حدوث انقطاع، مثل عرض قراءة في تطبيقك، يمكنك القراءة مباشرةً من Health Connect إلى تطبيق العميل.
في الحالات التي تفضّل فيها تشغيل تطبيقك بدون
انقطاع، استخدِم
خدمة تعمل في المقدّمة:
FOREGROUND_SERVICE_TYPE_HEALTH: يسمح هذا الإذن للتطبيق بالبقاء في
المقدّمة لجمع بيانات أجهزة الاستشعار، مثل تطبيق التمارين الرياضية الذي يواصل جمع
البيانات حتى عندما يضع المستخدم التطبيق في الخلفية.
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: خدمة من النوع العام
تسمح للتطبيق بمواصلة جمع البيانات المهمة ل tasks التي تستغرق أقل من ثلاث دقائق،
حتى إذا وضع المستخدم التطبيق في الخلفية قبل اكتمالها.
القراءة في الخلفية
يمكنك طلب تشغيل تطبيقك في الخلفية وقراءة البيانات من
Health Connect. إذا طلبت إذن قراءة البيانات في الخلفية، يمكن للمستخدم منح تطبيقك إذن الوصول إلى البيانات في الخلفية.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
