Máy chiếu của bạn, trong Home Assistant và Hubitat.

• Nó công bố trạng thái. Máy chiếu xuất hiện dưới dạng cảm biến Home Assistant, thiết bị Hubitat, hoặc payload JSON trên webhook của bạn, mang cùng các số liệu mà ứng dụng hiển thị cho bạn.
• Nó công bố các điều khiển. Mỗi Cảnh bạn lưu, cùng nguồn, từng nguồn vào, từng chế độ màu và từng bộ nhớ ống kính, trở thành thứ mà một tự động hóa hoặc trợ lý giọng nói có thể chạy.
• Nó chạy không cần máy chủ. Khi các script đã được thiết lập, Home Assistant gửi lệnh thẳng tới địa chỉ IP của máy chiếu. Điện thoại của bạn không cần ở trong mạng, và không có gì đi qua tài khoản đám mây.

Ba cách vào, một trung tâm

Cài đặt › Home Automation là trung tâm. Chọn nền tảng bạn dùng - Home Assistant, Hubitat hoặc Webhooks - và thiết lập tại đó. Bạn có thể kết nối nhiều hơn một cùng lúc; chúng độc lập với nhau.

1. Mở Cài đặt › Home Automation › Home Assistant.
2. Nhập địa chỉ Home Assistant của bạn (ví dụ http://homeassistant.local:8123 hoặc IP của nó), rồi chạm Đăng nhập. Đây là đăng nhập qua trình duyệt vào chính hệ thống của bạn - không có mã thông báo nào để dán. Dùng tài khoản Home Assistant thường ngày của bạn, kể cả xác thực hai yếu tố.
3. Ứng dụng công bố máy chiếu dưới dạng cảm biến, với một thực thể như sensor.projector_pilot_epson_qb1000b_qb1000w, mang theo nguồn, nguồn vào, chế độ màu, các thông số hình ảnh và số giờ bóng đèn.
4. Bật Gửi trạng thái máy chiếu để các số liệu đó cập nhật trong Home Assistant mỗi khi thay đổi trong lúc ứng dụng đang mở, và bật Sync Advanced Controls để công bố script cho các chế độ hình ảnh, nguồn vào, bộ nhớ ống kính và nguồn.
5. Dán khối shell_command (bên dưới) vào configuration.yaml của bạn, khởi động lại Home Assistant, rồi chạm Sync With HA.

Khối shell_command

Đây là toàn bộ mẹo không cần máy chủ. Ứng dụng ghi một lệnh để Home Assistant chạy nhằm giao tiếp với Web Control của máy chiếu, và mọi script nó đồng bộ đều gọi lệnh đó với một động từ khác nhau. Chạm Copy block trong ứng dụng và dán vào configuration.yaml. Ví dụ bên dưới chỉ mang tính minh họa - ứng dụng sẽ điền địa chỉ và tên lệnh riêng của máy chiếu bạn:

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 }}"

Chỉ là ví dụ. Ứng dụng tạo khối của bạn với IP thật của máy chiếu và một tên dẫn xuất từ số sê-ri.

Kiểm tra kết nối, Sync và dọn dẹp

• Kiểm tra kết nối xác nhận ứng dụng có thể kết nối tới Home Assistant của bạn và shell_command đã dán thực sự có mặt, để bạn tìm ra lỗi gõ trước khi xây dựng bất cứ thứ gì dựa trên nó.
• Sync With HA ghi hoặc cập nhật các script cho Cảnh và điều khiển của bạn, đồng thời dựng sẵn một bảng điều khiển Projector Pilot thẳng vào Home Assistant. Chạy lại bất cứ lúc nào bạn thêm một Cảnh hoặc thay đổi một điều khiển - nó cập nhật tại chỗ thay vì chất đống bản trùng lặp.
• Remove orphaned scripts tìm các script do ứng dụng ghi mà không còn Cảnh hoặc điều khiển tương ứng - ví dụ sau khi bạn xóa một Cảnh - liệt kê chính xác những script sẽ xóa và hỏi trước. Không có gì bị xóa cho đến khi bạn xác nhận. Nó chỉ chạm tới các script do Projector Pilot tạo; không có gì khác trong Home Assistant của bạn bị ảnh hưởng, và nếu Home Assistant không liệt kê được các script của nó, sẽ không có gì bị xóa.

• Đã kết nối với Home Assistant - đã đăng nhập và đang phản hồi. Nếu Home Assistant không phản hồi, hàng này nhắc bạn kiểm tra địa chỉ và điện thoại có cùng mạng không.
• Máy chiếu đã được thêm vào Home Assistant - Home Assistant đã có máy chiếu này chưa. Nếu chưa, hàng này dẫn bạn đến thêm tích hợp PJLink, và bước thêm tích hợp hiển thị host và cổng PJLink mà Home Assistant hỏi.
• Đã đăng ký cảm biến số liệu - cảm biến mang các số liệu của máy chiếu bạn. Nó được đăng ký lần đầu khi ứng dụng đọc máy chiếu, và hàng này đưa ra Đăng ký ngay hoặc Bật khi có thứ gì đó đang ngăn cản.
• Home Assistant của bạn có gì - HACS (cửa hàng cộng đồng), tích hợp Epson Projector Link, tích hợp PJLink và các lệnh Projector Pilot trong configuration.yaml. Mỗi mục hiển thị Found, Not installed hoặc Could not tell, kèm các nút Cách cài đặt và Mở trong HACS khi hữu ích.

