Agent Skills
返回列表
🎨

Apple 媒体遥控

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-apple-media。

技能介绍

命令行里控不住家里的 Apple 设备

很多人家里已有 Apple TV、HomePod 或支持 AirPlay 的音箱,但日常控制往往依赖遥控器、Siri 或「家庭」App。写脚本、远程 SSH、或在 AI 助手对话里要点名设备、查在播什么、暂停/切歌、推本地文件或 URL,缺一套可复述、可组合的 CLI 能力。

技能在做什么

本技能围绕 atvremote(pyatv)组织操作说明,把常见任务拆成可被助手调用的步骤:

  • 发现设备:扫描局域网内可发现的 Apple TV、HomePod、AirPlay 端点,返回名称、地址、协议与配对状态。
  • 锁定目标:用 -n(设备名)、-s(地址)或 -i(标识符)指定要控制的实例;已知 IP 时可用 --scan-hosts 加快定位。
  • 播放与音量:播放/暂停/停止、进度与播放状态查询;调音量。注意:pause 是挂起可恢复,stop 会结束会话,需从 Siri/家庭 App 等重新起播。
  • 推流:向设备推送本地音频文件或 URL,支持 MP3、WAV、AAC、FLAC 等常见格式。
  • Apple TV 专项:电源、方向键导航、焦点在文本框时的键盘输入、App 级控制。
  • 多房间输出:管理已连接的音频输出(例如 HomePod 编组)。
  • 实时监听:订阅播放状态变更,便于脚本或助手做反应式逻辑。
  • 配对:部分设备(尤其 Apple TV)需先配对;凭证写入 ~/.pyatv.conf。

playing 等命令可读出媒体类型、标题、艺人、进度以及随机/重复状态;立体声 HomePod 对子可按任一单元名称作为目标。

边界与注意点

  • Python 版本:pyatv 与 Python 3.14+ 存在兼容问题,安装或直连时需使用 3.13 及以下(如 python3.13 -m pyatv.scripts.atvremote)。
  • 配对差异:标注 Pairing: NotNeeded 的 HomePod 通常可直接推流;Apple TV 往往要先走完各协议配对。
  • 能力范围:导航与键盘输入主要面向 Apple TV,不是 HomePod 的全套交互替身。

使用场景

  • SSH 到家里 NAS 后,用设备名向客厅 HomePod 推送播客 URL 做试听
  • 自动化脚本定时查询 Apple TV 的 `playing` 输出,日志记录当前片名与进度
  • 新机入库前先 scan,核对局域网内 Apple TV 的协议与是否需配对
  • 多房间聚会前,用输出设备管理把两只 HomePod 编成组再统一推流

适合人员

  • 维护智能家居与影音拓扑的极客,希望用脚本代替反复打开家庭 App
  • 写家庭自动化(Node-RED、自研 agent)的工程师,需要可编排的播放/暂停与推流接口
  • 远程办公偶尔连回家中 Mac 或 Linux 主机,要查 Apple TV 是否在播并远程暂停
  • 音响发烧友用立体声 HomePod 对,需按单只名称做定向推流与状态查询