عملکرد 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 بخواند. اگر مجوز خواندن پس‌زمینه را درخواست کنید، کاربر می‌تواند به برنامه شما اجازه دهد تا داده‌ها را در پس‌زمینه بخواند.