عملکرد Health Connect را مرور کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه عملکردهای اصلی Health Connect API را شرح می دهد.
عملیات CRUD روی رکورد و همگام سازی داده ها
این پلتفرم توابع استاندارد درج، به روز رسانی و حذف را برای داده های ضبط شده ارائه می دهد. Health Connect همچنین دارای عملکردی است که به برنامه های مشتری امکان می دهد داده ها را خارج از Health Connect همگام کنند. این گزارشی از تغییرات داده را ایجاد می کند که به توسعه دهنده و کاربر نشان می دهد که آیا انواع داده های خاصی توسط برنامه های دیگر درج شده یا حذف شده اند.
توابع تجمع اولیه
کلاینت ها می توانند یک تابع تجمیع را روی داده های زیربنایی اعمال کنند و موارد زیر را ارائه دهند:
- مقادیر میانگین، حداقل یا حداکثر (به عنوان مثال، حداقل و حداکثر ضربان قلب در طول یک جلسه فعالیت).
- مجموع کل (به عنوان مثال، تعداد کل گام ها در یک بازه روزانه).
- یک شمارش ساده از تعداد اندازه گیری های اساسی (به عنوان مثال، تعداد جلسات فعالیت در یک هفته معین).
- کل مدت زمان انواع داده های پشتیبانی شده (به عنوان مثال، زمان صرف شده در خواب عمیق در این هفته، یا کل مدت زمان جلسات فعالیت امروز).
بررسی های در دسترس بودن
Health Connect با Android SDK نسخه 28 (Pie) و بالاتر سازگار است. SDK به برنامه های سرویس گیرنده اجازه می دهد تا تعیین کنند که آیا Health Connect API در دستگاه مجهز به Android کاربر وجود دارد یا خیر. اگر اینطور نیست، Health Connect یک بررسی در دسترس بودن را برای تعیین سازگاری دستگاه کاربر راه اندازی می کند.
بررسی های مجوز
Health Connect از شما می‌خواهد که از کاربر برای خواندن و نوشتن داده‌های سلامتی و تناسب اندام بر اساس هر برنامه، اجازه درخواست کنید. همچنین به شما امکان می‌دهد ببینید کاربر قبلاً چه مجوزهایی اعطا یا رد کرده است.
خواندن با Health Connect
خواندن پیش زمینه
وقتی برنامه شما در پیش زمینه است، معمولاً می توانید داده ها را از Health Connect بخوانید. در این موارد، در صورتی که کاربر یا سیستم برنامه شما را در حین عملیات خواندن در پس‌زمینه قرار دهد، ممکن است از یک سرویس پیش‌زمینه برای اجرای این عملیات استفاده کنید.
برای شرایطی که برنامه شما ممکن است انتظار وقفه داشته باشد، مانند نمایش خواندن در برنامه شما، مستقیماً از Health Connect به برنامه مشتری خود بخوانید.
برای موقعیت هایی که ترجیح می دهید برنامه شما بدون وقفه اجرا شود، از یک سرویس پیش زمینه استفاده کنید:
FOREGROUND_SERVICE_TYPE_HEALTH : به برنامه اجازه می دهد برای جمع آوری داده های حسگر در پیش زمینه باقی بماند، مانند برنامه تمرینی که حتی زمانی که کاربر برنامه را در پس زمینه قرار می دهد، به جمع آوری داده ها ادامه می دهد.
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE : سرویسی از نوع عمومی که به برنامه اجازه می دهد تا به جمع آوری داده های حیاتی برای کارهایی که کمتر از سه دقیقه طول می کشد ادامه دهد، حتی اگر کاربر برنامه را قبل از اتمام آن در پس زمینه قرار دهد.
پیشینه خواندن
می توانید درخواست کنید که برنامه شما در پس زمینه اجرا شود و داده ها را از Health Connect بخواند. اگر مجوز خواندن پس‌زمینه را درخواست کنید، کاربر می‌تواند به برنامه شما اجازه دهد تا داده‌ها را در پس‌زمینه بخواند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
