Runbook • Roku 频道商店 • SceneGraph

将 Roku 频道发布到 Roku 频道商店

发布 Roku 频道需要一台 Roku 设备。面板中构建的是可侧载的频道 zip 包,而频道商店只接受已签名的 .pkg 文件,且签名密钥只能在处于开发者模式的 Roku 设备上生成和使用。因此最后两步需在您自己的设备上完成:安装、测试、打包,然后在开发者控制面板中上传 .pkg 文件。

开发者账户:免费 在您的 Roku 上签名 直播、视频和广播

操作步骤

Roku 会不时重命名控制面板页面;每个步骤都说明了页面的功能,即使页面被重命名也依然适用。按键顺序和设备页面多年来未曾改变。

1

注册为 Roku 开发者

  1. 使用将拥有该频道的 Roku 账户在 developer.roku.com 上登录,并完成开发者注册。免费频道不收取任何费用。
  2. 当控制面板要求时,接受开发者协议。商店中显示的发布者名称来自此个人资料。
2

将 Roku 切换至开发者模式

  1. 使用 Roku 遥控器按 Home 三次,按 Up 两次,然后按 Right, Left, Right, Left, Right。
  2. 记下开发者设置屏幕上的 IP 地址,启用安装程序,接受协议并设置 Web 服务器密码。设备将重新启动。

开发者模式一次仅保留一个侧载频道;安装另一个频道会将其替换。

3

侧载并测试 zip 包

  1. 在 构建您的应用 下构建 Roku,并下载 Roku 频道(.zip)。请勿解压。
  2. 从同一网络上的电脑浏览至 http://<roku-ip>,并以 rokudev 身份使用第 2 步中的密码登录。
  3. 上传 zip 包并按 Install。频道会立即在电视上打开。
  4. 进行测试:观看直播、播放媒体库中的视频、继续观看和观看列表、搜索、关于;对于广播电台,请测试收听直播和暂停。从第一个屏幕按返回键以确认其退出。
  5. 从同一网页获取商店截图(Utilities、Screenshot)。
4

生成签名密钥(仅一次)

  1. 打开到 Roku 端口 8080 的 telnet 会话(telnet <roku-ip> 8080)并运行 genkey。
  2. 将输出的密码和 DevID 存放在安全的地方。频道的每次更新都必须使用此密钥签名。

在另一台 Roku 上,或恢复出厂设置后,请使用已用该密钥及其密码签名的 .pkg 文件,在设备 Utilities 页面通过 Rekey 恢复密钥。密钥丢失意味着需要创建新频道。

5

打包频道

  1. 在频道已安装的情况下,打开设备网页上的 Packager。
  2. 输入应用名称和版本(版本与构建版本匹配:构建版本 7 对应 1.0.7)以及 genkey 密码,然后点击 Package。
  3. 下载生成的 .pkg 文件。
6

创建频道并提交

  1. 在开发者控制面板中,添加一个使用 SDK 构建的新公共频道,名称与应用中一致。
  2. 商店列表:将 roku/poster-540x405.png 作为频道海报,填写描述、类别、第 3 步中的截图以及生成的隐私政策 URL。
  3. 上传 .pkg 文件。控制面板会对其运行 Roku 的静态分析;请阅读每一条发现。
  4. 提交认证。在控制面板中回复任何认证备注;一旦获得批准,即可发布。

更新:在面板中重新构建 Roku,侧载新的 zip 包,使用相同的密钥打包,并将 .pkg 作为新版本上传。视频、流和链接来自实时源,无需更新。

关于发布 Roku 频道的常见问题

商店接受什么、必须在设备上完成什么,以及什么取代了 Direct Publisher。

发布频道需要我自己的 Roku 设备吗?

是的。签名密钥来自 genkey,它通过 telnet 在 Roku 本身上运行,而 Packager 只能对已安装在该设备上的频道进行签名。任何当前的 Roku 播放器或 Roku 电视,只要与您的电脑处于同一网络即可。之后的每次更新都使用相同的密钥签名;第 4 步的备注说明了如何将该密钥移至另一台 Roku。

什么取代了 Roku Direct Publisher?

SDK 频道。Roku 于 2023 年 7 月停止向新频道开放 Direct Publisher,并于 2024 年 1 月关闭了该工具,因此仅靠内容源已无法创建频道。面板中的构建版本是针对 Roku SDK 编写的 SceneGraph 频道,这正是第 6 步中开发者控制面板所要求的频道类型。

频道 .zip 和 .pkg 有什么区别?

.zip 是未签名的频道。它可以侧载到处于开发者模式的 Roku 上进行测试和截图,下一次安装会将其替换。.pkg 是同一频道在设备上打包并使用您的密钥签名后的版本。频道商店只接受 .pkg,控制面板会对该文件运行静态分析。

Roku 频道显示什么内容?

观看直播、带继续观看和观看列表的视频媒体库、搜索和关于屏幕;广播电台则提供收听直播和暂停功能,而非媒体库。流、视频、徽标和链接均从实时源读取,因此无需重新提交即可更改——名称和图标在构建中固定。面板会为其他屏幕构建相同的电台:适用于三星和 LG 的 智能电视应用,以及适用于 iPhone 和 Android 的 广播电台应用。

需要帮助?与我们聊天

如果您对静态分析发现想获得第二意见,或者 Roku 无法接受 zip 包:支持团队全天候在线聊天。

所有 Runbook