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

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

ภาพรวม

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

กรณีใช้งาน:

• แสดงตัวชี้วัดสุขภาพบนแดชบอร์ด Home Assistant
• สร้างระบบอัตโนมัติจากข้อมูลสุขภาพ
• เชื่อมข้อมูลสุขภาพกับอุปกรณ์บ้านอัจฉริยะอื่น
• ติดตามแนวโน้มสุขภาพใน Home Assistant

คุณสมบัติหลัก:

• สร้างสถานะเซนเซอร์อัตโนมัติ
• รองรับเฉพาะ JSON (ปรับให้เหมาะกับ Home Assistant)
• เฉพาะประเภทตัวชี้วัดสุขภาพ
• ตั้งค่า URL ง่าย

ข้อจำกัด

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

• การประมวลผลในพื้นหลัง: iOS จำกัดการประมวลผลในพื้นหลังเพื่อประหยัดแบตเตอรี่ ระบบอัตโนมัติอาศัยการรีเฟรชแอปในพื้นหลัง (Background App Refresh) และอาจไม่รันทันทีหาก:

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

• รองรับเฉพาะประเภทตัวชี้วัดสุขภาพ

• รองรับเฉพาะ JSON (เปลี่ยนไม่ได้)

ข้อกำหนดเบื้องต้น

• อินสแตนซ์ Home Assistant รันและเข้าถึงได้บนเครือข่ายของคุณ
• โทเค็นการเข้าถึง API ของ Home Assistant (Long-Lived Access Token)
• เชื่อมต่อเครือข่ายไปยังอินสแตนซ์ Home Assistant ของคุณ
• เวอร์ชัน Home Assistant ที่รองรับ REST API

การกำหนดค่า

ไปที่หน้าจอการส่งออกอัตโนมัติจากเมนูหลัก แล้วแตะ "ระบบอัตโนมัติใหม่" และเลือก "Home Assistant" เป็นประเภท

ชื่อระบบอัตโนมัติ

ตั้งชื่อที่อธิบายได้สำหรับระบบอัตโนมัติของคุณ ชื่อนี้จะถูกใช้สร้าง entity ID ของเซนเซอร์ใน Home Assistant

หมายเหตุ: ชื่อระบบอัตโนมัติจะถูกแปลงเป็นตัวพิมพ์เล็กและตัดช่องว่างเพื่อสร้าง entity ID เช่น "My Health Data" กลายเป็น hae.myhealthdata

การแจ้งเตือน

กำหนดเมื่อต้องการรับการแจ้งเตือน:

• Notify on Cache Update — แจ้งเมื่ออัปเดตข้อมูลแคช
• Notify When Run — แจ้งทุกครั้งที่ระบบอัตโนมัติทำงาน

URL ของ Home Assistant

ใส่ URL ฐานของอินสแตนซ์ Home Assistant ของคุณ ควรรวมโปรโตคอลและพอร์ตหากไม่ใช่ค่าเริ่มต้น

ตัวอย่าง URL:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

หมายเหตุ: URL ต้องเข้าถึงได้จากอุปกรณ์ของคุณ หากใช้ HTTPS ให้แน่ใจว่าใบรับรองถูกต้องหรือเพิ่มข้อยกเว้น

ปลายทางที่สร้างอัตโนมัติ

แอปสร้างปลายทาง API เต็มจากชื่อระบบอัตโนมัติของคุณโดยอัตโนมัติ:

{your_url}/api/states/hae.{automation_name}

ตัวอย่างเช่น หาก URL ของคุณคือ http://homeassistant.local:8123 และชื่อระบบอัตโนมัติคือ "Health Metrics" ปลายทางจะเป็น:

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

ปลายทางนี้แสดงใต้ช่อง URL เพื่ออ้างอิง

หมดเวลาคำขอ

เลือกช่วงหมดเวลาสำหรับคำขอ HTTP ไปยัง Home Assistant

ตัวเลือกหมดเวลาที่มี:

• 60 วินาที — ค่าเริ่มต้น เหมาะกับอินสแตนซ์ Home Assistant ส่วนใหญ่
• 300 วินาที (5 นาที) — สำหรับอินสแตนซ์ที่ประมวลผลช้า
• 1800 วินาที (30 นาที) — สำหรับการประมวลผลที่ช้ามาก
• 3600 วินาที (1 ชั่วโมง) — ค่าหมดเวลาสูงสุดที่แนะนำ

HTTP Headers

เพิ่มส่วนหัวการยืนยันตัวตนสำหรับการเข้าถึง API ของ Home Assistant คุณต้องเพิ่มส่วนหัว Authorization พร้อม Long-Lived Access Token

ส่วนหัวที่จำเป็น:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

วิธีรับ Long-Lived Access Token:

