Apple TV遥控

技能简介

通过pyatv库实现Apple TV的远程控制，支持播放/暂停、导航操作、音量调节、应用启动、电源开关及播放状态查询。

能做什么

• 播放控制：播放、暂停、停止、上一首/下一首
• 导航操作：上下左右方向键、确认、菜单、主页
• 音量调节：增大/减小音量
• 电源管理：开机、关机、切换电源状态
• 应用管理：列出已安装应用、启动指定应用
• 状态查询：查看当前播放内容、设备状态
• 设备发现：扫描局域网内的Apple TV

使用说明

1. 安装依赖

pipx install pyatv --python python3.11

注意：pyatv要求Python版本≤3.13，Python 3.14+存在异步IO兼容问题。

2. 首次配对配置

# 查找Apple TV
atvremote scan

# 配对Companion协议（必需）
atvremote --id <DEVICE_ID> --protocol companion pair

# 配对AirPlay协议（用于媒体控制）
atvremote --id <DEVICE_ID> --protocol airplay pair

3. 配置文件

创建~/clawd/config/appletv.json：

{
  "name": "Living Room",
  "id": "DEVICE_ID",
  "ip": "192.168.x.x",
  "credentials": {
    "companion": "...",
    "airplay": "..."
  }
}

4. 常用命令示例

scripts/appletv.py status      # 查看完整状态
scripts/appletv.py pause       # 暂停播放
scripts/appletv.py app Netflix # 打开Netflix
scripts/appletv.py turn_off    # 关闭电视

输入与输出

见下方输入与输出表格。

风险提示

• 需在同一局域网内，且Apple TV开启远程控制权限
• 首次使用必须完成配对流程，获取有效凭证
• IP地址变动后需更新配置文件
• 部分功能需对应协议配对成功方可使用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/lucakaufmann/appletv/SKILL.md
来源类型：GitHub仓库