Health Platform API

Health Platform API یک API Android است که برای توسعه دهندگان یک رابط واحد برای خواندن، نوشتن و به اشتراک گذاری داده های سلامت، تندرستی و تناسب اندام قبلی کاربر ارائه می دهد. با پلتفرم سلامت، کاربران کنترل داده های خود را دارند. کاربران کنترل می کنند که کدام برنامه ها به انواع مختلف داده ها دسترسی خواندن یا نوشتن دارند. انواع داده های API Health Platform شامل قد، ضربان قلب و غیره است.

سلامت پلتفرم API به کاربران مکانیزم ذخیره سازی و اشتراک گذاری می دهد که به آنها امکان می دهد انتخاب کنند به کدام برنامه ها دسترسی داشته باشند و داده های سلامتی، تناسب اندام و سلامتی شخصی خود را نمایش دهند. سپس به توسعه دهندگان برنامه اجازه می دهد تا دید کامل تری از سلامت کاربران را به کاربران نشان دهند و به کاربران اجازه می دهد تا به طور مؤثرتری بر داده های آنها نظارت داشته باشند.

کیت توسعه‌دهنده نرم‌افزار Health Platform API به توسعه‌دهندگان برنامه‌های Android هر آنچه را که برای دسترسی به داده‌های سلامت و تندرستی کاربر در دستگاه‌های منتخب سامسونگ نیاز دارند، می‌دهد و به برنامه‌ها اجازه می‌دهد عملیات‌های انبوه مانند درج، حذف و خواندن داده‌ها را انجام دهند.

شروع کنید

هنگام استفاده از Health Platform، موارد زیر را در نظر داشته باشید:

• برنامه های سرویس گیرنده باید مجوزهای دقیق برای دسترسی خواندن یا نوشتن از کاربر دریافت کنند.
• کاربر می تواند مجوزها را رد کند یا در هر مرحله پس از آن، مجوزها را لغو کند.
• Health Platform API فقط از دستگاه های منتخب سامسونگ پشتیبانی می کند.
• HealthDataClient مشتری پلتفرم سلامت و نقطه ورود به پلتفرم سلامت است.

تصویر زیر مراحل یکپارچه سازی لازم را که توسعه دهندگان باید دنبال کنند نشان می دهد:

انتشار فایل ها

نسخه Health Platform V1 شامل موارد زیر است:

• Client SDK : برای استفاده از Health Platform API این SDK را در برنامه خود قرار دهید. SDK یک مخزن Maven است که می توانید مستقیماً در فایل های ساخت Gradle برنامه خود قرار دهید.

پلتفرم Health را نصب کنید

با استفاده از مراحل زیر پلتفرم Health را نصب کنید:

همانطور که در مثال زیر نشان داده شده است، در فایل root build.gradle برنامه، repo را اضافه کنید:

allprojects {
    ...
    repositories {
        ...
        google()
    }
}

همانطور که در مثال زیر نشان داده شده است، یک وابستگی به Health Platform SDK در فایل build.gradle ماژول خود اضافه کنید:

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

داده ها

Health Platform داده‌های سلامت و تناسب اندام را ذخیره و ساختار می‌دهد. همچنین تفاوت های اصلی بین نحوه اندازه گیری داده های انواع مختلف را در نظر می گیرد. به عنوان مثال، اندازه گیری ضربان قلب بلافاصله انجام می شود، اما شمارش گام ها در یک دوره زمانی انجام می شود.

در اینجا نگاهی به اشیاء مرکزی در Health Platform و تفاوت آنها داریم:

• RawData : اندازه گیری و رکورد داده.
• DataType : یک مشخص کننده برای انواع رایج داده های سلامتی و تناسب اندام، مانند ضربان قلب، چربی بدن، یا دمای بدن، و قالب های آنها، مانند فیلدها، فقط خواندنی یا اختیاری.
• SampleData : یک شیء RawData که یک اندازه گیری آنی است، مانند ضربان قلب، فشار خون، یا سرعت دویدن.
• IntervalData : یک شیء RawData که یک اندازه گیری تجمعی است که در یک دوره زمانی انجام می شود، مانند تعداد گام های برداشته شده، مسافت طی شده یا کالری سوزانده شده.
• SeriesData : یک شیء RawData که دنباله ای از اندازه گیری ها را در یک دوره زمانی محصور می کند. SeriesData به ویژه برای داده‌های حسگر با فرکانس بالا، مانند نمونه‌های ضربان قلب مداوم در طول یک جلسه فعالیت، مناسب است.

