基于 pyatv 库实现 Apple TV 全方位控制，支持播放控制、导航、音量调节、应用启动及电源管理，适合家庭自动化场景。
说明：
## 核心用法
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 更新
会员专属
