Đồng bộ dữ liệu Apple Health với MQTT
Công bố dữ liệu sức khỏe tới broker MQTT.
Cập nhật lần cuối: 31 tháng 10, 2026
Trên trang này
Công bố xuất sức khỏe dưới dạng JSON tới một chủ đề trên broker MQTT của bạn.
Quan trọng — hạn chế tự động hóa: Thiết bị phải được mở khóa để đọc dữ liệu sức khỏe, và iOS không đảm bảo chạy nền theo tần suất bạn chọn. Xem Hạn chế tự động hóa trước khi dựa vào xuất tự động.
Mở tự động hóa
Mở Xuất → Tự động trên iPhone, hoặc Tự động hóa trong thanh bên iPad. Chọn Tự động hóa mới, hoặc mở tự động hóa hiện có để chỉnh sửa.
Tên, trạng thái và thông báo
Nhập tên nhận diện tự động hóa này. Đã bật cho phép chạy tự động; để tắt cho đến khi sẵn sàng.
Chọn mọi thông báo khi chạy bạn muốn:
- Thông báo khi cập nhật bộ nhớ đệm báo dữ liệu xuất đã được chuẩn bị.
- Thông báo khi chạy báo công bố thành công tới broker.
Cho phép thông báo khi được nhắc. Các thông báo này báo hoạt động; chúng không lập lịch chạy.
Thiết lập kết nối
- Chọn MQTT làm Loại tự động hóa.
- Nhập tên host hoặc địa chỉ IP của broker và cổng. Cổng mặc định là 1883.
- Nhập Chủ đề, ví dụ
health/metrics. - Đặt Client ID duy nhất cho mỗi tự động hóa và nhập tên người dùng cùng mật khẩu nếu broker yêu cầu.
Broker phải truy cập được từ thiết bị. Người đăng ký phải dùng đúng chủ đề, kể cả chữ hoa/thường. Tái sử dụng Client ID có thể khiến các kết nối broker thay thế lẫn nhau.
Cài đặt loại dữ liệu
Chọn một Loại dữ liệu cho tự động hóa này: Chỉ số sức khỏe, Buổi tập, Triệu chứng, ECG, Thông báo nhịp tim, Trạng thái tinh thần, Theo dõi chu kỳ, hoặc Thuốc. Trạng thái tinh thần cần iOS 18 trở lên; Thuốc cần iOS 26 trở lên và quyền truy cập thuốc riêng.
Chỉ số sức khỏe
Chọn Chỉ số sức khỏe, rồi mở Chọn chỉ số sức khỏe và chọn các phép đo bạn cần.
Để giới hạn số đo ở ứng dụng hoặc thiết bị cụ thể, mở Nguồn ưu tiên, chọn chỉ số và chọn nguồn của nó. Tất cả cho phép mọi nguồn chưa bị loại trừ. Dùng Nguồn bị loại trừ để bỏ qua một nguồn trên mọi chỉ số sức khỏe của tự động hóa này. Loại trừ được ưu tiên; nguồn chưa chọn không được thay thế khi nguồn ưu tiên không có dữ liệu. Chọn Lưu để áp dụng lựa chọn nguồn hoặc Hủy để bỏ.
Buổi tập
Chọn Buổi tập để xuất bản ghi buổi tập. Bao gồm dữ liệu tuyến đường thêm các điểm tuyến đường khả dụng vào dữ liệu buổi tập JSON. Không tạo tải lên GPX riêng.
Đối với Phiên bản 2, bật Bao gồm chỉ số buổi tập để thêm các số đo như nhịp tim, năng lượng hoạt động và bước. Chọn Phút hoặc Giây cho Nhóm thời gian chỉ số buổi tập; giây tạo chi tiết hơn và xuất lớn hơn. Phiên bản 1 luôn bao gồm chỉ số buổi tập.
Cài đặt xuất
MQTT chỉ công bố JSON. Thông điệp dùng QoS 0 cho công bố tiền cảnh và QoS 1 cho công bố nền. Thông điệp không được giữ lại (not retained).
Phiên bản xuất
Chọn Phiên bản 2 cho cấu trúc dữ liệu hiện tại. Dùng Phiên bản 1 khi quy trình hiện có phụ thuộc định dạng cũ hơn.
Phạm vi ngày
| Lựa chọn | Dữ liệu bao gồm |
|---|---|
| Mặc định | Ngày trước và hôm nay đến thời điểm chạy |
| Từ lần đồng bộ cuối | Từ lần đồng bộ trước đến thời điểm chạy |
| Hôm nay | Hôm nay đến thời điểm chạy |
| Hôm qua | Ngày đầy đủ trước đó |
| 7 ngày trước | Bảy ngày đầy đủ trước đó |
Tóm tắt dữ liệu và nhóm thời gian
Đối với JSON + Chỉ số sức khỏe, bật Tóm tắt dữ liệu để kết hợp số đo thành nhóm thời gian, hoặc tắt cho từng số đo khi khả dụng. Tóm tắt phụ thuộc chỉ số—ví dụ bước được cộng và số đo cân nặng được lấy trung bình. Xuất chỉ số sức khỏe CSV dùng dữ liệu đã tóm tắt.
Khi Nhóm thời gian khả dụng, chọn mức chi tiết cần giữ. Nhóm theo giờ hoặc ngày tạo ít hàng hơn nhóm phút hoặc giây. Lựa chọn khả dụng phụ thuộc phạm vi ngày và định dạng. Nhóm thời gian buổi tập được cấu hình riêng dưới Buổi tập.
Lịch nhắc
Nếu muốn được nhắc mở khóa và mở ứng dụng, bật Bật nhắc nhở. Chọn Hàng giờ, Mỗi ngày, hoặc Các ngày đã chọn, rồi đặt phút, giờ và ngày khi áp dụng. Cho phép quyền thông báo khi được nhắc; nếu bị từ chối, dùng Mở Cài đặt thông báo.
Nhắc không chạy tự động hóa và không xác nhận đồng bộ thành công. Chạm để mở tự động hóa, hoặc dùng Mở & Đồng bộ trên thông báo để yêu cầu chạy. Tự động hóa phải được bật; nhắc vẫn có thể xuất hiện sau lần chạy nền thành công. Thay đổi nhắc áp dụng khi bạn lưu.
Tần suất đồng bộ và lưu
Chọn một số và Phút, Giờ, Ngày, hoặc Tuần dưới Tần suất đồng bộ—ví dụ mỗi 15 phút. Đây là nhịp nền mong muốn, không phải lịch đảm bảo.
Thiết bị phải được mở khóa khi đọc dữ liệu sức khỏe. Bật Làm mới ứng dụng nền cho Health Auto Export và tắt Chế độ nguồn thấp cho các lần chạy tự động. iOS vẫn có thể trì hoãn chạy khi thiết bị không hoạt động hoặc tài nguyên hệ thống hạn chế.
Bật Đã bật khi sẵn sàng cho các lần chạy tự động, rồi chọn Cập nhật để lưu tự động hóa. Bạn có thể tải lên ngay phạm vi ngày đã chọn bằng các bước bên dưới.
Xuất dữ liệu lịch sử hoặc bị bỏ lỡ
Dùng Tải lên thủ công khi lần đầu thiết lập tự động hóa để xuất dữ liệu lịch sử, hoặc sau này để bù các ngày bị đồng bộ tự động bỏ lỡ. Bạn cũng có thể dùng để kiểm tra thiết lập.
- Kết nối một người đăng ký MQTT tới broker và đăng ký chủ đề đã cấu hình.
- Trong Health Auto Export, mở tự động hóa và chọn Tải lên thủ công dưới Xuất dữ liệu hiện có.
- Đặt ngày Bắt đầu và Kết thúc, rồi chọn Bắt đầu xuất.
- Kiểm tra JSON đã nhận và ngày của nó.
Payload tuân theo định dạng xuất JSON. Ví dụ:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Khắc phục sự cố
- Kết nối thất bại: Kiểm tra host, cổng, quyền truy cập mạng và yêu cầu kết nối broker.
- Xác thực thất bại: Kiểm tra thông tin đăng nhập và quyền công bố tới chủ đề.
- Không có thông điệp: Xác nhận người đăng ký dùng cùng broker và đúng chủ đề, rồi xem Nhật ký hoạt động.
- Thông điệp quá lớn: Chọn ít chỉ số hơn, phạm vi ngắn hơn, hoặc nhóm thời gian thô hơn.
Mở tự động hóa và chọn Xem nhật ký hoạt động để xem lại lần chạy. Cảnh báo đánh dấu vấn đề tiềm ẩn như truy xuất dữ liệu chậm; lỗi xác định các bước thất bại. Để được trợ giúp báo cáo vấn đề, xem Nhận trợ giúp.