HealthyApps Help Center

Segerakkan Data Kesihatan Apple ke Pembantu Rumah

Sepadukan data kesihatan anda dengan Home Assistant.

Last updated: February 5, 2026

Pada halaman ini

Automasi Home Assistant membolehkan anda menyegerakkan data kesihatan anda secara automatik ke Home Assistant sebagai keadaan sensor. Penyepaduan ini membolehkan anda menggunakan data kesihatan anda dalam automasi Pembantu Rumah, papan pemuka dan penyepaduan lain.

Gambaran Keseluruhan

Automasi Home Assistant menghantar metrik kesihatan anda ke Home Assistants REST API, mencipta atau mengemas kini keadaan penderia yang boleh digunakan sepanjang tika Home Assistant anda. Data diformatkan khusus untuk API /states/ Pembantu Rumah.

Kes Penggunaan:

  • Paparkan metrik kesihatan pada papan pemuka Home Assistant
  • Buat automasi berdasarkan data kesihatan
  • Mengintegrasikan data kesihatan dengan peranti rumah pintar yang lain
  • Jejaki trend kesihatan dari semasa ke semasa dalam Home Assistant

Ciri Utama:

  • Penciptaan keadaan sensor automatik
  • Format JSON sahaja (dioptimumkan untuk Pembantu Rumah)
  • Jenis data Metrik Kesihatan sahaja
  • Konfigurasi URL mudah

Keterbatasan

  • Akses Data Kesihatan: Apl tidak dibenarkan mengakses data kesihatan semasa iPhone dikunci. Automasi hanya akan dijalankan semasa tempoh peranti anda dibuka kunci. Ini boleh menjejaskan kesegaran data. Lihat arahan untuk penyegerakan manual untuk memastikan data dikemas kini.

  • Pemprosesan Latar Belakang: iOS mengehadkan pemprosesan latar belakang untuk mengekalkan hayat bateri. Automasi bergantung pada Muat Semula Apl Latar Belakang dan mungkin tidak berjalan serta-merta jika:

  • Muat Semula Apl Latar Belakang dilumpuhkan untuk apl itu

  • Peranti berada dalam Mod Kuasa Rendah

  • Peranti telah tidak aktif untuk tempoh yang lama

  • Sumber sistem dikekang

  • Pelbagai aplikasi bersaing untuk masa pelaksanaan latar belakang

  • Hanya menyokong jenis data Metrik Kesihatan

  • Format JSON sahaja (tidak boleh diubah)

Prasyarat

  • Contoh Home Assistant berjalan dan boleh diakses pada rangkaian anda
  • Token akses API Pembantu Rumah (Token Akses Berumur Panjang)
  • Kesambungan rangkaian ke contoh Home Assistant anda
  • Versi Home Assistant yang menyokong REST API

Konfigurasi

Navigasi ke skrin Eksport Automatik daripada navigasi utama, kemudian ketik "Automasi Baharu" dan pilih "Pembantu Rumah" sebagai Jenis Automasi.

Nama Automasi

Masukkan nama deskriptif untuk automasi anda. Nama ini akan digunakan untuk menjana ID entiti penderia dalam Home Assistant.

Nota: Nama automasi akan ditukar kepada huruf kecil dengan ruang dialih keluar untuk membuat ID entiti. Contohnya, "Data Kesihatan Saya" menjadi hae.myhealthdata.

Pemberitahuan

Konfigurasikan apabila anda ingin menerima pemberitahuan:

  • Beritahu pada Kemas Kini Cache - Terima pemberitahuan apabila data cache dikemas kini
  • Beritahu Apabila Dijalankan - Terima pemberitahuan setiap kali automasi dilaksanakan

URL Pembantu Rumah

Masukkan URL asas tika Pembantu Rumah anda. Ini harus termasuk protokol dan port jika tidak menggunakan lalai.

Contoh URL:

  • http://homeassistant.local:8123
  • http://192.168.1.100:8123

Nota: URL mesti boleh diakses daripada peranti anda. Jika menggunakan HTTPS, pastikan sijil anda sah atau tambahkan pengecualian.

Titik Akhir Dijana Auto

Apl menjana titik akhir API penuh secara automatik berdasarkan nama automasi anda:

{your_url}/api/states/hae.{automation_name}

Contohnya, jika URL anda ialah http://homeassistant.local:8123 dan nama automasi anda ialah "Metrik Kesihatan", titik tamatnya ialah:

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

