Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
実装されると、メディアコントロールコールバックを処理します。

プロパティ

handlePlay

handlePlay: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された再生リクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 再生リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handlePause

handlePause: (sessionId?: IMediaSessionId, context?: ICommandContext) => Promise<void>
メディアコントロールによって開始された一時停止リクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。
context?
ICommandContext 省略可能。追加のコマンドコンテキスト。

戻り値

Promise<void> 一時停止リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleTogglePlayPause

handleTogglePlayPause: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された再生/一時停止の切り替えリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 再生/一時停止の切り替えリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleStop

handleStop: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された停止リクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 停止リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleStartOver

handleStartOver: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された最初から再生リクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 最初から再生リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleFastForward

handleFastForward: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された早送りリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 早送りリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleRewind

handleRewind: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された早戻しリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 早戻しリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSetPlaybackSpeed

handleSetPlaybackSpeed: (speed: number, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された再生速度の設定リクエストを処理します。

パラメーター

speed
number 設定する再生速度。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 再生速度の設定リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSkipForward

handleSkipForward: (delta: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された先へスキップリクエストを処理します。

パラメーター

delta
ITimeValue 先へスキップする差分。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 先へスキップリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSkipBackward

handleSkipBackward: (delta: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された後ろへスキップワードリクエストを処理します。

パラメーター

delta
ITimeValue 後ろへスキップする差分。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 後ろへスキップリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSeek

handleSeek: (position: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたシークリクエストを処理します。

パラメーター

position
ITimeValue シークする位置。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> シークリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSetAudioVolume

handleSetAudioVolume: (volume: number, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたオーディオボリュームの設定リクエストを処理します。

パラメーター

volume
number 設定するボリューム。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> ボリュームの設定リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSetAudioTrack

handleSetAudioTrack: (audioTrack: ITrack, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたオーディオトラックの設定リクエストを処理します。

パラメーター

audioTrack
ITrack 設定するトラック。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> オーディオトラックの設定リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleEnableTextTrack

handleEnableTextTrack: (textTrack: ITrack, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたテキストトラックの有効化リクエストを処理します。

パラメーター

textTrack
ITrack 有効化するトラック。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> テキストトラックの有効化リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleDisableTextTrack

handleDisableTextTrack: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたテキストトラックの無効化リクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> テキストトラックの無効化リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleNext

handleNext: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された次へリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 次へリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handlePrevious

handlePrevious: (sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始された前へリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> 前へリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleEnableShuffle

handleEnableShuffle: (enable: boolean, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたシャッフル有効化リクエストを処理します。

パラメーター

enable
boolean シャッフルを有効にします。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> シャッフルの有効化リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSetRepeatMode

handleSetRepeatMode: (mode: RepeatMode, sessionId?: IMediaSessionId) => Promise<void>
メディアコントロールによって開始されたリピートモード設定リクエストを処理します。

パラメーター

mode
RepeatMode リピートモード。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> リピートモードリクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleSetRating

handleSetRating: (id: MediaId, rating: number, sessionId?: IMediaSessionId) => Promise<void>
レーティング設定リクエストを処理します。

パラメーター

id
MediaId メディアのID。
rating
number レーティングに設定する値。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> レーティングの設定リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleGetMetadataInfo

handleGetMetadataInfo: (id: MediaId) => Promise<IMediaMetadata>
指定されたメディアアイテムのメタデータに関するリクエストを処理します。

パラメーター

id
MediaId メディアのID。

戻り値

Promise<IMediaMetadata> リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleCustomAction

handleCustomAction: (action: Action, sessionId?: IMediaSessionId) => Promise<void>
カスタムアクションのリクエストを処理します。

パラメーター

action
Action 実行するアクション。
sessionId?
IMediaSessionId 省略可能。リクエストの対象を指定するセッションID。

戻り値

Promise<void> リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。

handleGetSessionState

handleGetSessionState: (sessionId?: IMediaSessionId) => Promise<MediaSessionState[]>
セッション状態のリクエストを処理します。

パラメーター

sessionId?
IMediaSessionId 省略可能。ステータスを取得するセッションのセッションID。指定しない場合、すべてのセッションのデータに関するリクエストとして扱います。

戻り値

Promise<MediaSessionState[]> リクエストが正常に処理されたときに解決されるプロミスです。リクエストが失敗した場合はエラーで拒否されます。
最終更新日 2026年8月25日