Segerakkan data Apple Health ke MQTT

Terbitkan eksport kesihatan sebagai JSON ke topik pada broker MQTT anda.

Penting — had automasi: Peranti anda mesti tidak dikunci untuk membaca data kesihatan, dan iOS tidak menjamin jalanan latar belakang pada kekerapan yang anda pilih. Semak Had Automasi sebelum bergantung pada eksport automatik.

Membuka automasi

Buka Eksport → Automatik pada iPhone, atau Automasi dalam bar sisi iPad. Pilih Automasi Baharu, atau buka automasi sedia ada untuk mengeditnya.

Nama, status, dan pemberitahuan

Masukkan nama yang mengenal pasti automasi ini. Didayakan membenarkan jalanan automatik; biarkan dimatikan sehingga anda bersedia.

Pilih sebarang pemberitahuan jalanan yang anda mahu:

• Beritahu pada Kemas Kini Cache melaporkan bahawa data eksport telah disediakan.
• Beritahu Apabila Berjalan melaporkan penerbitan yang berjaya ke broker.

Benarkan pemberitahuan apabila digesa. Pemberitahuan ini melaporkan aktiviti; ia tidak menjadualkan jalanan.

Sediakan sambungan

1. Pilih MQTT sebagai Jenis Automasi.
2. Masukkan nama hos atau alamat IP broker anda dan port. Port lalai ialah 1883.
3. Masukkan Topic, contohnya health/metrics.
4. Tetapkan ID Klien unik untuk setiap automasi dan masukkan nama pengguna serta kata laluan jika diperlukan broker.

Broker mesti boleh dicapai dari peranti anda. Pelanggan mesti menggunakan topik yang tepat, termasuk huruf besar/kecil. Menggunakan semula client ID boleh menyebabkan sambungan broker menggantikan satu sama lain.

Tetapan Jenis Data

Pilih satu Jenis Data untuk automasi ini: Metrik Kesihatan, Senaman, Simptom, ECG, Pemberitahuan Kadar Jantung, Keadaan Minda, Penjejakan Kitaran, atau Ubat. Keadaan Minda memerlukan iOS 18 atau lebih baharu; Ubat memerlukan iOS 26 atau lebih baharu dan akses ubat berasingan.

Metrik kesihatan

Pilih Metrik Kesihatan, kemudian buka Pilih Metrik Kesihatan dan pilih ukuran yang anda perlukan.

Untuk mengehadkan bacaan kepada aplikasi atau peranti tertentu, buka Sumber Pilihan, pilih metrik, dan pilih sumbernya. Semua membenarkan setiap sumber yang belum dikecualikan. Gunakan Sumber Dikecualikan untuk mengabaikan sumber merentas metrik kesihatan automasi ini. Pengecualian mengatasi; sumber yang tidak dipilih tidak digantikan apabila sumber pilihan tiada data. Pilih Simpan untuk menggunakan pilihan sumber atau Batal untuk membuangnya.

Senaman

Pilih Senaman untuk mengeksport rekod senaman. Sertakan Data Laluan menambah titik laluan yang tersedia kepada data senaman JSON. Ia tidak mencipta muat naik GPX berasingan.

Untuk Versi 2, hidupkan Sertakan Metrik Senaman untuk menambah bacaan seperti kadar jantung, tenaga aktif, dan langkah. Pilih Minit atau Saat untuk Pengumpulan Masa metrik senaman; saat menghasilkan lebih banyak butiran dan eksport yang lebih besar. Versi 1 sentiasa menyertakan metrik senaman.

Tetapan Eksport

MQTT hanya menerbitkan JSON. Mesej menggunakan QoS 0 untuk penerbitan latar depan dan QoS 1 untuk penerbitan latar belakang. Mesej tidak dikekalkan.

Versi Eksport

Pilih Versi 2 untuk struktur data semasa. Gunakan Versi 1 apabila aliran kerja sedia ada bergantung pada format yang lebih lama.

Julat Tarikh

Pemilihan	Data disertakan
Lalai	Hari sebelumnya dan hari ini hingga masa jalanan
Sejak Penyegerakan Terakhir	Sejak segerak sebelumnya hingga masa jalanan
Hari Ini	Hari ini hingga masa jalanan
Semalam	Hari penuh sebelumnya
7 Hari Sebelumnya	Tujuh hari penuh sebelumnya

