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

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

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

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

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

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

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

شناسه ارتباط با سلامت

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

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

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

زمان در Health Connect

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

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

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

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