โปรเจกเตอร์ของคุณ ใน Home Assistant และ Hubitat

• เผยแพร่สถานะ โปรเจกเตอร์ปรากฏเป็นเซนเซอร์ใน Home Assistant อุปกรณ์ใน Hubitat หรือ JSON payload บนWebhooksของคุณ พร้อมค่าที่อ่านได้เหมือนที่แอปแสดงให้คุณเห็น
• เผยแพร่ตัวควบคุม ทุกฉากที่คุณบันทึก รวมถึงเปิดปิด ทุกอินพุต ทุกโหมดสี และทุกหน่วยความจำเลนส์ จะกลายเป็นสิ่งที่ระบบอัตโนมัติหรือผู้ช่วยเสียงสั่งใช้ได้
• ทำงานโดยไม่ต้องมีเซิร์ฟเวอร์ เมื่อตั้งค่าสคริปต์แล้ว Home Assistant จะส่งคำสั่งตรงไปยังที่อยู่ IP ของโปรเจกเตอร์ โทรศัพท์ของคุณไม่จำเป็นต้องอยู่ในเครือข่าย และไม่มีอะไรผ่านบัญชีคลาวด์

สามทางเข้า ศูนย์กลางเดียว

การตั้งค่า › ระบบอัตโนมัติในบ้าน คือศูนย์กลาง เลือกแพลตฟอร์มที่คุณใช้ ไม่ว่าจะเป็น Home Assistant, Hubitat หรือWebhooks แล้วตั้งค่าที่นั่น คุณเชื่อมต่อได้มากกว่าหนึ่งแพลตฟอร์มพร้อมกัน แต่ละอันเป็นอิสระต่อกัน