• Ưu tiên thẻ có sẵn. Nếu bạn không có thẻ cộng đồng, Sync dựng bảng điều khiển bằng các thẻ có sẵn của Home Assistant và báo cho bạn khi xong. Dùng được ngay không cần cài thêm.
• Nâng cấp khi đã cài thẻ HACS. Ứng dụng kiểm tra những thẻ cộng đồng nào (Mushroom, button-card, card-mod, apexcharts-card) đã được cài và nâng cấp từng thẻ lên bản phong phú hơn khi bạn có. Hướng dẫn bảng điều khiển tự xây dựng đi xa hơn nếu bạn muốn trọn bộ giao diện kính xanh lá.
• Cảnh và điều khiển cần một lần dán. Nếu Home Assistant chưa có lệnh gửi tới máy chiếu, bảng điều khiển vẫn được dựng với số liệu trực tiếp, và một thẻ Hoàn tất thiết lập hướng dẫn bạn: chạm Copy block, dán vào configuration.yaml, khởi động lại Home Assistant, rồi chạm Sync lần nữa.
• Chưa cài gì? Hãy dán thủ công. Nếu chưa cài gì trong Home Assistant, bạn vẫn có thể sao chép mọi thứ từ ứng dụng và tự dán.
• Mật khẩu được nêu rõ. Khối lệnh bạn dán cho biết khi nào nó có chứa mật khẩu máy chiếu, để bạn biết trước khi chia sẻ hoặc lưu trữ.

• Đó là thêm một khối tùy chọn: dán vào cuối configuration.yaml (hoặc chỉ thêm các dòng của nó dưới một mục template: có sẵn) và khởi động lại Home Assistant. Ứng dụng có nút Kiểm tra xem đã có chưa cho bạn biết Home Assistant có nó hay không.
• Việc tắt nguồn giờ được gửi tới Home Assistant dưới dạng off, nên bảng điều khiển và các tự động hóa của bạn thấy máy chiếu đang tắt khi nó thực sự tắt.

• Tự động hóa có thể chạy chúng. “Lúc hoàng hôn, nếu TV bật, chạy Movie Night” là một tự động hóa Home Assistant bình thường khi Cảnh đã là một script.
• Trợ lý giọng nói có thể chạy chúng. Hãy mở một script cho trợ lý của bạn và “bật Movie Night” sẽ đặt nguồn vào, chế độ hình ảnh và bộ nhớ ống kính cùng lúc.
• Chỉ các điều khiển thật của bạn mới xuất hiện. Ứng dụng ghi một script cho từng nguồn vào, chế độ màu và bộ nhớ ống kính mà máy chiếu báo cáo - không phải một danh sách chung chung do nó đoán.
• Gỡ đồng bộ chỉ xóa những gì ứng dụng đã ghi. Tắt đồng bộ, hoặc dùng Remove orphaned scripts (liệt kê chúng và hỏi trước), và Projector Pilot xóa các script nó đã tạo chứ không xóa gì khác.

Trang tổng quan

Sync dựng bảng điều khiển cho bạn

Bạn không phải tự dựng một chế độ xem Lovelace, và cũng không còn phải dán nữa. Khi bạn chạm Sync With HA, ứng dụng dựng một bảng điều khiển Projector Pilot hoàn chỉnh trực tiếp trong Home Assistant qua API của nó: trạng thái trực tiếp của máy chiếu và một nút cho mọi Cảnh và điều khiển đã đồng bộ. Nó xuất hiện trên thanh bên Home Assistant với tên Projector Pilot - mở ra là xong.

1. Đăng nhập Home Assistant trong ứng dụng.
2. Dán khối Copy của ứng dụng vào configuration.yaml một lần và khởi động lại Home Assistant (bước thủ công duy nhất - Home Assistant không cho ứng dụng thêm lệnh đó từ xa).
3. Chạm Sync With HA. Bảng điều khiển được dựng sẵn cho bạn và xuất hiện trên thanh bên với tên Projector Pilot.

Dù được dựng sẵn hay bạn tự dán, bảng điều khiển đều giống nhau - một thẻ trạng thái cộng một nút cho từng điều khiển (đoạn minh họa):

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

Chỉ là ví dụ. Bảng điều khiển của bạn mang thực thể thật của máy chiếu và các Cảnh của riêng bạn.

1. Trong Hubitat, bật ứng dụng Maker API, ghi lại URL truy cập và mã thông báo của nó, và chọn những thiết bị nào nó mở ra.
2. Trong Projector Pilot, mở Cài đặt › Home Automation › Hubitat và nhập thông tin Maker API của hub.
3. Chọn thiết bị đại diện cho máy chiếu. Ứng dụng gợi ý thiết bị có khả năng nhất; hãy chọn nó hoặc tự chọn thiết bị của bạn.
4. Ứng dụng phản chiếu nguồn, tắt tiếng và nguồn vào lên thiết bị đó, chỉ gửi những lệnh mà thiết bị chấp nhận.
5. Xây dựng các quy tắc Rule Machine dựa trên thiết bị đó như với bất kỳ thiết bị nào khác - trạng thái của máy chiếu điều khiển chúng.

1. Mở Cài đặt › Home Automation › Webhooks.
2. Nhập URL để gửi tới. Một webhook Home Assistant trông như http://homeassistant.local:8123/api/webhook/your-id.
3. Chọn sự kiện nào kích hoạt webhook: bật nguồn, tắt nguồn, đổi nguồn vào, gọi lại Cảnh - và tùy chọn lọc theo một nguồn vào hoặc Cảnh cụ thể.
4. Tùy chọn đặt payload tùy chỉnh nếu dịch vụ nhận cần một định dạng riêng; nếu không ứng dụng gửi JSON mặc định.
5. Lưu. Từ đó ứng dụng gửi dữ liệu mỗi khi có sự kiện khớp.

Payload mặc định là JSON thuần - một sự kiện, máy chiếu và giá trị đã thay đổi:

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

Payload ví dụ. Một sự kiện đổi nguồn vào hoặc nguồn mang các trường liên quan tới nó.