Roku设备控制

技能简介

Roku CLI 是一款基于 TypeScript 的命令行工具，通过 ECP（External Control Protocol）API 实现对 Roku 设备的网络控制。支持设备自动发现、遥控器模拟、应用启动、内容搜索等功能，并提供 HTTP 桥接模式供外部系统集成。

能做什么

• 自动发现局域网内的 Roku 设备并保存别名
• 模拟实体遥控器发送按键指令
• 查看设备信息、列出已安装应用
• 启动指定应用或搜索影视内容
• 运行交互式终端遥控器界面
• 部署本地 HTTP 服务作为持久化控制桥接

使用说明

安装

npm install -g roku-ts-cli@latest

基础用法

1. 发现设备并创建别名：

   roku discover --save livingroom --index 1

2. 查看设备信息：

   roku --host livingroom device-info

3. 发送遥控按键：

   roku --host livingroom command home

4. 输入文字：

   roku --host livingroom literal "hello"

5. 启动交互模式：

   roku livingroom

HTTP 桥接服务

1. 安装并启动服务：

   roku bridge install-service --port 19839 --token secret --host livingroom --user
   roku bridge start --user

2. 通过 HTTP 发送指令：

   curl -X POST http://127.0.0.1:19839/key \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer secret" \
     -d '{"key":"home"}'

输入与输出

见下方输入与输出表格。

风险提示

• 需与 Roku 设备处于同一局域网，跨网段无法控制
• 桥接服务默认监听本地端口，未配置 token 时存在未授权访问风险
• 部分按键（如 power、volume）可能因设备型号差异行为不一致
• 频繁发送指令可能导致 Roku 暂时拒绝响应

来源信息

原始链接：https://github.com/gumadeiras/roku-cli
来源类型：开源项目

原始链接：https://github.com/openclaw/skills/tree/main/skills/gumadeiras/roku/SKILL.md

来源类型：github