1. เปิด Home Assistant
2. ไปที่โปรไฟล์ (คลิกชื่อของคุณที่มุมล่างซ้าย)
3. เลื่อนลงไปที่ "Long-Lived Access Tokens"
4. คลิก "Create Token"
5. ตั้งชื่อ (เช่น "Health Auto Export")
6. คัดลอกโทเค็นแล้ววางในช่องค่าของส่วนหัว

ส่วนหัวเสริม:
คุณเพิ่มส่วนหัวอื่นได้หากจำเป็นสำหรับการตั้งค่า Home Assistant ของคุณ

วิธีเพิ่มส่วนหัว:

1. แตะ "Add Headers"
2. ใส่คีย์ของส่วนหัวในช่องซ้าย
3. ใส่ค่าของส่วนหัวในช่องขวา
4. ทำซ้ำสำหรับส่วนหัวเพิ่มเติม

สำคัญ: แต่ละคีย์ของส่วนหัวต้องมีค่าที่สอดคล้องกัน ส่วนหัวว่างจะถูกละเว้น

การตั้งค่าประเภทข้อมูล

ประเภทข้อมูล

หมายเหตุ: ระบบอัตโนมัติ Home Assistant รองรับเฉพาะประเภทตัวชี้วัดสุขภาพเท่านั้น การตั้งค่านี้เปลี่ยนไม่ได้และถูกตั้งเป็นตัวชี้วัดสุขภาพโดยอัตโนมัติ

การตั้งค่าตัวชี้วัดสุขภาพ

เลือกตัวชี้วัดสุขภาพ — เลือกตัวชี้วัดเฉพาะที่จะรวม คุณเลือกได้ทั้งตัวชี้วัดที่มีทั้งหมดหรือเฉพาะบางตัว

เคล็ดลับ: เลือกเฉพาะตัวชี้วัดที่คุณต้องการช่วยให้ประมวลผลเร็วขึ้นและลดขนาดข้อมูลที่ส่งไปยัง Home Assistant

แหล่งข้อมูลที่ต้องการ — กำหนดว่าเมื่อมีหลายแหล่งให้ตัวชี้วัดเดียวกัน แหล่งใดมีความสำคัญกว่า

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

รูปแบบการส่งออก

หมายเหตุ: ระบบอัตโนมัติ Home Assistant รองรับเฉพาะรูปแบบ JSON เท่านั้น การตั้งค่านี้เปลี่ยนไม่ได้และถูกตั้งเป็น JSON โดยอัตโนมัติ

เวอร์ชันการส่งออก

หมายเหตุ: ไม่มีตัวเลือกเวอร์ชันการส่งออกสำหรับระบบอัตโนมัติ Home Assistant เนื่องจากรูปแบบถูกปรับให้เหมาะกับ state API ของ Home Assistant โดยเฉพาะ

ช่วงวันที่

เลือกว่าควรส่งออกข้อมูลเมื่อใด:

• Default — ซิงก์ข้อมูลของวันก่อนหน้าเต็มวัน รวมถึงข้อมูลจนถึงวันที่และเวลาปัจจุบัน
• Today — ซิงก์ข้อมูลทั้งหมดของวันปัจจุบันจนถึงเวลาปัจจุบัน
• Yesterday — ซิงก์ข้อมูลทั้งหมดของวันก่อนหน้าเต็มวัน

หมายเหตุ: ระบบอัตโนมัติ Home Assistant ไม่รองรับตัวเลือก "Real Time", "Since Last Sync" หรือ "Previous 7 Days"

สรุปข้อมูล

เปิดหรือปิดสรุปข้อมูลสำหรับตัวชี้วัดสุขภาพ

• เปิด — ให้ข้อมูลสรุปแบบรวม (ค่าเริ่มต้น)
• ปิด — ให้ข้อมูลแยกจุดเมื่อทำได้

หมายเหตุ: การตั้งค่านี้ใช้กับประเภทตัวชี้วัดสุขภาพเท่านั้น

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

เมื่อเปิดสรุปข้อมูล ให้เลือกวิธีรวมข้อมูล:

• Default — ไม่รวม จุดข้อมูลดิบ
• Days — จัดกลุ่มตามวัน (แนะนำ)

ความถี่การซิงก์

กำหนดความบ่อยที่ระบบอัตโนมัติควรซิงก์ข้อมูลไปยัง Home Assistant:

เลือกตัวเลขและช่วงเวลา

การทดสอบและการตรวจสอบ

ทดสอบด้วยตนเอง

1. แตะ "การส่งออกด้วยตนเอง" ในหน้าจอตั้งค่าระบบอัตโนมัติ
2. เลือกช่วงวันที่
3. แตะ "ส่งออก" เพื่อส่งคำขอทดสอบ
4. ตรวจสอบใน Home Assistant ว่าสถานะเซนเซอร์ถูกสร้างหรืออัปเดต

ตรวจสอบใน Home Assistant

