您的投影机，接入 Home Assistant 和 Hubitat。

• 它发布状态。投影机会以 Home Assistant 传感器、Hubitat 设备，或发送到您 Webhook 的 JSON 数据形式出现，携带与应用中显示的相同读数。
• 它发布控制。您保存的每个场景，以及电源、每个信号源、每个色彩模式和每个镜头记忆，都会变成自动化或语音助手可以运行的内容。
• 它无需服务器。脚本设置好后，Home Assistant 会直接向投影机的 IP 地址发送命令。您的手机不需要在网络中，也不会经过任何云账号。

三种接入方式，一个中心

“设置” › “家庭自动化”就是中心。选择您使用的平台：Home Assistant、Hubitat 或 Webhook，并在那里完成设置。您可以同时接入多个平台，它们彼此独立。

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 同步会为您的场景和控件写入或更新脚本，并直接在 Home Assistant 中构建一个现成的 Projector Pilot 仪表盘。每当您添加场景或更改控件时都可以再次运行，它会就地更新，而不会堆积重复项。
• 移除孤立脚本会找出应用写入、但已没有对应场景或控件的脚本，例如在您删除场景之后，列出它将移除的确切内容，并先征求您的同意。在您确认之前不会删除任何内容。它只会处理 Projector Pilot 创建的脚本，您 Home Assistant 中的其他内容不会受到影响；如果 Home Assistant 不提供脚本列表，则不会移除任何内容。

• 已连接到 Home Assistant：已登录并有响应。如果 Home Assistant 没有响应，该行会提示您检查地址，并确认手机在同一网络中。
• 投影机已添加到 Home Assistant：Home Assistant 是否已经有这台投影机。如果没有，该行会引导您添加 PJLink 集成，而添加集成的步骤会显示 Home Assistant 要求填写的 PJLink 主机和端口。
• 读数传感器已注册：承载投影机读数的传感器。它会在应用第一次读取投影机时注册，如果有因素阻止注册，该行会提供立即注册或开启选项。
• 您的 Home Assistant 已具备的内容：HACS（社区商店）、Epson Projector Link 集成、PJLink 集成，以及 configuration.yaml 中的 Projector Pilot 命令。每一项会显示已找到、未安装或无法确定，并在需要时提供“安装方法”和“在 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 中是否已有它。
• 现在关机会以off的状态传到 Home Assistant，所以仪表盘和您的自动化在投影机关机时就会看到它处于关闭状态。

• 自动化可以运行它们。“日落时，如果TV 开了，就运行观影之夜”，一旦场景成为脚本，这就是一个普通的 Home Assistant 自动化。
• 语音助手可以运行它们。把脚本开放给您的助手，说“打开观影之夜”，就会一并设置信号源、画面模式和镜头记忆。
• 只会出现真实的控件。应用只为投影机上报的每个信号源、色彩模式和镜头记忆写入脚本，而不是它猜测出来的通用列表。
• 取消同步只会移除应用写入的内容。关闭同步，或使用“移除孤立脚本”（它会列出内容并先征求您的同意），Projector Pilot 只会删除它自己创建的脚本，不会动其他任何内容。

仪表盘

同步为您构建仪表盘

您不需要手工搭建 Lovelace 视图，现在也不再需要粘贴了。当您轻点与 HA 同步时，应用会通过 Home Assistant 自己的 API，直接在 Home Assistant 中构建完整的 Projector Pilot 仪表盘：包含投影机的实时状态，以及它同步的每个场景和控件对应的按钮。它会以 Projector Pilot 的名称出现在您的 Home Assistant 侧边栏中，打开即可，一切就绪。

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，输入您 Hub 的 Maker API 信息。
3. 选择代表投影机的设备。应用会推荐最可能的那个，您可以选择它，也可以选择自己的设备。
4. 应用会把电源、静音和信号源镜像到该设备，并且只发送该设备接受的命令。
5. 像对待其他设备一样，针对该设备构建 Rule Machine 规则，投影机的状态会驱动这些规则。

1. 打开设置 › 家庭自动化 › Webhook。
2. 输入要发送请求的 URL。Home Assistant Webhook 的形式类似 http://homeassistant.local:8123/api/webhook/your-id。
3. 选择哪些事件会触发 Webhook：开机、关机、信号源切换、场景调用，也可以选择只针对特定的信号源或场景进行筛选。
4. 如果接收服务需要特定格式，可以选择设置自定义负载内容；否则应用会发送默认的 JSON。
5. 保存。此后，应用会在每个匹配的事件发生时发送请求。

默认的负载内容是纯 JSON：包含事件、投影机，以及发生变化的值：

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

示例负载内容。信号源切换或电源事件会携带与之相关的字段。