Sinkronkan data Apple Health ke Home Assistant

Publikasikan metrik kesehatan ke Home Assistant sebagai status entitas terpisah. Tujuan ini hanya mendukung metrik kesehatan.

Penting — batasan otomatisasi: Perangkat Anda harus tidak terkunci untuk membaca data kesehatan, dan iOS tidak menjamin proses latar belakang pada frekuensi yang Anda pilih. Tinjau Batasan Otomatisasi sebelum mengandalkan ekspor otomatis.

Membuka otomatisasi

Buka Ekspor → Otomatis di iPhone, atau Otomatisasi di bilah sisi iPad. Pilih Otomatisasi Baru, atau buka otomatisasi yang sudah ada untuk mengeditnya.

Nama, status, dan notifikasi

Masukkan nama yang mengidentifikasi otomatisasi ini. Diaktifkan memungkinkan proses otomatis; biarkan nonaktif sampai Anda siap.

Pilih notifikasi proses yang Anda inginkan:

• Beritahu saat Pembaruan Cache melaporkan bahwa data ekspor telah disiapkan.
• Beritahu saat Proses melaporkan publikasi berhasil ke Home Assistant.

Izinkan notifikasi saat diminta. Notifikasi ini melaporkan aktivitas; notifikasi tidak menjadwalkan proses.

Hubungkan Home Assistant

1. Pilih Home Assistant sebagai Jenis Otomatisasi.
2. Masukkan URL dasar instance Home Assistant Anda, misalnya http://homeassistant.local:8123.
3. Buat Long-Lived Access Token di profil Home Assistant Anda.
4. Di bawah HTTP Headers, tambahkan Authorization dengan nilai Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Instance Home Assistant Anda harus dapat dijangkau dari iPhone atau iPad. Untuk HTTPS, gunakan sertifikat yang dipercaya perangkat Anda.

Pengaturan Metrik Kesehatan

Buka Pilih Metrik Kesehatan dan pilih pembacaan yang akan dipublikasikan.

Buka Sumber yang Disukai untuk memilih sumber untuk setiap metrik. Gunakan Semua untuk semua sumber yang tidak dikecualikan, atau Sumber yang Dikecualikan untuk mengabaikan sumber di otomatisasi ini. Pengecualian didahulukan, dan sumber yang tidak dipilih tidak menggantikan sumber yang diutamakan tanpa data. Pilih Simpan untuk menerapkan pilihan atau Batal untuk membuangnya.

Pengaturan Ekspor

Home Assistant menggunakan format status entitas JSON sendiri; tidak ada pilihan format file atau versi ekspor.

Rentang Tanggal

• Bawaan: Mencakup hari sebelumnya dan hari ini hingga waktu proses.
• Hari Ini: Mencakup hari ini hingga waktu proses.
• Kemarin: Mencakup hari penuh sebelumnya.

Pengelompokan Waktu

Pilih Bawaan untuk menjaga pembacaan tidak dikelompokkan atau Hari untuk menggunakan ringkasan harian. Home Assistant tidak memiliki sakelar Ringkas Data.

Jadwalkan Pengingat

Jika Anda ingin perintah untuk membuka kunci dan membuka aplikasi, aktifkan Aktifkan Pengingat. Pilih Setiap jam, Setiap hari, atau Hari yang dipilih, lalu atur menit, waktu, dan hari yang berlaku. Izinkan akses notifikasi saat diminta; jika akses ditolak, gunakan Buka Pengaturan Notifikasi.

Pengingat tidak menjalankan otomatisasi atau mengonfirmasi sinkronisasi yang berhasil. Ketuk untuk membuka otomatisasi, atau gunakan Buka & Sinkronkan pada notifikasi untuk meminta proses. Otomatisasi harus diaktifkan; pengingat tetap dapat muncul setelah proses latar belakang berhasil. Perubahan pengingat berlaku saat Anda menyimpan.

Frekuensi Sinkronisasi dan menyimpan

Pilih angka dan Menit atau Jam di bawah Frekuensi Sinkronisasi. Ini adalah ritme latar belakang yang diinginkan, bukan jadwal yang dijamin.

Perangkat Anda harus tidak terkunci saat data kesehatan dibaca. Aktifkan Penyegaran Aplikasi Latar Belakang untuk Health Auto Export dan matikan Mode Daya Rendah untuk proses otomatis. iOS tetap dapat menunda proses saat perangkat tidak aktif atau sumber daya sistem terbatas.

Aktifkan Diaktifkan saat Anda siap untuk proses otomatis, lalu pilih Perbarui untuk menyimpan otomatisasi. Anda dapat mengunggah rentang tanggal yang dipilih segera menggunakan langkah di bawah.

Entitas yang dipublikasikan

Setiap metrik yang dipilih dapat menghasilkan satu atau beberapa entitas. Pengenal dimulai dengan hae., diikuti nama otomatisasi dalam huruf kecil tanpa spasi, lalu metrik dan nama komponen apa pun.

Misalnya, otomatisasi bernama Health Metrics dapat memublikasikan langkah ke:

http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count

Status adalah pembacaan terbaru untuk hari yang dipilih, dengan atribut satuan pengukuran. Metrik seperti tekanan darah dan denyut jantung menggunakan entitas komponen terpisah.

Ketika suatu hari tidak memiliki data, total seperti langkah dan jam berdiri memublikasikan 0. Pembacaan lain, seperti berat atau denyut jantung, tidak diperbarui sampai data tersedia, sehingga Home Assistant mungkin terus menampilkan nilai terakhir yang diterimanya. Di awal hari, total mungkin tetap 0 sampai data Watch mencapai iPhone Anda.

Mengekspor data historis atau yang terlewat

Gunakan Unggah Manual saat pertama kali menyiapkan otomatisasi untuk mengekspor data historis, atau nanti untuk mencakup tanggal yang terlewat oleh sinkronisasi otomatis. Anda juga dapat menggunakannya untuk memeriksa penyiapan.

1. Buka otomatisasi dan pilih Unggah Manual di bawah Ekspor Data yang Ada.
2. Atur tanggal Mulai dan Akhir, lalu pilih Mulai Ekspor.
3. Di Home Assistant, buka Developer Tools → States dan cari awalan hae. otomatisasi Anda.
4. Periksa nilai entitas dan waktu pembaruan.

Pemecahan masalah

• Kesalahan autentikasi: Periksa token dan header Authorization: Bearer ....
• Koneksi gagal: Periksa URL dasar, port, akses jaringan, dan kepercayaan sertifikat.
• Beberapa pembacaan hilang: Tinjau hari yang dipilih, sumber, dan Log Aktivitas. Satu proses dapat memperbarui beberapa entitas sementara yang lain gagal.

Buka otomatisasi dan pilih Lihat Log Aktivitas untuk memeriksa langkah yang gagal. Untuk dukungan, lihat Mendapatkan Bantuan.