@amazon-devices/kepler-media-controls

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

はじめに

セットアップ

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リファレンス

クラス

インターフェイス

列挙型

変数