ซิงค์ข้อมูล Apple Health ไปยัง Home Assistant

เผยแพร่เมตริกสุขภาพไปยัง Home Assistant เป็นสถานะเอนทิตีแยก ปลายทางนี้รองรับเฉพาะเมตริกสุขภาพ

สำคัญ — ข้อจำกัดระบบอัตโนมัติ: อุปกรณ์ต้องปลดล็อกเพื่ออ่านข้อมูลสุขภาพ และ iOS ไม่รับประกันการรันพื้นหลังตามความถี่ที่เลือก ตรวจ ข้อจำกัดระบบอัตโนมัติ ก่อนพึ่งพาการส่งออกอัตโนมัติ

เปิดระบบอัตโนมัติ

เปิด ส่งออก → อัตโนมัติ บน iPhone หรือ ระบบอัตโนมัติ ในแถบด้านข้าง iPad เลือก ระบบอัตโนมัติใหม่ หรือเปิดระบบอัตโนมัติที่มีอยู่เพื่อแก้ไข

ชื่อ สถานะ และการแจ้งเตือน

ใส่ชื่อที่ระบุระบบอัตโนมัตินี้ เปิดใช้ อนุญาตการรันอัตโนมัติ ปล่อยปิดไว้จนกว่าจะพร้อม

เลือกการแจ้งเตือนเมื่อรันที่ต้องการ:

• แจ้งเมื่ออัปเดตแคช รายงานว่าข้อมูลส่งออกถูกเตรียมแล้ว
• แจ้งเมื่อรัน รายงานการเผยแพร่ไปยัง Home Assistant สำเร็จ

อนุญาตการแจ้งเตือนเมื่อถูกถาม การแจ้งเตือนเหล่านี้รายงานกิจกรรม ไม่จัดตารางการรัน

เชื่อมต่อ Home Assistant

1. เลือก Home Assistant เป็น ประเภทระบบอัตโนมัติ
2. ใส่ URL ฐานของอินสแตนซ์ Home Assistant เช่น http://homeassistant.local:8123
3. สร้าง Long-Lived Access Token ในโปรไฟล์ Home Assistant ของคุณ
4. ภายใต้ ส่วนหัว HTTP เพิ่ม Authorization ด้วยค่า Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

อินสแตนซ์ Home Assistant ต้องเข้าถึงได้จาก iPhone หรือ iPad สำหรับ HTTPS ใช้ใบรับรองที่อุปกรณ์เชื่อถือ

การตั้งค่าเมตริกสุขภาพ

เปิด เลือกเมตริกสุขภาพ และเลือกค่าที่จะเผยแพร่

เปิด แหล่งที่ต้องการ เพื่อเลือกแหล่งสำหรับแต่ละเมตริก ใช้ ทั้งหมด สำหรับแหล่งที่ไม่ได้ยกเว้นทั้งหมด หรือ แหล่งที่ยกเว้น เพื่อละเว้นแหล่งในระบบอัตโนมัตินี้ การยกเว้นมีลำดับความสำคัญสูงกว่า และแหล่งที่ไม่ได้เลือกไม่แทนที่แหล่งที่ต้องการเมื่อไม่มีข้อมูล เลือก บันทึก เพื่อใช้ตัวเลือก หรือ ยกเลิก เพื่อทิ้ง

การตั้งค่าการส่งออก

Home Assistant ใช้รูปแบบสถานะเอนทิตี JSON ของตัวเอง ไม่มีตัวเลือกรูปแบบไฟล์หรือเวอร์ชันการส่งออก

ช่วงวันที่

• ค่าเริ่มต้น: รวมวันก่อนหน้าและวันนี้จนถึงเวลาที่รัน
• วันนี้: รวมวันนี้จนถึงเวลาที่รัน
• เมื่อวาน: รวมวันก่อนหน้าทั้งวัน

การจัดกลุ่มเวลา

เลือก ค่าเริ่มต้น เพื่อเก็บค่าโดยไม่จัดกลุ่ม หรือ วัน เพื่อใช้สรุปรายวัน Home Assistant ไม่มีสวิตช์ สรุปข้อมูล

จัดตารางการเตือน

หากต้องการการเตือนให้ปลดล็อกและเปิดแอป เปิด เปิดใช้การเตือน เลือก ทุกชั่วโมง ทุกวัน หรือ วันที่เลือก แล้วตั้งนาที เวลา และวันตามที่ใช้ได้ อนุญาตการเข้าถึงการแจ้งเตือนเมื่อถูกถาม หากถูกปฏิเสธ ใช้ เปิดการตั้งค่าการแจ้งเตือน

