roku-control

Roku Control 是一款基于 Roku 官方 External Control Protocol (ECP) 的本地网络设备控制技能，允许用户通过简单的 HTTP 命令完全操控局域网内的 Roku 电视或流媒体播放器。

核心用法涵盖设备自动发现、应用启动、导航控制、媒体播放、音量调节及文本搜索六大类操作。用户可通过 SSDP 协议自动发现网络中的 Roku 设备，获取 IP 地址后，使用 CLI 命令或自然语言指令执行操作，如启动 Netflix、调节音量、发送搜索关键词等。技能支持复杂工作流编排，可结合睡眠延迟实现"电影之夜"等自动化场景，并能与其他智能家居技能（如灯光控制）联动。

显著优点包括：纯本地通信零延迟，无需互联网连接；零认证零配置，开箱即用；支持全面的遥控器功能模拟；提供完善的自然语言映射，降低使用门槛；完全隐私安全，无云端数据交互。

潜在局限性需留意：ECP 协议无法唤醒完全关机的设备；依赖稳定的本地网络环境，设备 IP 变动需重新配置；音量与电源控制仅限 Roku TV 或支持 HDMI-CEC 的 setup；文本输入采用逐字符发送方式，长文本搜索效率较低；部分路由器可能屏蔽 SSDP 多播发现。

适合拥有 Roku 设备的家庭用户、智能家居自动化爱好者及追求隐私安全的本地中控方案使用者。特别适合构建"一键观影"等家庭影院自动化场景。

使用风险主要涉及网络配置：需确保防火墙未阻断 8060 端口及 SSDP 多播；建议为 Roku 设备配置静态 IP 或 DHCP 保留以避免 IP 变动导致控制失效；依赖 requests 库建议升级至 2.25.0 以上版本以防范潜在安全漏洞。