功能特性

• 支持兼容机型的 HKSV 录像
• 可选的电池服务（电量、低电量、充电状态）
• 可选的指示灯作为 Lightbulb 服务（开/关）
• 可配置的轮询，定期刷新电池与指示灯状态
• 可配置跳过不支持或离线设备

环境要求

• Node.js 18+（推荐）以及已运行的 Homebridge
• 萤石开放平台 App Key 与 App Secret

安装

npm i -g @fantasytu/homebridge-ys7

配置

在 Homebridge 的 config.json 中添加：

{
  "platforms": [
    {
      "platform": "YS7Platform",
      "name": "YS7Platform",
      "appKey": "YOUR_APP_KEY",
      "appSecret": "YOUR_APP_SECRET",
      "videoProcessor": "ffmpeg",
      "skipOfflineDevices": true,
      "pollingInterval": 60
    }
  ]
}

字段说明：

• platform（必填）：固定为 YS7Platform
• appKey（必填）：萤石开放平台 App Key
• appSecret（必填）：萤石开放平台 App Secret
• videoProcessor（可选）：ffmpeg 的路径或名称，默认 ffmpeg
• skipOfflineDevices（可选）：跳过被报告为离线的摄像头，默认 true
• pollingInterval（可选）：轮询间隔（秒），默认 60，最小 10

工作原理

• 启动后通过萤石 API 发现摄像头；
• 对支持的设备，配置 HKSV，并添加运动检测、电池、指示灯等服务；
• 后台定时器每隔 pollingInterval 秒轮询设备状态，更新 HomeKit 特征值。

常见问题

• 确认 appKey/appSecret 正确并与萤石账号绑定；
• 直播/录像失败时，检查是否已安装 ffmpeg，videoProcessor 路径是否正确；
• 提高 Homebridge 日志级别，并检查网络/防火墙是否阻断萤石接口访问。

致谢

• 基于 Homebridge 生态与社区；
• 萤石/YS7 API 的使用受其服务条款约束。

许可证

MIT