@amazon-devices/kepler-media-content-launcher

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

内容启动器API支持使用多种接口来搜索、浏览和播放内容。

备注

Fire TV支持使用Fire TV遥控器、触摸或语音搜索和启动内容。内容启动器API不依赖于特定模式，支持使用多种接口来搜索、浏览和播放内容。所有集成了内容启动器的应用都应集成账户登录API，以将您应用的登录状态发送到Fire TV。有关API详细信息，请参阅Kepler API参考中的内容启动器API和账户登录API概述。

开始使用

设置

将以下库依赖项添加到package.json文件的dependencies部分。
已复制到剪贴板。
```
 "@amazon-devices/kepler-media-content-launcher": "~2.0.0",
```

要访问内容启动器API，请在您的manifest.toml中添加以下权限。

已复制到剪贴板。

 schema-version = 1

 [package]
 title = "<应用标题>"
 id = "com.amazondeveloper.media.sample"

 [components]
 [[components.interactive]]
 id = "com.amazondeveloper.media.sample.main"
 runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
 launch-type = "singleton"
 # 类别“com.amazon.category.kepler.media”仅对主要组件是必需的，该组件在
 # 清单的 [[extras]] 部分中使用“component-id”值进行标识。
 categories = ["com.amazon.category.main", "com.amazon.category.kepler.media"]

 [processes]
 [[processes.group]]
 component-ids = ["com.amazondeveloper.media.sample.main"]

 [offers]
 [[offers.interaction]]
 id = "com.amazondeveloper.media.sample.main"

 [[message]]
 uri = "pkg://com.amazondeveloper.media.sample.main"
 # 匹配 [[offers.interaction]] 中使用的权限。如果未添加权限，则使用“*”。
 sender-privileges = ["*"]
 receiver-privileges = ["self"]

 [[offers.module]]
 id = "/com.amazondeveloper.media.sample.module@ISomeUri1" 
 includes-messages = ["pkg://com.amazondeveloper.media.sample.main"]

 [[extras]]
 key = "interface.provider"

 component-id = "com.amazondeveloper.media.sample.main"

 [extras.value.application]
 [[extras.value.application.interface]]
 interface_name = "com.amazon.kepler.media.IContentLauncherServer"

 # 只有当 [[extras]] 部分中指定的“component-id”不同于您在此处提供的“component-id”时，
 # override_command_component字段才是必需的。这样一来，您就可以不使用extras中最初定义的组件，
 # 而使用其他组件来执行命令，从而能够灵活进行
 # 配置设置。

 # 例如，如果您在内容启动器界面之外还使用账户登录界面，
 # 您需要使用以下行覆盖账户登录状态属性
 # 才能被定向到服务组件：
 # override_command_component = { Status = "com.amazondeveloper.media.sample.interface.provider" }
 attribute_options = ["partner-id"]
 static-values = { partner-id = "<您的合作伙伴ID>" }

 [needs]

 [[needs.module]]
 id = "/com.amazon.kepler.media@IContentLauncher1"

注意： partner-id与Fire OS启动器集成中使用的唯一标识符 (PARTNER_ID) 相同。请联系您的亚马逊代表，以获得支持和进一步说明。

内容启动器集成指南

模块

Last updated: 2025年10月2日

@amazon-devices/kepler-media-content-launcher

备注

开始使用

设置

相关主题

模块