1. เปิด Home Assistant
2. ไปที่ Developer Tools > States
3. ค้นหา hae.{your_automation_name} (ตัวพิมพ์เล็ก ไม่มีช่องว่าง)
4. ตรวจสอบว่าสถานะเซนเซอร์แสดงข้อมูลสุขภาพของคุณ
5. ดูเวลา "Last Updated" เพื่อยืนยันว่ามีการซิงก์ล่าสุด

ดูบันทึกกิจกรรม

1. แตะ "View Activity Logs" ในหน้าจอตั้งค่าระบบอัตโนมัติ
2. ทบทวนการรันล่าสุดของระบบอัตโนมัติ
3. ตรวจสอบข้อผิดพลาดหรือคำเตือน
4. ยืนยันเวลาคำขอและสถานะการตอบกลับ

ตรวจสอบบันทึก Home Assistant

หากข้อมูลไม่ปรากฏใน Home Assistant:

1. เปิด Home Assistant
2. ไปที่ Settings > System > Logs
3. หาข้อผิดพลาดที่เกี่ยวกับ REST API หรือสถานะเซนเซอร์
4. ตรวจสอบข้อผิดพลาดการยืนยันตัวตนหรือรูปแบบข้อมูลไม่ถูกต้อง

การแก้ปัญหา

ปัญหาที่พบบ่อย

ข้อผิดพลาดการยืนยันตัวตน

• ตรวจสอบว่า Long-Lived Access Token ถูกต้อง
• ให้แน่ใจว่าส่วนหัว Authorization อยู่ในรูปแบบ: Bearer YOUR_TOKEN
• ตรวจสอบว่าโทเค็นยังไม่หมดอายุหรือถูกเพิกถอน
• ตรวจสอบว่าโทเค็นมีสิทธิ์ที่เหมาะสมใน Home Assistant

เซนเซอร์ไม่ปรากฏใน Home Assistant

• ตรวจสอบว่าชื่อระบบอัตโนมัติไม่มีอักขระพิเศษ
• ยืนยันรูปแบบ entity ID: hae.{automation_name} (ตัวพิมพ์เล็ก ไม่มีช่องว่าง)
• ดูบันทึก Home Assistant หาข้อผิดพลาด
• ให้แน่ใจว่าคำขอ API สำเร็จ (ตรวจสอบบันทึกกิจกรรม)

ข้อมูลไม่อัปเดต

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

หมดเวลาการเชื่อมต่อ

• ตรวจสอบว่า Home Assistant รันและเข้าถึงได้
• ตรวจสอบการเชื่อมต่อเครือข่าย
• เพิ่มการตั้งค่าหมดเวลาคำขอหาก Home Assistant ตอบสนองช้า
• ตรวจสอบว่า URL และพอร์ตถูกต้อง

ข้อความแสดงข้อผิดพลาด

แอปจะแสดงข้อความแสดงข้อผิดพลาดหาก:

• URL ไม่ถูกต้องหรือเข้าถึงไม่ได้
• การยืนยันตัวตนล้มเหลว (ตรวจสอบส่วนหัว Authorization)
• Home Assistant คืนสถานะข้อผิดพลาด
• ไม่มีการเชื่อมต่อเครือข่าย

ดูบันทึกกิจกรรมสำหรับรายละเอียดข้อผิดพลาด รวมถึงรหัสสถานะ HTTP และข้อความจาก Home Assistant

เคล็ดลับการเชื่อมต่อ Home Assistant

ใช้ข้อมูลสุขภาพในระบบอัตโนมัติ

เมื่อซิงก์ข้อมูลสุขภาพไปยัง Home Assistant แล้ว คุณนำไปใช้ในระบบอัตโนมัติได้:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

สร้างแดชบอร์ด

เพิ่มตัวชี้วัดสุขภาพในแดชบอร์ด Home Assistant ของคุณ:

1. ไปที่แดชบอร์ดของคุณ
2. เพิ่มการ์ดใหม่
3. เลือกประเภทการ์ด "Entities" หรือ "Gauge"
4. เพิ่มเอนทิตีเซนเซอร์ hae.{your_automation_name}

โครงสร้างสถานะเซนเซอร์

สถานะเซนเซอร์ใน Home Assistant ประกอบด้วย:

• state: ค่าปัจจุบันหรือสถานะ
• attributes: ข้อมูลเพิ่มเติม รวมถึง:
  • ข้อมูลเวลา (timestamp)
  • โครงสร้างข้อมูลที่ตรงกับรูปแบบ JSON ที่ส่งออก
  • ข้อมูลหน่วยเมื่อมีใช้

เคล็ดลับและแนวทางปฏิบัติ

1. การซิงก์อัตโนมัติ:

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

2. การตั้งชื่อ:

   • หลีกเลี่ยงอักขระพิเศษที่อาจทำให้เกิดปัญหา

3. การเลือกข้อมูล:

   • เลือกเฉพาะตัวชี้วัดที่คุณต้องการ