@amazon-devices/kepler-media-controls

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

开始使用

设置

将以下库依赖项添加到package.json文件的dependencies部分。

已复制到剪贴板。

json "@amazon-devices/kepler-media-controls": "~1.0.25", "@amazon-devices/kepler-media-types": "~1.0.0" </div>

在manifest.toml中添加以下组件和权限。

已复制到剪贴板。

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

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

[[extras]]
key = "interface.provider"
component-id = "com.amazondeveloper.media.sample.main"

[extras.value.application]
[[extras.value.application.interface]]
interface_name = "com.amazon.kepler.media.IMediaPlaybackServer"
command_options = [
    "StartOver",
    "Previous",
    "Next",
    "SkipForward",
    "SkipBackward",
    <插入支持的其他命令>
]
attribute_options = ["AudioAdvanceMuted", <插入任何其他支持的属性选项>]
features = ["AdvancedSeek", "VariableSpeed", "AudioTracks", "TextTracks", <插入其他支持的功能>]

API参考

类

Action — 表示您可以使用媒体控制客户端调用的操作。
InvalidArgumentError — 传递无效参数时抛出的错误。
InvalidStateError — 当请求由于处于以下状态而无法处理时发生的错误：
NotAllowedError — 当无法处理请求时发生的错误。
NotAvailableError — 当请求的数据不可用时发生的错误。
SeekOutOfRangeError — 当请求的跳转位置不在系统声明的范围内时发生的错误。
SpeedOutOfRangeError — 当系统不支持请求的播放速度时发生的错误。

接口

IArtist — 表示艺术家相关信息。
IArtwork — 表示对象预期的图片。
IAudioBookInfo — 表示有声读物相关信息。
ICapabilities — 表示媒体端点的功能。
ICommandContext — 传递给媒体命令的可选上下文。
IControl — 表示控件。
ILocale — 表示轨道区域设置的接口。
IMediaControlClientAsync — 媒体控制客户端的接口
IMediaControlEndpointLocatorAsync — 用于异步定位媒体控制终端并与之交互的接口。
IMediaControlEndpointLocatorListener — 表示侦听器，添加后可以监控可用媒体控制终端节点的变化。
IMediaControlHandlerAsync — 实现后可处理媒体控制回调。
IMediaControlListener — 实现后可处理媒体控制状态变化。
IMediaControlServerAsync — 表示媒体控制服务器操作。
IMediaInfo — 表示媒体相关信息。
IMediaMetadata — 返回元数据的对象所需的接口。
IMediaProviderInfo — 表示媒体提供商相关信息。
IMediaSessionId — 表示媒体会话ID。
IPackageId — 表示应用的程序包ID。
IPlaybackPosition — 表示轨道的播放位置。
IPlaybackSource — 表示播放源。
IPlaybackState — 表示轨道的播放状态。
IPlaylistState — 表示播放列表的状态。
IRadioStationInfo — 表示广播电台相关信息。
ISubscription — 表示可用于订阅各种内容的订阅。
ITimeValue — TimeValue的接口，用于表示时间值结构。
ITrack — 表示轨道信息。
KeplerMediaControlsError — 表示可能抛出的一般错误。
MediaSessionState — 表示媒体会话状态。

枚举

CommandSource — 指定媒体命令的来源。
PlaybackStatus — 指定播放状态。
RadioBand — 为媒体播放器指定无线电频段。
RepeatMode — 为媒体播放器指定重复模式。

变量

MediaControlComponentAsync — 此类用于获取MediaControlEndpointLocatorAsync类的实例。
MediaControlServerComponentAsync

Last updated: 2026年7月22日

@amazon-devices/kepler-media-controls

开始使用

设置

相关主题

API参考

类

接口

枚举

变量