Apple设备遥控

技能简介

通过pyatv库在命令行中控制Apple TV、HomePod及AirPlay设备，实现扫描发现、播放控制、音量调节、流媒体推送、电源管理及导航操作。

能做什么

• 扫描局域网内的Apple设备并获取连接信息
• 控制音乐/视频播放（播放、暂停、切歌、进度跳转）
• 调节设备音量或设置指定音量值
• 推送本地音频文件或网络URL到设备播放
• 管理Apple TV电源状态（唤醒/休眠）
• 模拟遥控器方向键、菜单、主页等导航操作
• 输入文字、启动应用、管理多房间音频输出

使用说明

安装步骤

1. 安装pyatv工具（需Python 3.13或更低版本）：
   pipx install pyatv --python python3.13
2. 确保atvremote命令可用，若提示未找到则执行：
   pipx ensurepath
3. 验证安装：
   atvremote scan

基础用法

扫描设备后，通过名称、IP地址或设备ID指定目标：

# 扫描所有设备
atvremote scan

# 按名称控制播放
atvremote -n "Kitchen" play
atvremote -n "Kitchen" pause
atvremote -n "Kitchen" set_volume=50

# 推送本地或网络音频
atvremote -n "Kitchen" stream_file=/path/to/music.mp3
atvremote -n "Kitchen" play_url=https://example.com/stream.mp3

# Apple TV导航操作
atvremote -n "Apple TV" up
atvremote -n "Apple TV" select
atvremote -n "Apple TV" home

输入与输出

见下方输入与输出表格。

风险提示

• Python 3.14+存在兼容性问题，必须使用Python 3.13或更早版本安装
• 首次连接部分设备需要配对认证，请按屏幕提示完成
• 网络不稳定时设备可能离线，需重新扫描获取最新IP
• 停止播放（stop）会结束当前会话，无法通过play恢复
• 多房间音频分组操作需确保所有设备在同一Apple ID下

来源信息

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