Sinkronkan data Apple Health ke MQTT

Publikasikan ekspor kesehatan sebagai JSON ke topik di broker MQTT Anda.

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 broker.

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

Menyiapkan koneksi

1. Pilih MQTT sebagai Jenis Otomatisasi.
2. Masukkan nama host atau alamat IP broker Anda dan port. Port default adalah 1883.
3. Masukkan Topic, misalnya health/metrics.
4. Atur ID Klien unik untuk setiap otomatisasi dan masukkan nama pengguna serta kata sandi jika diperlukan broker.

Broker harus dapat dijangkau dari perangkat Anda. Pelanggan harus menggunakan topik yang tepat, termasuk kapitalisasi. Menggunakan ulang client ID dapat menyebabkan koneksi broker saling menggantikan.

Pengaturan Jenis Data

Pilih satu Jenis Data untuk otomatisasi ini: Metrik Kesehatan, Latihan, Gejala, ECG, Notifikasi Denyut Jantung, Keadaan Pikiran, Pelacakan Siklus, atau Obat. Keadaan Pikiran memerlukan iOS 18 atau lebih baru; Obat memerlukan iOS 26 atau lebih baru dan akses obat terpisah.

Metrik kesehatan

Pilih Metrik Kesehatan, lalu buka Pilih Metrik Kesehatan dan pilih pengukuran yang Anda butuhkan.

Untuk membatasi pembacaan ke aplikasi atau perangkat tertentu, buka Sumber yang Disukai, pilih metrik, dan pilih sumbernya. Semua mengizinkan setiap sumber yang belum dikecualikan. Gunakan Sumber yang Dikecualikan untuk mengabaikan sumber di semua metrik kesehatan otomatisasi ini. Pengecualian didahulukan; sumber yang tidak dipilih tidak digantikan saat sumber yang diutamakan tidak memiliki data. Pilih Simpan untuk menerapkan pilihan sumber atau Batal untuk membuangnya.

Latihan

Pilih Latihan untuk mengekspor catatan latihan. Sertakan Data Rute menambahkan titik rute yang tersedia ke data latihan JSON. Ini tidak membuat unggahan GPX terpisah.

Untuk Versi 2, aktifkan Sertakan Metrik Latihan untuk menambahkan pembacaan seperti denyut jantung, energi aktif, dan langkah. Pilih Menit atau Detik untuk Pengelompokan Waktu metrik latihan; detik menghasilkan lebih banyak detail dan ekspor yang lebih besar. Versi 1 selalu menyertakan metrik latihan.

Pengaturan Ekspor

MQTT hanya memublikasikan JSON. Pesan menggunakan QoS 0 untuk publikasi latar depan dan QoS 1 untuk publikasi latar belakang. Pesan tidak dipertahankan.

Versi Ekspor

Pilih Versi 2 untuk struktur data saat ini. Gunakan Versi 1 saat alur kerja yang ada bergantung pada format yang lebih lama.

Rentang Tanggal

Pilihan	Data yang disertakan
Bawaan	Hari sebelumnya dan hari ini hingga waktu proses
Sejak Sinkronisasi Terakhir	Sejak sinkronisasi sebelumnya hingga waktu proses
Hari Ini	Hari ini hingga waktu proses
Kemarin	Hari penuh sebelumnya
7 Hari Sebelumnya	Tujuh hari penuh sebelumnya

Ringkas Data dan Pengelompokan Waktu

Untuk JSON + Metrik Kesehatan, aktifkan Ringkas Data untuk menggabungkan pembacaan ke dalam kelompok waktu, atau matikan untuk pembacaan individual jika tersedia. Ringkasan bergantung pada metrik—misalnya, langkah dijumlahkan dan pembacaan berat dirata-ratakan. Ekspor metrik kesehatan CSV menggunakan data yang diringkas.

Saat Pengelompokan Waktu tersedia, pilih seberapa banyak detail yang disimpan. Kelompok per jam atau harian menghasilkan lebih sedikit baris daripada kelompok menit atau detik. Pilihan yang tersedia bergantung pada rentang tanggal dan format. Pengelompokan waktu latihan dikonfigurasi secara terpisah di bawah Latihan.

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, Jam, Hari, atau Minggu di bawah Frekuensi Sinkronisasi—misalnya, setiap 15 menit. 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.

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. Hubungkan pelanggan MQTT ke broker Anda dan berlangganan ke topik yang dikonfigurasi.
2. Di Health Auto Export, buka otomatisasi dan pilih Unggah Manual di bawah Ekspor Data yang Ada.
3. Atur tanggal Mulai dan Akhir, lalu pilih Mulai Ekspor.
4. Periksa JSON yang diterima dan tanggalnya.

Muatan mengikuti format ekspor JSON. Misalnya:

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

Pemecahan masalah

• Koneksi gagal: Periksa host, port, akses jaringan, dan persyaratan koneksi broker.
• Autentikasi gagal: Periksa kredensial dan izin untuk memublikasikan ke topik.
• Tidak ada pesan: Konfirmasikan pelanggan menggunakan broker dan topik yang sama persis, lalu tinjau Log Aktivitas.
• Pesan terlalu besar: Pilih lebih sedikit metrik, rentang yang lebih pendek, atau pengelompokan waktu yang lebih kasar.

Buka otomatisasi dan pilih Lihat Log Aktivitas untuk meninjau proses. Peringatan menandai potensi masalah seperti pengambilan data yang lambat; kesalahan mengidentifikasi langkah yang gagal. Untuk bantuan melaporkan masalah, lihat Mendapatkan Bantuan.