Titik akhir ini dipaparkan di bawah medan URL untuk rujukan.

Permintaan Tamat Masa

Pilih selang masa tamat untuk permintaan HTTP kepada Home Assistant.

Pilihan tamat masa yang tersedia:

  • 60 saat - Lalai, sesuai untuk kebanyakan kejadian Pembantu Rumah
  • 300 saat (5 minit) - Untuk keadaan Home Assistant yang lebih perlahan
  • 1800 saat (30 minit) - Untuk pemprosesan yang sangat perlahan
  • 3600 saat (1 jam) - Tamat masa maksimum yang disyorkan

Pengepala HTTP

Tambahkan pengepala pengesahan untuk akses API Pembantu Rumah. Anda perlu menambah pengepala Kebenaran dengan Token Akses Jangka Panjang anda.

Pengepala Diperlukan:

  • Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Untuk mendapatkan Token Akses Berumur Panjang:

  1. Pembantu Rumah Terbuka
  2. Pergi ke profil anda (klik nama anda di bahagian bawah kiri)
  3. Tatal ke bawah ke "Token Akses Berumur Panjang"
  4. Klik "Buat Token"
  5. Beri nama (cth., "Eksport Auto Kesihatan")
  6. Salin token dan tampalkannya dalam medan nilai pengepala

Tajuk Pilihan:
Anda boleh menambah pengepala tambahan jika perlu untuk persediaan Home Assistant anda.

Untuk menambah pengepala:

  1. Ketik "Tambah Pengepala"
  2. Masukkan kekunci pengepala dalam medan kiri
  3. Masukkan nilai pengepala dalam medan yang betul
  4. Ulang untuk pengepala tambahan

Penting: Setiap kunci pengepala mesti mempunyai nilai yang sepadan. Pengepala kosong akan diabaikan.

Tetapan Jenis Data

Jenis Data

Nota: Automasi Pembantu Rumah hanya menyokong jenis data Metrik Kesihatan. Tetapan ini tidak boleh ditukar dan ditetapkan secara automatik kepada Metrik Kesihatan.

Konfigurasi Metrik Kesihatan

Pilih Metrik Kesihatan - Pilih metrik khusus yang hendak disertakan. Anda boleh memilih semua metrik yang tersedia atau memilih yang khusus.

Petua: Memilih hanya metrik yang anda perlukan boleh meningkatkan masa pemprosesan dan mengurangkan saiz data yang dihantar kepada Home Assistant.

Sumber Pilihan - Konfigurasikan sumber data mana yang diutamakan apabila berbilang sumber menyediakan metrik yang sama.

Tetapan Eksport

Format Eksport

Nota: Automasi Home Assistant hanya menyokong format JSON. Tetapan ini tidak boleh diubah dan ditetapkan secara automatik kepada JSON.

Versi Eksport

Nota: Versi Eksport tidak tersedia untuk automasi Home Assistant kerana format dioptimumkan khusus untuk API keadaan Home Assistant.

Julat Tarikh

Pilih bila data harus dieksport:

  • Lalai - Menyegerakkan data untuk hari sebelumnya penuh serta data sehingga tarikh dan masa semasa
  • Hari ini - Menyegerakkan semua data untuk tarikh semasa sehingga masa semasa
  • Semalam - Menyegerakkan semua data untuk penuh hari sebelumnya

Nota: Automasi Home Assistant tidak menyokong pilihan "Masa Nyata", "Sejak Penyegerakan Terakhir" atau "7 Hari Sebelumnya".

Ringkaskan Data

Togol Ringkaskan Data HIDUP atau MATI untuk Metrik Kesihatan.

  • HIDUP - Menyediakan ringkasan data agregat (lalai)
  • OFF - Menyediakan data terpesong jika boleh

Nota: Tetapan ini hanya digunakan pada jenis data Metrik Kesihatan.

Pengumpulan Masa

Apabila Ringkaskan Data didayakan, pilih cara data harus diagregatkan:

  • Lalai - Tiada pengagregatan, titik data mentah
  • Hari - Kumpulkan data mengikut hari (disyorkan)

Irama Segerak

Konfigurasikan kekerapan automasi harus menyegerakkan data ke Home Assistant:

Pilih nombor dan selang.

Ujian & Pengesahan

Ujian Manual

  1. Ketik "Eksport Manual" dalam skrin konfigurasi automasi
  2. Pilih julat tarikh
  3. Ketik "Eksport" untuk menghantar permintaan ujian
  4. Semak Pembantu Rumah untuk mengesahkan keadaan penderia telah dibuat/kemas kini

