Segerakkan data Apple Health ke MQTT

Automasi MQTT membolehkan anda menerbitkan data kesihatan secara automatik kepada broker MQTT. Ini sesuai untuk penyepaduan dengan platform IoT, sistem automasi rumah atau mana-mana perkhidmatan yang menyokong pemesejan MQTT.

Gambaran keseluruhan

Automasi MQTT menerbitkan data kesihatan anda sebagai mesej JSON kepada topik MQTT yang ditetapkan pada broker MQTT. Data dihantar apabila automasi berjalan mengikut tetapan kaden penyegerakan anda.

Kes penggunaan:

• Menyepadukan dengan platform IoT (Home Assistant, OpenHAB, dll.)
• Menerbitkan data kesihatan kepada papan pemuka berasaskan MQTT
• Sistem pemantauan kesihatan masa nyata
• Penyepaduan automasi rumah tersuai
• Platform log data dan analitis

Ciri utama:

• Format JSON sahaja (dioptimumkan untuk MQTT)
• Menyokong sambungan disahkan dan tanpa nama
• Struktur topik boleh konfigurasikan
• Pengurusan ID pelanggan
• Pengesahan nama pengguna/kata laluan pilihan

Had

• Akses data kesihatan: Apl tidak dibenarkan mengakses data kesihatan semasa iPhone dikunci. Automasi hanya berjalan semasa tempoh peranti anda dibuka kunci. Ini boleh menjejaskan kesegaran data. Lihat arahan untuk penyegerakan manual untuk mengekalkan data terkini.

• 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 dalam Mod Kuasa Rendah
  • Peranti tidak aktif untuk tempoh lama
  • Sumber sistem dikekang
  • Berbilang apl bersaing untuk masa pelaksanaan latar belakang

• Format JSON sahaja (tidak boleh ditukar)

• Memerlukan broker MQTT (tempatan atau berasaskan awan)

Prasyarat

• Broker MQTT (cth. Mosquitto, HiveMQ, AWS IoT Core, dll.)
• Sambungan rangkaian ke broker MQTT anda
• Alamat IP atau nama hos broker
• Nombor port
• Pilihan: Nama pengguna dan kata laluan jika broker anda memerlukan pengesahan

Konfigurasi

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

Nama automasi

Masukkan nama deskriptif untuk automasi anda (cth. "MQTT Home Assistant", "Broker MQTT Awan").

Pemberitahuan

Konfigurasikan bila anda ingin menerima pemberitahuan:

• Beritahu pada kemas kini cache — Terima pemberitahuan apabila data cache dikemas kini
• Beritahu semasa dijalankan — Terima pemberitahuan setiap kali automasi menerbitkan data

Konfigurasi broker

Alamat IP

Masukkan alamat IP atau nama hos broker MQTT anda.

Contoh:

• 192.168.1.100 (alamat IP tempatan)
• mqtt.example.com (nama hos)
• broker.hivemq.com (broker MQTT awan)
• localhost (jika berjalan pada peranti yang sama, tidak disyorkan untuk iOS)

Nota: Gunakan alamat IP untuk broker tempatan pada rangkai anda, atau nama hos untuk broker berasaskan awan. Pastikan broker boleh diakses daripada peranti anda.

Port

Masukkan nombor port untuk broker MQTT anda.

Nota: Port lalai ialah 1883.

Topik

Masukkan topik MQTT di mana data kesihatan akan diterbitkan. Ini ialah topik yang pelanggan akan gunakan untuk menerima data kesihatan anda.

Contoh topik:

• health/data
• home/health/metrics
• user/health/export
• hae/nama-automasi

Amalan terbaik topik:

• Gunakan garis miring (/) untuk mencipta hierarki topik
• Gunakan nama deskriptif yang menunjukkan jenis data
• Elakkan ruang dan aksara khas
• Pertimbangkan menyertakan nama automasi untuk berbilang automasi

Nota: Nama topik sensitif huruf. Pastikan pelanggan menggunakan nama topik yang sama tepat.

ID pelanggan

Masukkan ID pelanggan unik untuk sambungan MQTT ini. Ini mengenal pasti peranti anda kepada broker MQTT.