1. เปิด การตั้งค่า › ระบบอัตโนมัติในบ้าน › Home Assistant
2. พิมพ์ที่อยู่ Home Assistantของคุณ (เช่น http://homeassistant.local:8123 หรือ IP ของมัน) แล้วแตะเข้าสู่ระบบ เป็นการเข้าสู่ระบบผ่านเบราว์เซอร์กับอินสแตนซ์ของคุณเอง ไม่ต้องวางโทเคน ใช้การล็อกอิน Home Assistant ปกติของคุณ รวมถึงการยืนยันตัวตนสองขั้นตอน
3. แอปเผยแพร่โปรเจกเตอร์เป็นเซนเซอร์ โดยมีเอนทิตีอย่าง sensor.projector_pilot_epson_qb1000b_qb1000w ที่มีสถานะเปิดปิด อินพุต โหมดสี ตัวเลขภาพ และชั่วโมงหลอดภาพ
4. เปิดส่งสถานะของโปรเจกเตอร์ เพื่อให้ค่าเหล่านั้นอัปเดตใน Home Assistant ทุกครั้งที่เปลี่ยนขณะเปิดแอปอยู่ และเปิดซิงค์ตัวควบคุมขั้นสูง เพื่อเผยแพร่สคริปต์สำหรับโหมดภาพ อินพุต หน่วยความจำเลนส์ และเปิดปิด
5. วางบล็อก shell_command หนึ่งบล็อก (ด้านล่าง) ลงใน configuration.yaml ของคุณ รีสตาร์ท Home Assistant แล้วแตะซิงค์กับ HA

บล็อก shell_command

นี่คือเคล็ดลับทั้งหมดของการทำงานโดยไม่ต้องมีเซิร์ฟเวอร์ แอปเขียนหนึ่งคำสั่งที่ Home Assistant รันเพื่อคุยกับ Web Control ของโปรเจกเตอร์ และทุกสคริปต์ที่ซิงค์จะเรียกคำสั่งนั้นด้วยคำกริยาที่ต่างกัน แตะคัดลอกบล็อกในแอปแล้ววางลงใน configuration.yaml ตัวอย่างด้านล่างเป็นเพียงภาพประกอบ แอปจะกรอกที่อยู่และชื่อคำสั่งของโปรเจกเตอร์คุณเองให้:

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

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

ทดสอบการเชื่อมต่อ ซิงค์ และการล้างข้อมูล

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

• เชื่อมต่อกับ Home Assistant แล้ว - เข้าสู่ระบบแล้วและตอบสนอง หาก Home Assistant ไม่ตอบสนอง แถวนี้จะบอกให้ตรวจสอบที่อยู่และว่าโทรศัพท์ของคุณอยู่ในเครือข่ายเดียวกัน
• เพิ่มโปรเจกเตอร์ใน Home Assistant แล้ว - Home Assistant มีโปรเจกเตอร์นี้อยู่แล้วหรือไม่ หากยังไม่มี แถวนี้จะพาคุณไปเพิ่มการเชื่อมต่อ PJLink และขั้นตอนเพิ่มการเชื่อมต่อจะแสดงโฮสต์และพอร์ต PJLink ที่ Home Assistant ขอ
• ลงทะเบียนเซนเซอร์ค่าที่อ่านแล้ว - เซนเซอร์ที่เก็บค่าที่อ่านได้ของโปรเจกเตอร์ จะลงทะเบียนเมื่อแอปอ่านโปรเจกเตอร์ครั้งแรก และแถวนี้มีปุ่มลงทะเบียนเลยหรือเปิดเมื่อมีบางอย่างขัดขวาง
• สิ่งที่ Home Assistant ของคุณมี - HACS (ร้านค้าชุมชน) การเชื่อมต่อ Epson Projector Link การเชื่อมต่อ PJLink และคำสั่ง Projector Pilot ใน configuration.yaml แต่ละรายการแสดงว่าพบ ไม่ได้ติดตั้ง หรือไม่สามารถระบุได้ พร้อมปุ่มวิธีติดตั้งและเปิดใน HACS ในจุดที่ช่วยได้

• การ์ดในตัวมาก่อน หากคุณไม่มีการ์ดจากชุมชน การซิงค์จะสร้างแดชบอร์ดด้วยการ์ดในตัวของ Home Assistant และบอกคุณเมื่อเสร็จ ใช้งานได้ทันทีโดยไม่ต้องตั้งค่าเพิ่ม
• อัปเกรดเมื่อติดตั้งการ์ด HACS แอปตรวจสอบว่าติดตั้งการ์ดจากชุมชนตัวไหนบ้าง (Mushroom, button-card, card-mod, apexcharts-card) และอัปเกรดแต่ละการ์ดเป็นแบบที่หรูกว่าเมื่อคุณมี คู่มือแดชบอร์ดที่สร้างเองไปได้ไกลกว่านั้นหากคุณต้องการลุคกระจกสีเขียวเต็มรูปแบบ
• ฉากและตัวควบคุมต้องวางหนึ่งครั้ง หาก Home Assistant ยังไม่มีคำสั่งสำหรับส่งไปยังโปรเจกเตอร์ แดชบอร์ดก็ยังสร้างได้พร้อมค่าสด และการ์ดตั้งค่าให้เสร็จจะพาคุณทำตามขั้นตอน: แตะคัดลอกบล็อก วางลงใน configuration.yaml รีสตาร์ท Home Assistant แล้วแตะซิงค์อีกครั้ง
• ไม่ได้ติดตั้งอะไรเลย? วางเอง หากไม่ได้ติดตั้งอะไรใน Home Assistant คุณยังคัดลอกทุกอย่างจากแอปแล้ววางเองได้
• แจ้งเตือนเมื่อมีรหัสผ่าน บล็อกคำสั่งที่คุณวางจะบอกเมื่อมีรหัสผ่านโปรเจกเตอร์อยู่ในนั้น คุณจึงรู้ก่อนแชร์หรือเก็บบันทึก

• เป็นอีกบล็อกหนึ่งที่เป็นทางเลือก: วางไว้ท้าย configuration.yaml (หรือเพิ่มเฉพาะบรรทัดของมันใต้ส่วน template: ที่มีอยู่) แล้วรีสตาร์ท Home Assistant แอปมีปุ่มตรวจสอบว่ามีอยู่ที่บอกคุณว่า Home Assistant มีบล็อกนี้หรือไม่
• การปิดเครื่องจะส่งถึง Home Assistant เป็นปิด แดชบอร์ดและระบบอัตโนมัติของคุณจึงเห็นว่าโปรเจกเตอร์ปิดอยู่เมื่อมันปิดอยู่จริง

• ระบบอัตโนมัติสั่งรันได้ “ตอนพระอาทิตย์ตก ถ้าTVเปิด ให้รัน Movie Night” เป็นระบบอัตโนมัติ Home Assistant ธรรมดาเมื่อฉากเป็นสคริปต์แล้ว
• ผู้ช่วยเสียงสั่งรันได้ เปิดเผยสคริปต์ให้ผู้ช่วยของคุณ แล้วคำสั่ง “เปิด Movie Night” จะตั้งอินพุต โหมดภาพ และหน่วยความจำเลนส์พร้อมกัน
• แสดงเฉพาะตัวควบคุมจริงของคุณ แอปเขียนสคริปต์สำหรับแต่ละอินพุต โหมดสี และหน่วยความจำเลนส์ที่โปรเจกเตอร์รายงาน ไม่ใช่รายการทั่วไปที่เดาเอา
• การลบการซิงค์จะลบเฉพาะสิ่งที่แอปเขียน ปิดการซิงค์ หรือใช้ลบสคริปต์ที่ไม่มีเจ้าของ (ซึ่งแสดงรายการและถามก่อน) แล้ว Projector Pilot จะลบสคริปต์ที่มันสร้างและไม่แตะอย่างอื่น

แดชบอร์ด

ซิงค์สร้างแดชบอร์ดให้คุณ

คุณไม่ต้องสร้างมุมมอง Lovelace ด้วยมือ และไม่ต้องวางมันอีกต่อไป เมื่อคุณแตะซิงค์กับ HA แอปจะสร้างแดชบอร์ด Projector Pilot ที่สมบูรณ์ใน Home Assistant โดยตรงผ่าน API ของมันเอง ประกอบด้วยสถานะสดของโปรเจกเตอร์และปุ่มสำหรับทุกฉากและตัวควบคุมที่ซิงค์ไว้ แดชบอร์ดจะปรากฏในแถบด้านข้างของ Home Assistant ในชื่อ Projector Pilot เปิดดูก็เสร็จแล้ว

1. เข้าสู่ระบบ Home Assistant ในแอป
2. วางบล็อกคัดลอกของแอปลงใน configuration.yaml หนึ่งครั้งแล้วรีสตาร์ท Home Assistant (ขั้นตอนที่ต้องทำเองเพียงอย่างเดียว เพราะ Home Assistant ไม่อนุญาตให้แอปเพิ่มคำสั่งนั้นจากระยะไกล)
3. แตะซิงค์กับ HA แดชบอร์ดจะถูกสร้างให้และปรากฏในแถบด้านข้างในชื่อ Projector Pilot

ไม่ว่าจะถูกสร้างให้หรือคุณวางเอง แดชบอร์ดก็เหมือนกัน คือการ์ดสถานะพร้อมปุ่มสำหรับแต่ละตัวควบคุม (ตัวอย่างโค้ดประกอบ):

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

เป็นเพียงตัวอย่าง แดชบอร์ดของคุณมีเอนทิตีจริงของโปรเจกเตอร์และฉากของคุณเอง

1. ใน Hubitat เปิดใช้แอป Maker API จด URL สำหรับเข้าถึงและโทเคน และเลือกอุปกรณ์ที่ต้องการเปิดเผย
2. ใน Projector Pilot เปิด การตั้งค่า › ระบบอัตโนมัติในบ้าน › Hubitat แล้วป้อนรายละเอียด Maker API ของฮับคุณ
3. เลือกอุปกรณ์ที่แทนโปรเจกเตอร์ แอปจะแนะนำตัวที่น่าจะใช่ เลือกตัวนั้นหรือเลือกอุปกรณ์ของคุณเอง
4. แอปมิเรอร์สถานะเปิดปิด ปิดเสียง และอินพุตไปยังอุปกรณ์นั้น โดยส่งเฉพาะคำสั่งที่อุปกรณ์รับได้
5. สร้างกฎRule Machineกับอุปกรณ์นั้นเหมือนอุปกรณ์อื่นๆ โดยสถานะของโปรเจกเตอร์เป็นตัวขับเคลื่อนกฎ

1. เปิด การตั้งค่า › ระบบอัตโนมัติในบ้าน › Webhooks
2. ป้อน URL ที่จะโพสต์ไป Webhooks Home Assistant หน้าตาประมาณ http://homeassistant.local:8123/api/webhook/your-id
3. เลือกเหตุการณ์ที่จะเรียกWebhooks: เปิดเครื่อง ปิดเครื่อง เปลี่ยนอินพุต เรียกฉาก และจะกรองเฉพาะอินพุตหรือฉากใดก็ได้
4. ตั้งpayload แบบกำหนดเองได้หากบริการปลายทางต้องการรูปแบบเฉพาะ มิฉะนั้นแอปจะส่ง JSON เริ่มต้น
5. บันทึก จากนั้นแอปจะโพสต์ทุกครั้งที่มีเหตุการณ์ที่ตรงกัน

payload เริ่มต้นเป็น JSON ธรรมดา ประกอบด้วยเหตุการณ์ โปรเจกเตอร์ และค่าที่เปลี่ยน:

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

ตัวอย่าง payload เหตุการณ์เปลี่ยนอินพุตหรือเปิดปิดจะมีช่องที่เกี่ยวข้องกับมัน