@amazon-devices/kepler-player-server

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

VegaプレーヤーサーバーAPIは、Vegaのメディアアプリ開発者向けに、サーバー側のヘッドレスJavaScriptメディア再生機能を提供します。これにより、UIとは別のJavaScriptスレッドでメディア再生が実行され、複雑なUIを持つアプリの最初のビデオフレームまでの時間（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]
 # プレーヤーUIとヘッドレス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日