Mengesahkan dalam Pembantu Rumah

  1. Pembantu Rumah Terbuka
  2. Pergi ke Alat Pembangun > Negeri
  3. Cari hae.{your_automation_name} (huruf kecil, tiada ruang)
  4. Sahkan keadaan penderia menunjukkan data kesihatan anda
  5. Semak cap waktu "Terakhir Dikemas Kini" untuk mengesahkan penyegerakan baru-baru ini

Melihat Log Aktiviti

  1. Ketik "Lihat Log Aktiviti" dalam skrin konfigurasi automasi
  2. Semak larian automasi baru-baru ini
  3. Semak sebarang ralat atau amaran
  4. Sahkan cap masa permintaan dan status respons

Menyemak Log Pembantu Rumah

Jika data tidak muncul dalam Home Assistant:

  1. Pembantu Rumah Terbuka
  2. Pergi ke Tetapan > Sistem > Log
  3. Cari ralat yang berkaitan dengan REST API atau keadaan sensor
  4. Semak ralat pengesahan atau format data tidak sah

Menyelesaikan masalah

Isu Biasa

Ralat Pengesahan

  • Sahkan Token Akses Jangka Panjang anda adalah betul
  • Pastikan pengepala Kebenaran diformatkan sebagai: Bearer YOUR_TOKEN
  • Semak sama ada token belum tamat tempoh atau dibatalkan
  • Sahkan token mempunyai kebenaran yang sesuai dalam Home Assistant

Penderia Tidak Muncul dalam Pembantu Rumah

  • Semak bahawa nama automasi tidak mengandungi aksara khas
  • Sahkan format ID entiti: hae.{automation_name} (huruf kecil, tiada ruang)
  • Semak log Pembantu Rumah untuk ralat
  • Pastikan permintaan API berjaya (semak Log Aktiviti)

Data Tidak Kemas Kini

  • Semak sama ada automasi didayakan
  • Semak Log Aktiviti untuk mencari ralat
  • Pastikan sambungan rangkaian ke Home Assistant

Tamat Masa Sambungan

  • Sahkan Pembantu Rumah sedang berjalan dan boleh diakses
  • Semak sambungan rangkaian
  • Tingkatkan tetapan Permintaan Tamat Masa jika Pembantu Rumah lambat bertindak balas
  • Sahkan URL dan port adalah betul

Mesej Ralat

Apl akan memaparkan mesej ralat jika:

  • URL tidak sah atau tidak boleh dicapai
  • Pengesahan gagal (semak pengepala Kebenaran)
  • Home Assistant mengembalikan kod status ralat
  • Kesambungan rangkaian tidak tersedia

Semak Log Aktiviti untuk mendapatkan maklumat ralat terperinci termasuk kod status HTTP dan mesej ralat daripada Home Assistant.

Petua Integrasi Pembantu Rumah

Menggunakan Data Kesihatan dalam Automasi

Setelah data kesihatan anda disegerakkan ke Home Assistant, anda boleh menggunakannya dalam automasi:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Mencipta Papan Pemuka

Tambahkan metrik kesihatan pada papan pemuka Home Assistant anda:

  1. Pergi ke papan pemuka anda
  2. Tambah kad baharu
  3. Pilih jenis kad "Entiti" atau "Tolok".
  4. Tambahkan entiti penderia hae.{your_automation_name}

Struktur Keadaan Sensor

Keadaan penderia dalam Home Assistant mengandungi:

  • state: Nilai atau status semasa
  • attributes: Data tambahan termasuk:
  • Maklumat cap masa
  • Struktur data sepadan dengan format JSON yang dieksport
  • Maklumat unit jika berkenaan

Petua dan Amalan Terbaik

  1. Penyegerakan Automatik:
  • Cas peranti anda dan gunakan iPhone Mirroring
  • Apabila peranti anda sedang dicas, iOS meletakkan kurang sekatan pada prestasi peranti, jadi data boleh disegerakkan dengan lebih kerap
  • Dengan menggunakan iPhone Mirroring, peranti anda berkelakuan dengan cara yang sama seperti ia tidak berkunci. Ini bermakna data kesihatan boleh diakses oleh Eksport Auto Kesihatan untuk menjalankan tindakan automatik
  1. Penamaan:
  • Elakkan watak khas yang mungkin menyebabkan masalah
  1. Pemilihan Data:
  • Pilih hanya metrik yang anda perlukan