public static abstract class MediaSession.Callback
extends Object
java.lang.Object | |
↳ | android.media.session.MediaSession.Callback |
从控制器和系统接收媒体按钮,传输控制和命令。 回拨可以使用setCallback(MediaSession.Callback)
进行设置。
Public constructors |
|
---|---|
MediaSession.Callback() |
Public methods |
|
---|---|
void |
onCommand(String command, Bundle args, ResultReceiver cb) 当控制器向该会话发送命令时调用。 |
void |
onCustomAction(String action, Bundle extras) 当 |
void |
onFastForward() 重写以处理请求以快进。 |
boolean |
onMediaButtonEvent(Intent mediaButtonIntent) 当按下媒体按钮并且此会话具有最高优先级或控制器向会话发送媒体按钮事件时调用。 |
void |
onPause() 重写以处理暂停播放的请求。 |
void |
onPlay() 重写以处理开始播放的请求。 |
void |
onPlayFromMediaId(String mediaId, Bundle extras) 重写处理请求以播放由您的应用 |
void |
onPlayFromSearch(String query, Bundle extras) 覆盖以处理从搜索查询开始播放的请求。 |
void |
onPlayFromUri(Uri uri, Bundle extras) 重写以处理请求以播放由URI表示的特定媒体项目。 |
void |
onPrepare() 重写以处理准备播放的请求。 |
void |
onPrepareFromMediaId(String mediaId, Bundle extras) 覆盖处理请求以准备播放由您的应用 |
void |
onPrepareFromSearch(String query, Bundle extras) 重写以处理从搜索查询准备播放的请求。 |
void |
onPrepareFromUri(Uri uri, Bundle extras) 重写以处理准备由URI表示的特定媒体项目的请求。 |
void |
onRewind() 重写以处理请求后退。 |
void |
onSeekTo(long pos) 重写以处理请求,以毫秒为单位寻找特定的位置。 |
void |
onSetRating(Rating rating) 重写以处理被评价的项目。 |
void |
onSkipToNext() 覆盖处理请求以跳到下一个媒体项目。 |
void |
onSkipToPrevious() 覆盖处理请求以跳过前一个媒体项目。 |
void |
onSkipToQueueItem(long id) 重写处理请求,以播放来自播放队列的给定ID的项目。 |
void |
onStop() 覆盖以处理停止播放的请求。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
void onCommand (String command, Bundle args, ResultReceiver cb)
当控制器向该会话发送命令时调用。 会话的所有者可以处理自定义命令,但不是必需的。
Parameters | |
---|---|
command |
String : The command name. |
args |
Bundle : Optional parameters for the command, may be null. |
cb |
ResultReceiver : A result receiver to which a result may be sent by the command, may be null. |
void onCustomAction (String action, Bundle extras)
当 MediaController
想要执行 PlaybackState.CustomAction
时调用。
Parameters | |
---|---|
action |
String : The action that was originally sent in the PlaybackState.CustomAction . |
extras |
Bundle : Optional extras specified by the MediaController . |
boolean onMediaButtonEvent (Intent mediaButtonIntent)
当按下媒体按钮并且此会话具有最高优先级或控制器向会话发送媒体按钮事件时调用。 如果设置了该操作,则默认行为将调用相关方法。
意图将是 ACTION_MEDIA_BUTTON
中的KeyEvent类型为 EXTRA_KEY_EVENT
Parameters | |
---|---|
mediaButtonIntent |
Intent : an intent containing the KeyEvent as an extra |
Returns | |
---|---|
boolean |
True if the event was handled, false otherwise. |
void onPlayFromMediaId (String mediaId, Bundle extras)
重写处理请求以播放由您的应用 MediaBrowserService
提供的特定 MediaBrowserService
。
Parameters | |
---|---|
mediaId |
String
|
extras |
Bundle
|
void onPlayFromSearch (String query, Bundle extras)
覆盖以处理从搜索查询开始播放的请求。 一个空的查询表示该应用可能播放任何音乐。 实施应该尝试做出关于玩什么的明智选择。
Parameters | |
---|---|
query |
String
|
extras |
Bundle
|
void onPlayFromUri (Uri uri, Bundle extras)
重写以处理请求以播放由URI表示的特定媒体项目。
Parameters | |
---|---|
uri |
Uri
|
extras |
Bundle
|
void onPrepare ()
重写以处理准备播放的请求。 在准备过程中,会话不应该保持音频焦点,以便让其他会话无缝播放。 准备完成后,播放状态应更新为STATE_PAUSED
。
void onPrepareFromMediaId (String mediaId, Bundle extras)
重写处理请求以准备播放由应用MediaBrowserService
提供的特定MediaBrowserService
。 在准备过程中,会话不应该保持音频焦点,以便让其他会话无缝播放。 准备完成后,播放状态应更新为STATE_PAUSED
。 准备内容的回放应该在执行onPlay()
。 覆盖onPlayFromMediaId(String, Bundle)
以处理未经准备就开始播放的请求。
Parameters | |
---|---|
mediaId |
String
|
extras |
Bundle
|
void onPrepareFromSearch (String query, Bundle extras)
重写以处理从搜索查询准备播放的请求。 一个空的查询表明应用程序可以准备任何音乐。 实施应该尝试做出关于玩什么的明智选择。 在准备过程中,会话不应该保持音频焦点,以便让其他会话无缝播放。 准备完成后,播放状态应更新为STATE_PAUSED
。 准备内容的回放应该在执行onPlay()
。 覆盖onPlayFromSearch(String, Bundle)
以处理未经准备就开始播放的请求。
Parameters | |
---|---|
query |
String
|
extras |
Bundle
|
void onPrepareFromUri (Uri uri, Bundle extras)
重写以处理准备由URI表示的特定媒体项目的请求。 在准备过程中,会话不应该保持音频焦点,以便让其他会话无缝播放。 准备完成后,播放状态应更新为STATE_PAUSED
。 准备内容的回放应该在执行onPlay()
。 覆盖onPlayFromUri(Uri, Bundle)
以处理未经准备就开始播放的请求。
Parameters | |
---|---|
uri |
Uri
|
extras |
Bundle
|
void onSeekTo (long pos)
重写以处理请求,以毫秒为单位寻找特定的位置。
Parameters | |
---|---|
pos |
long : New position to move to, in milliseconds. |
void onSkipToQueueItem (long id)
重写处理请求,以播放来自播放队列的给定ID的项目。
Parameters | |
---|---|
id |
long
|