การเตือนไม่รันระบบอัตโนมัติและไม่ยืนยันการซิงค์ที่สำเร็จ แตะเพื่อเปิดระบบอัตโนมัติ หรือใช้ เปิดและซิงค์ บนการแจ้งเตือนเพื่อขอการรัน ระบบอัตโนมัติต้องเปิดใช้ การเตือนอาจยังปรากฏหลังการรันพื้นหลังที่สำเร็จ การเปลี่ยนแปลงการเตือนมีผลเมื่อบันทึก

ความถี่การซิงค์และการบันทึก

เลือกตัวเลขและ นาที หรือ ชั่วโมง ภายใต้ ความถี่การซิงค์ นี่คือจังหวะพื้นหลังที่ต้องการ ไม่ใช่ตารางที่รับประกัน

อุปกรณ์ต้องปลดล็อกเมื่ออ่านข้อมูลสุขภาพ เปิดการรีเฟรชแอปพื้นหลังสำหรับ Health Auto Export และปิดโหมดพลังงานต่ำสำหรับการรันอัตโนมัติ iOS ยังอาจหน่วงการรันเมื่ออุปกรณ์ไม่ได้ใช้งานหรือทรัพยากรระบบจำกัด

เปิด เปิดใช้ เมื่อพร้อมสำหรับการรันอัตโนมัติ แล้วเลือก อัปเดต เพื่อบันทึกระบบอัตโนมัติ คุณสามารถอัปโหลดช่วงวันที่ที่เลือกได้ทันทีด้วยขั้นตอนด้านล่าง

เอนทิตีที่เผยแพร่

แต่ละเมตริกที่เลือกสามารถสร้างเอนทิตีหนึ่งรายการหรือมากกว่า ตัวระบุขึ้นต้นด้วย hae. ตามด้วยชื่อระบบอัตโนมัติตัวพิมพ์เล็กโดยไม่มีช่องว่าง แล้วตามด้วยเมตริกและชื่อคอมโพเนนต์ใดๆ

ตัวอย่างเช่น ระบบอัตโนมัติชื่อ Health Metrics สามารถเผยแพร่ก้าวไปยัง:

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

สถานะคือค่าล่าสุดสำหรับวันที่เลือก พร้อมแอตทริบิวต์หน่วยวัด เมตริก เช่น ความดันโลหิตและอัตราหัวใจใช้เอนทิตีคอมโพเนนต์แยก

เมื่อวันไม่มีข้อมูล ผลรวม เช่น ก้าวและชั่วโมงยืน เผยแพร่ 0 ค่าอื่น เช่น น้ำหนักหรืออัตราหัวใจ จะไม่อัปเดตจนกว่าจะมีข้อมูล ดังนั้น Home Assistant อาจยังแสดงค่าล่าสุดที่ได้รับ ในช่วงเช้าของวัน ผลรวมอาจยังเป็น 0 จนกว่าข้อมูล Watch จะถึง iPhone

ส่งออกข้อมูลย้อนหลังหรือที่พลาด

ใช้ อัปโหลดด้วยตนเอง เมื่อตั้งค่าระบบอัตโนมัติครั้งแรกเพื่อส่งออกข้อมูลย้อนหลัง หรือภายหลังเพื่อครอบคลุมวันที่ที่การซิงค์อัตโนมัติพลาด คุณยังสามารถใช้เพื่อตรวจสอบการตั้งค่า

1. เปิดระบบอัตโนมัติแล้วเลือก อัปโหลดด้วยตนเอง ภายใต้ ส่งออกข้อมูลที่มีอยู่
2. ตั้งวันที่ เริ่ม และ สิ้นสุด แล้วเลือก เริ่มส่งออก
3. ใน Home Assistant เปิด Developer Tools → States แล้วค้นหาคำนำหน้า hae. ของระบบอัตโนมัติ
4. ตรวจค่าเอนทิตีและเวลาอัปเดต

การแก้ปัญหา

• ข้อผิดพลาดการยืนยันตัวตน: ตรวจโทเค็นและส่วนหัว Authorization: Bearer ...
• การเชื่อมต่อล้มเหลว: ตรวจ URL ฐาน พอร์ต การเข้าถึงเครือข่าย และความเชื่อถือใบรับรอง
• บางค่าหาย: ตรวจวันที่ที่เลือก แหล่ง และบันทึกกิจกรรม การรันอาจอัปเดตบางเอนทิตีขณะที่เอนทิตีอื่นล้มเหลว

เปิดระบบอัตโนมัติแล้วเลือก ดูบันทึกกิจกรรม เพื่อตรวจขั้นตอนที่ล้มเหลว สำหรับการสนับสนุน ดู ขอความช่วยเหลือ