Apple TV 智能遥控器，语音即控

基于 pyatv 库实现 Apple TV 全方位控制，支持播放控制、导航、音量调节、应用启动及电源管理，适合家庭自动化场景。

基本信息

• 技能名称?Apple TV
• 中文名称?Apple TV 智能遥控器，语音即控
• 作者?lucakaufmann
• 分类?其他
• 版本?1.0.0
• 标签?apple-tv, home-automation, pyatv, media-control, smart-home, iot, voice-control, remote-control

使用方法

使用说明
核心用法
Apple TV Control 是一款基于 Python pyatv 库开发的智能家居控制工具，通过局域网与 Apple TV 建立通信，实现远程操控功能。用户需先完成设备配对（Companion 协议用于控制，AirPlay 协议用于媒体），配置设备 ID、IP 地址及凭据后即可使用。
主要功能覆盖六大场景：
状态监控 ：实时查询播放内容、设备状态
播放控制 ：播放/暂停/停止/切歌
导航操作 ：方向键、确认、菜单、主页
音量调节 ：增减音量
电源管理 ：开关机、睡眠唤醒
应用启动 ：直接打开指定 App（Netflix、YouTube、Disney+ 等）
显著优点

1. 协议原生支持 ：基于 Apple 官方逆向工程协议，非红外模拟，响应精准
2. 功能全面 ：覆盖 Apple TV 绝大部分可操作功能，替代物理遥控器
3. 语音触发友好 ：内置多种自然语言触发词（"TV"、"pause TV"、"what's playing"等）
4. 配置灵活 ：支持多设备管理，JSON 配置简单直观
   潜在缺点与局限性
   Python 版本限制 ：pyatv 依赖 Python ≤3.13，3.14+ 因 asyncio 变更无法运行
   初始配置复杂 ：需命令行完成扫描、双协议配对、凭据保存，门槛较高
   网络依赖 ：需 Apple TV 与运行设备处于同一局域网
   无加密传输 ：局域网内明文通信，存在嗅探风险
   适合人群
   已部署 Home Assistant 或类似家庭自动化系统的技术用户
   希望通过语音/自动化脚本控制 Apple TV 的进阶用户
   愿意处理 Python 环境配置的开发者
   常规风险
   凭据泄露 ：config 文件存储未加密的认证凭据，需严格限制文件权限（建议 600）
   网络攻击 ：若攻击者入侵局域网，可模拟控制指令
   误触发风险 ："TV" 等短触发词易与其他对话冲突
   协议变更 ：Apple 可能更新私有协议导致功能失效，需关注 pyatv 更新