هر یک از سه کلاس RawData مربوط به زیر کلاس خاصی از DataType است: SampleData ، IntervalData ، و SeriesData به ترتیب با SampleDataType ، IntervalDataType و SeriesDataType مطابقت دارند.

به هر شیء RawData یک شناسه منحصر به فرد (UID) توسط پلتفرم Health هنگام درج آن اختصاص داده می شود. می‌توانید از این UID برای ارجاع به یک شیء RawData خاص در درخواست‌های خواندن، به‌روزرسانی یا حذف استفاده کنید.

انواع داده ها

پلتفرم سلامت شامل مجموعه گسترده ای از انواع داده است که معمولاً در برنامه های سلامت و تناسب اندام استفاده می شود. داده‌های ذخیره‌شده با انواع داده‌های موجود، دید جامعی از داده‌های مربوط به سلامت، تناسب اندام و سلامتی خود را در اختیار کاربران قرار می‌دهد و بینشی از فعالیت‌های روزانه‌شان می‌دهد.

هر نوع داده با فرمت داده خود تعریف می شود که شامل موارد زیر است:

• فیلدها: فیلدهای خاص یا عمومی مرتبط با نوع داده. به عنوان مثال، نوع داده اشباع اکسیژن خون (SpO2) دارای فیلدهایی مانند عنوان، یادداشت ها و درصد است.
• نوع: طولانی، دوتایی، رشته ای یا enum.
• مشخصه: محدوده فقط خواندنی، مورد نیاز، اختیاری یا اعتبارسنجی.

فهرست انواع داده ها

با درک انواع داده های موجود، از پلتفرم سلامت حداکثر استفاده را ببرید. Health Platform از انواع داده های نشان داده شده در جدول زیر پشتیبانی می کند. انواع داده ها بر اساس قالب آنها سازماندهی می شوند: نمونه، بازه یا سری.

انواع SampleData :

انواع IntervalData :

انواع SeriesData :

توابع توسعه دهنده

در زیر مجموعه ای از توابع داده استاندارد موجود در Health Platform را شرح می دهد. این پلتفرم توابع استاندارد درج، به روز رسانی و حذف را برای داده های خام فراهم می کند.

AggregatedData را بخوانید

این پلتفرم به مشتریان این امکان را می دهد که یک تابع تجمیع را روی انواع زیر از AggregatedData اعمال کنند:

• StatisticalData : مقادیر میانگین، حداقل یا حداکثر در مجموعه‌ای از SampleData یا SeriesData ، مانند حداقل و حداکثر ضربان قلب در طول یک جلسه فعالیت.
• CumulativeData : مجموع مقادیر IntervalData ، مانند تعداد کل گام ها در یک بازه روزانه.
• CountData : یک شمارش ساده از تعداد اشیاء RawData اساسی، مانند تعداد جلسات فعالیت در یک هفته معین. داده های شمارش را می توان برای انواع داده های نمونه، فاصله و سری محاسبه کرد.

به Health Platform API متصل شوید

HealthDataClient نقطه ورود به API Health Platform است.

مراحل زیر نحوه اتصال به Health Platform را شرح می دهد:

1. از HealthDataService.getClient برای ایجاد نمونه های جدید HealthDataClient استفاده کنید.
2. سپس برنامه مشتری باید با استفاده از روش requestPermissions (Set) از کاربر اجازه درخواست کند.

HealthDataClient به طور خودکار اتصال خود را به لایه ذخیره سازی زیرین مدیریت می کند و تمام ارتباطات بین فرآیندی (IPC) و سریال سازی درخواست های خروجی و پاسخ های دریافتی را مدیریت می کند.