@amazon-devices/kepler-player-server

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

Vega播放器服务器API为Vega上的媒体应用开发者提供服务器端无头JavaScript媒体播放功能。这样可以在与用户界面不同的JavaScript线程上运行媒体播放，从而为具有复杂用户界面的应用将第一视频帧时间 (TTFVF) 最多缩短30%。

开始使用

设置

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

已复制到剪贴板。

 "@amazon-devices/headless-task-manager": "~1.2.4",
 "@amazon-devices/kepler-player-server": "~2.2.14",
 "@amazon-devices/kepler-player-client": "~2.2.14",

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

已复制到剪贴板。

 [[components.interactive]]
 id = "<应用程序包名称>.main"
 runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0" 
 launch-type = "singleton"
 categories = ["com.amazon.category.main"]

 [[components.service]]
 id = "<应用程序包名称>.service"
 runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
 launch-type = "singleton"
 .
 .
 .

 [processes]
 # 确保播放器用户界面和无头JS播放器组件在同一个进程组中
 [[processes.group]]
 component-ids = ["<应用程序包名称>.main", "<应用程序包名称>.service"]

 .
 .
 .

 [wants]

 [[wants.service]]
 id = "<应用程序包名称>.service"

 .
 .
 .

 [offers]

 [[offers.service]]
 id = "<应用程序包名称>.service"

API参考

类

InvalidArgumentError — 当给定参数无效时发生错误。
PlayerServerFactory
PlayerSessionError — 所有媒体元素都具有关联的错误状态。

接口

IHttpHeader — 定义HTTP标头。应用可以发送以下项所需的标头
IMediaLocator — 使用可选HTTP标头定义媒体URL。
IOobTextTrackInfo — 定义带外 (OOB) 文本轨道信息。
IPlayerServer — 表示Kepler播放器服务器操作。
IPlayerServerFactory — 提供Kepler播放器服务器实例的组件。
IPlayerServerHandler — 提供PlayerServer服务逻辑的处理程序的接口。
IPlayerSessionError — 表示Kepler播放器会话中的错误。
IPlayerSessionId — 描述媒体会话ID的接口。
IPlayerSessionLoadParams — 定义用于通过URL加载媒体内容的参数
IPlayerSessionMediaInfo — 表示获取媒体内容所需的URL和HTTP标头。
IPlayerSessionPosition — 描述媒体播放位置和时间信息
IPlayerSessionStatus — 表示媒体播放的当前状态。
ISubscription — 表示可用于订阅各种内容的订阅。
ITimeRange — 为媒体播放中的缓冲内容定义时间范围。
ITrackInfo — 表示媒体轨道详细信息
IViewHandle — 描述KeplerVideoSurfaceView或KeplerCaptionsView返回的表面句柄的接口。

枚举

IPlayerSessionState — 表示媒体播放的可能状态。
IUnloadSyncStatus — 表示媒体播放同步卸载的可能状态值。

类型别名

ITextTrackKind — 定义文本轨道的类型以及应采用的处理方式。
ITextTrackMode — 表示文本轨道的显示模式。
ITrackType — 定义可用的文本轨道类型：

Last updated: 2026年7月22日