Ringkaskan Data dan Pengumpulan Masa

Untuk JSON + Metrik Kesihatan, hidupkan Ringkaskan Data untuk menggabungkan bacaan ke dalam kumpulan masa, atau matikan untuk bacaan individu di mana tersedia. Ringkasan bergantung pada metrik—contohnya, langkah dijumlahkan dan bacaan berat dipuratakan. Eksport metrik kesihatan CSV menggunakan data yang diringkaskan.

Apabila Pengumpulan Masa tersedia, pilih berapa banyak butiran untuk dikekalkan. Kumpulan setiap jam atau harian menghasilkan lebih sedikit baris daripada kumpulan minit atau saat. Pilihan yang tersedia bergantung pada julat tarikh dan format. Pengumpulan masa senaman dikonfigurasikan secara berasingan di bawah Senaman.

Jadualkan Peringatan

Jika anda mahu gesaan untuk membuka kunci dan membuka aplikasi, hidupkan Dayakan Peringatan. Pilih Setiap jam, Setiap Hari, atau Hari Dipilih, kemudian tetapkan minit, masa, dan hari yang berkenaan. Benarkan akses pemberitahuan apabila digesa; jika akses ditolak, gunakan Buka Tetapan Pemberitahuan.

Peringatan tidak menjalankan automasi atau mengesahkan segerak yang berjaya. Ketuknya untuk membuka automasi, atau gunakan Buka & Segerak pada pemberitahuan untuk meminta jalanan. Automasi mesti didayakan; peringatan mungkin masih muncul selepas jalanan latar belakang berjaya. Perubahan peringatan terpakai apabila anda menyimpan.

Kekerapan Segerak dan simpan

Pilih nombor dan Minit, Jam, Hari, atau Minggu di bawah Kekerapan Segerak—contohnya, setiap 15 minit. Ini ialah rentak latar belakang yang diingini, bukan jadual yang dijamin.

Peranti anda mesti tidak dikunci apabila data kesihatan dibaca. Dayakan Muat Semula Aplikasi Latar Belakang untuk Health Auto Export dan matikan Mod Kuasa Rendah untuk jalanan automatik. iOS masih boleh melengahkan jalanan apabila peranti tidak aktif atau sumber sistem terhad.

Hidupkan Didayakan apabila anda bersedia untuk jalanan automatik, kemudian pilih Kemas Kini untuk menyimpan automasi. Anda boleh memuat naik julat tarikh yang dipilih serta-merta menggunakan langkah di bawah.

Mengeksport data sejarah atau terlepas

Gunakan Muat Naik Manual apabila anda mula-mula menyediakan automasi untuk mengeksport data sejarah, atau kemudian untuk merangkumi tarikh yang terlepas oleh segerak automatik. Anda juga boleh menggunakannya untuk menyemak persediaan.

1. Sambungkan pelanggan MQTT ke broker anda dan langgan topik yang dikonfigurasikan.
2. Dalam Health Auto Export, buka automasi dan pilih Muat Naik Manual di bawah Eksport Data Sedia Ada.
3. Tetapkan tarikh Mula dan Tamat, kemudian pilih Mulakan Eksport.
4. Semak JSON yang diterima dan tarikhnya.

Muatan mengikuti format eksport JSON. Contohnya:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

Penyelesaian masalah

• Sambungan gagal: Semak hos, port, akses rangkaian, dan keperluan sambungan broker.
• Pengesahan gagal: Semak kelayakan dan kebenaran untuk menerbitkan ke topik.
• Tiada mesej: Sahkan pelanggan menggunakan broker dan topik yang sama tepat, kemudian semak Log Aktiviti.
• Mesej terlalu besar: Pilih lebih sedikit metrik, julat yang lebih pendek, atau pengumpulan masa yang lebih kasar.

Buka automasi dan pilih Lihat Log Aktiviti untuk menyemak jalanan. Amaran menandakan isu berpotensi seperti pengambilan data yang perlahan; ralat mengenal pasti langkah yang gagal. Untuk bantuan melaporkan isu, lihat Mendapatkan Bantuan.