این صفحه عملکردهای اصلی 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 به کاربران اطلاع می‌دهد و به آنها اطمینان می‌دهد که دسترسی خواندن پس‌زمینه به داده‌های آنها ندارد و فقط می‌تواند داده‌ها را در پیش‌زمینه بخواند و به آنها دسترسی داشته باشد.
برای شرایطی که برنامه شما ممکن است انتظار وقفه داشته باشد، مانند نمایش خواندن در برنامه شما، مستقیماً از Health Connect به برنامه مشتری خود بخوانید.
برای موقعیت‌هایی که ممکن است ترجیح دهید برنامه‌تان بدون وقفه اجرا شود، مانند خواندن طیف وسیعی از داده‌ها از Health Connect و سپس نوشتن و آپلود آن در جای دیگری، به جای فعالیتی که به راحتی می‌توان آن را رد کرد، از یک ForegroundService استفاده کنید.