核心用法
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 更新