as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
实现后,处理媒体控制回调。

属性

handlePlay

handlePlay: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的播放请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理播放请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handlePause

handlePause: (sessionId?: IMediaSessionId, context?: ICommandContext) => Promise<void>
处理通过媒体控制发起的暂停请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。
context?
ICommandContext 可选。其他命令上下文。

返回值

Promise<void> 这是一个Promise,会在成功处理暂停请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleTogglePlayPause

handleTogglePlayPause: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的播放/暂停请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理切换播放请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleStop

handleStop: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的停止请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理停止请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleStartOver

handleStartOver: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的重新开始请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理重新开始请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleFastForward

handleFastForward: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的快进请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理快进请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleRewind

handleRewind: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的快退请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理快退请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSetPlaybackSpeed

handleSetPlaybackSpeed: (speed: number, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的设置播放速度请求。

参数

speed
number 设置的速度。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理设置播放速度请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSkipForward

handleSkipForward: (delta: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的向前跳转请求。

参数

delta
ITimeValue 向前跳过的间隔。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理向前跳过请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSkipBackward

handleSkipBackward: (delta: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的向后跳转请求。

参数

delta
ITimeValue 向后跳过的间隔。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理向后跳过请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSeek

handleSeek: (position: ITimeValue, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的搜索请求。

参数

position
ITimeValue 播放定位的位置。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理播放定位请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSetAudioVolume

handleSetAudioVolume: (volume: number, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的设置音量请求。

参数

volume
number 设置的音量。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理设置音量请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSetAudioTrack

handleSetAudioTrack: (audioTrack: ITrack, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的设置音轨请求。

参数

audioTrack
ITrack 设置的音轨。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理设置音轨请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleEnableTextTrack

handleEnableTextTrack: (textTrack: ITrack, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的启用文本轨道请求。

参数

textTrack
ITrack 启用的音轨。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理启用文本轨道请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleDisableTextTrack

handleDisableTextTrack: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的禁用文本轨道请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理禁用文本轨道请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleNext

handleNext: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的下一首请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理下一首请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handlePrevious

handlePrevious: (sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的上一首请求。

参数

sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理上一首请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleEnableShuffle

handleEnableShuffle: (enable: boolean, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的启用随机播放请求。

参数

enable
boolean 启用随机播放。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理随机播放请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSetRepeatMode

handleSetRepeatMode: (mode: RepeatMode, sessionId?: IMediaSessionId) => Promise<void>
处理通过媒体控制发起的设置重复模式请求。

参数

mode
RepeatMode 单曲循环模式。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理单曲循环模式请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleSetRating

handleSetRating: (id: MediaId, rating: number, sessionId?: IMediaSessionId) => Promise<void>
处理设置评分请求。

参数

id
MediaId 媒体的ID。
rating
number 为评分设置的值。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理评分请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleGetMetadataInfo

handleGetMetadataInfo: (id: MediaId) => Promise<IMediaMetadata>
处理对指定媒体项目元数据的请求。

参数

id
MediaId 媒体的ID。

返回值

Promise<IMediaMetadata> 这是一个Promise,会在成功处理请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleCustomAction

handleCustomAction: (action: Action, sessionId?: IMediaSessionId) => Promise<void>
处理自定义操作的请求。

参数

action
Action 执行的操作。
sessionId?
IMediaSessionId 可选。请求的目标会话ID。

返回值

Promise<void> 这是一个Promise,会在成功处理请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。

handleGetSessionState

handleGetSessionState: (sessionId?: IMediaSessionId) => Promise<MediaSessionState[]>
处理对会话状态的请求。

参数

sessionId?
IMediaSessionId 可选。获取其状态的会话的会话ID。若未提供,则视为请求获取所有会话的数据。

返回值

Promise<MediaSessionState[]> 这是一个Promise,会在成功处理请求时正常完成;在请求失败时,则会返回一个错误并拒绝执行。
最后修改于 2026年8月25日