Contoh ID pelanggan:

• health-export-iphone
• hae-client-001
• ios-health-app

Nama pengguna (pilihan)

Masukkan nama pengguna untuk pengesahan broker MQTT. Biarkan kosong jika broker anda tidak memerlukan pengesahan.

Kata laluan (pilihan)

Masukkan kata laluan untuk pengesahan broker MQTT. Biarkan kosong jika broker anda tidak memerlukan pengesahan.

Tetapan jenis data

Jenis data

Pilih jenis data kesihatan untuk dieksport:

• Metrik kesihatan — Langkah, kadar denyutan jantung, tidur dan ukuran kesihatan lain
• Latihan — Aktiviti senaman dan kecergasan
• Gejala — Gejala dan keadaan kesihatan
• ECG — Bacaan elektrokardiogram
• Pemberitahuan kadar denyutan jantung — Peristiwa kadar tinggi/rendah
• Keadaan minda — Entri mood dan keadaan mental (iOS 18.0+)
• Penjejakan kitaran — Data kitaran haid dan kesihatan reproduktif
• Ubat-ubatan — Log ubat dan pematuhan (iOS 26.0+)

Konfigurasi metrik kesihatan

Apabila Metrik kesihatan dipilih:

Pilih Metrik kesihatan — Pilih metrik tertentu untuk disertakan. Anda boleh memilih semua metrik tersedia atau metrik tertentu.

Petua: Memilih hanya metrik yang anda perlukan mengurangkan saiz mesej dan masa pemprosesan.

Sumber pilihan — Konfigurasikan sumber data mana mengambil keutamaan apabila berbilang sumber menyediakan metrik yang sama.

Konfigurasi latihan

Apabila Latihan dipilih:

Sertakan data laluan — Togol HIDUP untuk menyertakan laluan bagi latihan yang mempunyai data lokasi.

Sertakan metrik latihan — Togol HIDUP untuk menyertakan metrik kesihatan dikumpul semasa latihan (kadar denyutan jantung, kalori, dll.).

Pengumpulan masa (metrik latihan) — Apabila menggunakan Versi eksport 2 dan Sertakan metrik latihan didayakan:

• Minit — Mengumpulkan metrik latihan mengikut minit
• Saat — Mengumpulkan metrik latihan mengikut saat

Tetapan eksport

Format eksport

Nota: Automasi MQTT hanya menyokong format JSON. Tetapan ini tidak boleh ditukar dan ditetapkan secara automatik kepada JSON.

Versi eksport

Pilih Versi eksport untuk data latihan:

• Versi 1 — Format legasi
• Versi 2 — Format semasa dengan data latihan dipertingkatkan

Nota: Versi eksport terutamanya menjejaskan struktur data latihan jika anda mengeksport latihan.

Julat tarikh

Pilih bila data patut dieksport:

• Lalai — Menyegerak data untuk hari penuh sebelumnya tambah data sehingga tarikh dan masa semasa
• Sejak penyegerakan terakhir — Pada setiap penyegerakan, mengeksport semua data sejak eksport terakhir berjalan sehingga tarikh dan masa semasa
• Hari ini — Menyegerak semua data untuk tarikh semasa sehingga masa semasa
• Semalam — Menyegerak semua data untuk hari penuh sebelumnya
• 7 hari sebelumnya — Menyegerak data untuk tujuh hari penuh sebelumnya

Ringkaskan data

Apabila menggunakan format JSON dengan jenis data Metrik kesihatan, togol Ringkaskan data HIDUP atau MATI.

• HIDUP — Menyediakan ringkasan data diagregat (lalai)
• MATI — Menyediakan data tidak diagregat di mana boleh, menunjukkan titik data individu

Pengumpulan masa

Apabila Ringkaskan data didayakan, pilih cara data diagregat.

Ringkaskan data

Togol Ringkaskan data HIDUP atau MATI untuk Metrik kesihatan.

• HIDUP — Menyediakan ringkasan data diagregat (lalai)
• MATI — Menyediakan data tidak diagregat di mana boleh

Nota: Tetapan ini hanya terpakai kepada jenis data Metrik kesihatan.

Kaden penyegerakan

