核心功能
本技能提供基于 ADB(Android Debug Bridge)的命令行工具,用于远程控制 Chromecast with Google TV 设备。主要能力包括:
- 设备管理:ADB 配对(pair)、连接状态查询、自动设备发现与缓存
- 播放控制:暂停(pause)、恢复(resume)媒体播放
- 内容投屏:支持 YouTube 视频 ID/URL 直接播放、Tubi 链接播放,以及通过 Google TV 全局搜索的第三方应用(Hulu、Max、Disney+ 等)剧集播放
显著优点
1. 纯标准库实现:Python 脚本仅依赖标准库,通过 uv 运行避免系统包冲突
2. 智能设备缓存:自动记录最后成功连接的设备信息(.last_device.json),减少重复输入
3. 多路径内容解析:YouTube 支持视频 ID/URL/文本查询(需 yt-api),Tubi 支持 HTTPS 链接,其他平台通过 scrcpy 模拟全局搜索
4. 非侵入式设计:不执行端口扫描,仅连接用户指定的显式端口,避免与 Google ADB 端口轮换机制冲突
5. 环境变量与 CLI 参数双支持:CHROMECAST_HOST/CHROMECAST_PORT 或 --device/--port 灵活配置
潜在局限与风险
1. 网络依赖:需局域网内设备可访问,且 Chromecast 需开启开发者选项和 ADB 调试
2. 配对流程复杂:首次使用需手动在电视上启用无线调试并获取配对码,对非技术用户门槛较高
3. 第三方工具链依赖:adb、uv、scrcpy、yt-api 需预先安装,跨平台配置可能存在差异
4. 全局搜索脆弱性:非 YouTube/Tubi 的内容依赖 scrcpy 模拟 UI 交互,受 Google TV 界面更新影响,可能失效
5. 无认证加密:ADB 连接本身不提供传输层加密,局域网内存在中间人攻击风险
适合人群
- 熟悉命令行和 ADB 的技术用户
- 希望自动化 Chromecast 控制的家庭影院爱好者
- 需要集成 Google TV 到自动化工作流(如 Home Assistant、快捷指令)的开发者
常规风险
- 设备误操作:错误的 ADB 命令可能导致应用异常或系统不稳定(虽本技能仅发送标准媒体意图,风险较低)
- 网络暴露:开启 ADB 调试的 Chromecast 若暴露于不可信网络,可能被未授权访问
- 缓存失效:设备 IP 变动后,
.last_device.json缓存可能导致连接失败,需手动更新或等待自动发现