Đồng bộ dữ liệu Apple Health với Home Assistant

Công bố chỉ số sức khỏe tới Home Assistant dưới dạng trạng thái thực thể riêng. Đích này chỉ hỗ trợ chỉ số sức khỏe.

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 Home Assistant.

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.

Kết nối Home Assistant

1. Chọn Home Assistant làm Loại tự động hóa.
2. Nhập URL cơ sở của phiên bản Home Assistant, ví dụ http://homeassistant.local:8123.
3. Tạo Long-Lived Access Token trong hồ sơ Home Assistant.
4. Dưới HTTP Headers, thêm Authorization với giá trị Bearer YOUR_LONG_LIVED_ACCESS_TOKEN.

Phiên bản Home Assistant phải truy cập được từ iPhone hoặc iPad. Đối với HTTPS, dùng chứng chỉ mà thiết bị tin cậy.

Cài đặt chỉ số sức khỏe

Mở Chọn chỉ số sức khỏe và chọn các số đo cần công bố.

Mở Nguồn ưu tiên để chọn nguồn cho từng chỉ số. Dùng Tất cả cho mọi nguồn không bị loại trừ, hoặc Nguồn bị loại trừ để bỏ qua một nguồn trên tự động hóa này. Loại trừ được ưu tiên, và nguồn chưa chọn không thay thế nguồn ưu tiên không có dữ liệu. Chọn Lưu để áp dụng lựa chọn hoặc Hủy để bỏ.

Cài đặt xuất

Home Assistant dùng định dạng trạng thái thực thể JSON riêng; không có lựa chọn định dạng tệp hoặc phiên bản xuất.

Phạm vi ngày

• Mặc định: Bao gồm ngày trước và hôm nay đến thời điểm chạy.
• Hôm nay: Bao gồm hôm nay đến thời điểm chạy.
• Hôm qua: Bao gồm ngày đầy đủ trước đó.

Nhóm thời gian

Chọn Mặc định để giữ số đo không nhóm hoặc Ngày để dùng tóm tắt hàng ngày. Home Assistant không có công tắc Tóm tắt dữ liệu.

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 hoặc Giờ dưới Tần suất đồng bộ. Đâ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.

Thực thể đã công bố

Mỗi chỉ số đã chọn có thể tạo một hoặc nhiều thực thể. Định danh bắt đầu bằng hae., theo sau là tên tự động hóa chữ thường không khoảng trắng, rồi chỉ số và mọi tên thành phần.

Ví dụ, tự động hóa tên Health Metrics có thể công bố bước tại:

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

Trạng thái là số đo mới nhất cho ngày đã chọn, kèm thuộc tính đơn vị đo. Các chỉ số như huyết áp và nhịp tim dùng thực thể thành phần riêng.

Khi một ngày không có dữ liệu, các tổng như bước và giờ đứng công bố 0. Các số đo khác, như cân nặng hoặc nhịp tim, không được cập nhật cho đến khi có dữ liệu, nên Home Assistant có thể tiếp tục hiện giá trị cuối cùng đã nhận. Sớm trong ngày, tổng có thể vẫn là 0 cho đến khi dữ liệu Watch tới iPhone.

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.

1. 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ó.
2. Đặt ngày Bắt đầu và Kết thúc, rồi chọn Bắt đầu xuất.
3. Trong Home Assistant, mở Công cụ dành cho nhà phát triển → Trạng thái và tìm tiền tố hae. của tự động hóa.
4. Kiểm tra giá trị thực thể và thời gian cập nhật.

Khắc phục sự cố

• Lỗi xác thực: Kiểm tra token và tiêu đề Authorization: Bearer ....
• Kết nối thất bại: Kiểm tra URL cơ sở, cổng, quyền truy cập mạng và tin cậy chứng chỉ.
• Một số số đo thiếu: Xem lại ngày đã chọn, nguồn và Nhật ký hoạt động. Một lần chạy có thể cập nhật một số thực thể trong khi số khác thất bại.

Mở tự động hóa và chọn Xem nhật ký hoạt động để kiểm tra các bước thất bại. Để được hỗ trợ, xem Nhận trợ giúp.