Konfigurasikan kerap automasi patut menerbitkan data ke MQTT:

Pilih nombor dan selang.

Ujian & pengesahan

Ujian manual

1. Ketik "Eksport manual" dalam skrin konfigurasi automasi
2. Pilih julat tarikh
3. Ketik "Eksport" untuk menerbitkan mesej
4. Gunakan pelanggan MQTT untuk melanggan topik anda dan mengesahkan mesej diterima

Menggunakan pelanggan MQTT

Untuk mengesahkan mesej diterbitkan:

1. Sediakan pelanggan MQTT
2. Sambung ke broker MQTT anda menggunakan kelayakan yang sama
3. Langgan topik anda
4. Cetuskan eksport manual daripada apl
5. Sahkan mesej muncul dalam pelanggan MQTT anda

Melihat log aktiviti

1. Ketik "Lihat Log Aktiviti" dalam skrin konfigurasi automasi
2. Semak larian automasi terkini
3. Semak ralat sambungan atau kegagalan terbit
4. Sahkan cap masa terbit

Format mesej

Mesej MQTT diterbitkan sebagai JSON. Muatan mesej mengikut format eksport JSON standard:

{
  "data": {
    "metrics": [...],
    "workouts": [...],
    ...
  }
}

Mesej diterbitkan dengan:

• Topik: Seperti dikonfigurasikan dalam automasi
• QoS: Penghantaran paling banyak sekali
• Retain: Mesej tidak dikekalkan
• Muatan: Rentetan JSON mengandungi data kesihatan

Penyelesaian masalah

Isu biasa

Kegagalan sambungan

• Sahkan alamat IP/nama hos broker betul
• Semak bahawa port betul dan broker mendengar pada port tersebut
• Pastikan sambungan rangkaian ke broker
• Sahkan peraturan firewall membenarkan sambungan ke broker
• Semak jika broker memerlukan TLS/SSL

Kegagalan pengesahan

• Sahkan nama pengguna dan kata laluan betul
• Semak bahawa pengesahan didayakan pada broker anda jika kelayakan diberikan
• Pastikan pengguna mempunyai kebenaran menerbit ke topik yang ditetapkan

Mesej tidak diterima

• Sahkan nama topik sepadan tepat (sensitif huruf)
• Semak bahawa pelanggan disambungkan ke broker yang sama
• Pastikan pelanggan melanggan topik yang betul
• Sahkan automasi didayakan dan berjalan
• Semak Log Aktiviti untuk ralat terbit

Saiz mesej besar

• Kurangkan bilangan metrik kesihatan dipilih
• Gunakan pilihan agregat kurang terperinci
• Pertimbangkan pecahkan kepada berbilang automasi untuk jenis data berbeza

Petua dan amalan terbaik

1. Penyegerakan automatik:

   • Cas peranti anda dan gunakan Cerminan iPhone
     • Apabila peranti dicas iOS meletakkan kurang sekatan pada prestasi peranti, jadi data boleh disegerakkan lebih kerap
     • Dengan menggunakan Cerminan iPhone, peranti anda berkelakuan sama seperti dibuka kunci. Ini bermakna data kesihatan boleh diakses oleh Health Auto Export untuk menjalankan tindakan automatik

2. Pengorganisasian topik:

   • Gunakan struktur topik hierarki (cth. health/metrics, health/workouts)
   • Sertakan pengecam peranti atau automasi dalam topik
   • Dokumentasikan struktur topik anda untuk rujukan mudah

3. Saiz mesej:

   • Kekalkan mesej pada saiz munasabah untuk mengelakkan had broker MQTT
   • Gunakan agregat kurang terperinci untuk mengurangkan isipadu data
   • Pertimbangkan pecahkan set data besar merentas berbilang mesej

4. Pemantauan:

   • Gunakan Log Aktiviti dalam apl untuk menjejaki kejayaan terbit

5. Broker awan:

   • Apabila menggunakan broker MQTT awan (AWS IoT, HiveMQ Cloud, dll.):
     • Ikut keperluan sambungan khusus mereka
     • Semak had saiz mesej dan kadar mereka
     • Sahkan konvensyen penamaan topik