sebbo2002/pyatv-mqtt-bridge

pyatv-mqtt-bridge

镜像概述

pyatv-mqtt-bridge 是一款通过 MQTT 协议实现 Apple TV 远程控制的桥接工具。它解决了 Apple TV 与主流家庭自动化系统的集成问题，允许用户通过支持 MQTT 协议的平台对 Apple TV 进行操作，同时提供设备状态查询能力。

核心功能与特性

• MQTT 协议支持：采用 MQTT 标准协议通信，兼容各类支持 MQTT 的家庭自动化系统（如 Home Assistant、OpenHAB 等）。
• 远程控制能力：支持模拟 Apple TV 遥控器按键操作，包括播放/暂停、音量调节、方向键导航等核心控制功能。
• 状态查询功能：可实时获取 Apple TV 的当前状态，如播放状态、当前应用、音量级别等信息。
• 自动化集成：无缝融入现有家庭自动化流程，实现与其他智能设备的联动控制。

使用场景

• 家庭自动化系统集成：将 Apple TV 纳入智能家居控制体系，通过语音助手、定时任务等触发设备操作。
• 多设备统一管理：在集中化控制平台中对多个 Apple TV 设备进行统一监控和操作。
• 远程操作需求：适用于无需物理接触设备即可实现控制的场景，如多房间控制、远程家庭管理等。

使用方法

基本部署

通过 Docker 运行镜像时，需配置 MQTT 服务器连接信息及目标 Apple TV 设备参数：

bash
docker run -d \
  --name pyatv-mqtt-bridge \
  -e MQTT_BROKER=mqtt.example.com \
  -e MQTT_PORT=1883 \
  -e MQTT_USER=your_mqtt_user \
  -e MQTT_PASSWORD=your_mqtt_password \
  -e APPLE_TV_NAME="Living Room Apple TV" \
  sebbo2002/pyatv-mqtt-bridge

配置参数说明

功能使用示例

发送控制命令

向 MQTT 主题 pyatv/command 发送以下指令实现对应操作：

• play：播放
• pause：暂停
• volume_up：音量增加
• volume_down：音量降低
• menu：菜单键
• select：选择键

查询设备状态

订阅 MQTT 主题 pyatv/state 获取设备状态信息，典型状态数据格式：

json
{
  "power": "on",
  "playing": true,
  "app": "Netflix",
  "volume": 65
}