فرمت نوع داده Health Connect

انواع داده ها در Health Connect در اشیایی که زیر کلاس های Record هستند ذخیره می شوند.

برای هر نوع داده، فیلدهای مرتبطی وجود دارد که یا عمومی هستند مانند time و zoneOffset ، یا خاص مانند title ، count و percentage . برخی از فیلدها از انواع پایه (مانند طولانی، دوتایی یا رشته ای) استفاده می کنند، در حالی که برخی دیگر از انواع پیچیده مانند enumerations و کلاس هایی مانند Instant و ZoneOffset استفاده می کنند. ویژگی های این فیلدها می تواند الزامی یا اختیاری باشد. برخی از ویژگی ها فقط خواندنی هستند و برخی از ویژگی ها به محدوده خاصی از مقادیر متصل می شوند.

برای لیست کامل انواع داده های موجود و فیلدهای آنها، به کلاس های Jetpack مراجعه کنید.

ویژگی های فراداده

داده‌های موجود در Health Connect API همچنین شامل ویژگی‌های فراداده است که در لیست زیر توضیح داده شده است:

• شناسه اتصال سلامت: به هر نقطه از داده ها یک شناسه منحصر به فرد (UID) پس از ایجاد اختصاص داده می شود. این برای عملیات خواندن و نوشتن استاندارد مفید است. برای جزئیات بیشتر به Health Connect ID مراجعه کنید.
• آخرین زمان اصلاح شده: این نشان‌دهنده مُهر زمانی آخرین نمونه‌ای است که یک رکورد به‌روزرسانی می‌کند. این به طور خودکار در اولین ایجاد رکورد یا در هر به روز رسانی ایجاد می شود.
• مبدا داده ها: Health Connect اطلاعات مربوط به برنامه ای را که داده ها از آنجا آمده اند ذخیره می کند. این شامل نام بسته آن مبدا است که به طور خودکار پس از ایجاد اضافه می شود.
• دستگاه: Health Connect اطلاعات مربوط به دستگاهی را که داده ها از آنجا آمده اند ذخیره می کند. این شامل سازنده و مدل آن دستگاه است که شما به صورت دستی مقدار آن را ارائه می دهید.
• شناسه مشتری: Health Connect شناسه های مشتری را ارائه می دهد تا برنامه های مشتری بتوانند با استفاده از شناسه های خود به داده ها مراجعه کنند، که به حل تعارض کمک می کند و همگام سازی را آسان تر می کند. این به صورت دستی به رکورد ارائه می شود.
• نسخه رکورد مشتری: همراه با شناسه مشتری، Health Connect برای کمک به ردیابی تغییرات در حین همگام سازی داده ها، نسخه سازی را ارائه می دهد. این به صورت دستی به رکورد ارائه می شود.
• روش ضبط: Health Connect به شما امکان می‌دهد نحوه ثبت داده‌ها را درک کنید. این روش ها شامل برنامه هایی است که داده ها را به صورت غیرفعال (به طور خودکار) ضبط می کنند و کاربرانی که داده ها را به صورت فعال یا دستی ضبط می کنند.

شناسه اتصال سلامت

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

هنگام کار با Health Connect ID نکات زیر را در نظر داشته باشید :

• Session ها یک شناسه Health Connect دارند، اما داده های درون جلسات شناسه Health Connect مخصوص به خود را دارند.
• شناسه‌های Health Connect مرتبط یا مرتبط با مهر زمانی نیستند.
• برخی موارد استفاده ممکن است نیاز به ذخیره شناسه Health Connect خاص در طول یک گردش کار داشته باشند. به عنوان مثال، یک شناسه خاص برای بازیابی و نشان دادن ورودی داده‌ای که کاربر به تازگی ثبت کرده است، مورد نیاز است.

زمان در Health Connect

همه داده های نوشته شده در Health Connect باید اطلاعات منطقه افست را مشخص کنند. تعیین منطقه افست به برنامه‌ها امکان می‌دهد داده‌ها را برای نمایش آن در زمان مدنی بخوانند. زمان مدنی زمانی است که محلی و مربوط به کاربر است، اما لزوماً در زمان هماهنگ جهانی (UTC) نیست.

در شرایط نادر، منطقه افست ممکن است در دسترس نباشد. هنگامی که این اتفاق در Android 14 (سطح API 34) رخ می‌دهد، Health Connect بر اساس منطقه زمانی پیش‌فرض سیستم، افست منطقه را تنظیم می‌کند. در اندروید 13 و نسخه‌های پایین‌تر (سطح API 33 و پایین‌تر)، می‌توان به Health Connect بدون مشخص کردن اطلاعات افست ناحیه‌ای نوشت، که در صورت امکان باید از آن اجتناب کرد.

تنظیم زمان و منطقه

مشخص کردن اطلاعات افست منطقه هنگام نوشتن داده، اطلاعات منطقه زمانی را هنگام خواندن داده ها در Health Connect ارائه می دهد. با این حال، ممکن است این کار را در شرایط خاصی انجام ندهد، مانند زمانی که منطقه افست ارائه نشده است. برنامه شما باید برای مقابله با هر دو نوع داده آماده باشد، به نحوی که برای شرایط خاص شما منطقی باشد.