Jenis data di Health Connect disimpan dalam objek yang merupakan subkelas dari
Record.
Untuk setiap jenis data, ada kolom terkait yang bersifat umum seperti
time dan zoneOffset, atau spesifik seperti title, count, dan percentage.
Beberapa kolom menggunakan jenis dasar—seperti long, double, atau string—sementara yang lain menggunakan jenis kompleks seperti enumerasi dan class seperti Instant dan
ZoneOffset. Atribut kolom ini dapat bersifat wajib atau opsional. Beberapa atribut bersifat hanya baca, dan beberapa atribut di-clamp ke rentang nilai tertentu.
Untuk daftar lengkap jenis data yang tersedia dan kolomnya, lihat class di Jetpack.
Atribut metadata
Data di Health Connect API juga mencakup atribut metadata yang dijelaskan dalam daftar berikut:
- ID Health Connect: Setiap titik data ditetapkan dengan ID unik (UID) saat pembuatan. Hal ini berguna untuk operasi baca dan tulis standar. Lihat ID Health Connect untuk mengetahui detail selengkapnya.
- Waktu terakhir diubah: Tindakan ini menandai stempel waktu saat instance terakhir data memiliki update. ID ini otomatis dibuat pada saat pembuatan pertama data atau pada setiap update.
- Asal data: Health Connect menyimpan informasi tentang aplikasi asal data. Objek ini berisi nama paket asal tersebut, yang ditambahkan secara otomatis saat pembuatan.
- Perangkat: Health Connect menyimpan informasi tentang perangkat asal data. Kode ini berisi produsen dan model perangkat tersebut, yang nilainya Anda berikan secara manual.
- Client ID: Health Connect menyediakan Client ID sehingga aplikasi klien dapat merujuk ke data menggunakan ID-nya sendiri, yang membantu penyelesaian konflik dan mempermudah sinkronisasi. Ini disediakan ke data secara manual.
- Versi data klien: Bersama dengan Client ID, Health Connect memberikan versi untuk membantu melacak perubahan selama sinkronisasi data. Ini disediakan ke data secara manual.
- Metode perekaman: Health Connect memungkinkan Anda memahami cara data direkam. Metode ini mencakup aplikasi yang mencatat data secara pasif (otomatis), dan pengguna yang mencatat data secara aktif atau manual.
ID Health Connect
Health Connect memberikan ID unik (UID) ke objek data yang baru disisipkan, yang mengidentifikasi objek data dan membedakannya dari objek data lain. ID Health Connect berguna dalam permintaan baca atau tulis. ID Health Connect tidak sama dengan ID Klien. Aplikasi klien menetapkan Client ID, sedangkan Health Connect menetapkan ID Health Connect secara eksklusif.
Perhatikan catatan berikut saat menggunakan ID Health Connect:
- Sesi memiliki satu ID Health Connect, tetapi data dalam sesi memiliki ID Health Connect sendiri.
- ID Health Connect tidak terikat atau terkait dengan stempel waktu.
- Beberapa kasus penggunaan mungkin memerlukan penyimpanan ID Health Connect tertentu selama alur kerja. Misalnya, ID tertentu diperlukan untuk mengambil dan menampilkan entri data yang baru saja dicatat pengguna.
Waktu di Health Connect
Semua data yang ditulis ke Health Connect harus menentukan informasi offset zona waktu. Menentukan offset zona waktu memungkinkan aplikasi membaca data untuk mewakilinya dalam waktu sipil. Waktu sipil adalah waktu yang bersifat lokal dan relevan bagi pengguna, tetapi tidak harus dalam Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC).
Dalam kasus yang jarang terjadi, offset zona waktu mungkin tidak tersedia. Jika hal ini terjadi di Android 14 (Level API 34), Health Connect akan menyetel offset zona berdasarkan zona waktu default sistem perangkat. Di Android 13 dan versi yang lebih lama (Level API 33 dan yang lebih rendah), Anda dapat menulis ke Health Connect tanpa menentukan informasi offset zona waktu, yang harus dihindari jika memungkinkan.
Setelan waktu dan zona
Menentukan informasi offset zona waktu saat menulis data memberikan informasi zona waktu saat membaca data di Health Connect. Namun, tindakan ini dapat gagal dalam situasi tertentu, seperti saat offset zona waktu tidak diberikan. Aplikasi Anda harus siap menangani kedua jenis data, dengan cara yang sesuai dengan situasi tertentu.