public static final class PlaybackStateCompat.Builder
extends Object
java.lang.Object | |
↳ | android.support.v4.media.session.PlaybackStateCompat.Builder |
为 PlaybackStateCompat
对象生成器。
Public constructors |
|
---|---|
PlaybackStateCompat.Builder() 创建一个空的生成器。 |
|
PlaybackStateCompat.Builder(PlaybackStateCompat source) 使用 |
Public methods |
|
---|---|
PlaybackStateCompat.Builder |
addCustomAction(String action, String name, int icon) 将自定义操作添加到播放状态。 |
PlaybackStateCompat.Builder |
addCustomAction(PlaybackStateCompat.CustomAction customAction) 将自定义操作添加到播放状态。 |
PlaybackStateCompat |
build() 创建播放状态对象。 |
PlaybackStateCompat.Builder |
setActions(long capabilities) 设置此会话中可用的当前功能。 |
PlaybackStateCompat.Builder |
setActiveQueueItemId(long id) 通过指定其ID,将活动项目设置在播放队列中。 |
PlaybackStateCompat.Builder |
setBufferedPosition(long bufferPosition) 以ms为单位设置当前缓冲位置。 |
PlaybackStateCompat.Builder |
setErrorMessage(CharSequence errorMessage) 设置用户可读的错误消息。 |
PlaybackStateCompat.Builder |
setExtras(Bundle extras) 设置任何自定义附加功能以包含在播放状态中。 |
PlaybackStateCompat.Builder |
setState(int state, long position, float playbackSpeed) 设置播放的当前状态。 |
PlaybackStateCompat.Builder |
setState(int state, long position, float playbackSpeed, long updateTime) 设置播放的当前状态。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
PlaybackStateCompat.Builder ()
创建一个空的生成器。
PlaybackStateCompat.Builder (PlaybackStateCompat source)
使用 PlaybackStateCompat
实例创建一个Builder来设置初始值。
Parameters | |
---|---|
source |
PlaybackStateCompat : The playback state to copy. |
PlaybackStateCompat.Builder addCustomAction (String action, String name, int icon)
将自定义操作添加到播放状态。 除了标准传输控件提供的功能之外,还可以使用操作向Controllers
提供其他功能。
例如根据当前项目启动广播电台或跳过30秒。
Parameters | |
---|---|
action |
String : An identifier for this action. It can be sent back to the MediaSessionCompat through sendCustomAction(String, Bundle) . |
name |
String : The display name for the action. If text is shown with the action or used for accessibility, this is what should be used. |
icon |
int : The resource action of the icon that should be displayed for the action. The resource should be in the package of the MediaSessionCompat . |
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder addCustomAction (PlaybackStateCompat.CustomAction customAction)
将自定义操作添加到播放状态。 除了标准传输控制提供的功能之外,可以使用操作向Controllers
公开其他功能。
一个举措的例子是根据当前项目启动广播电台或跳过30秒。
Parameters | |
---|---|
customAction |
PlaybackStateCompat.CustomAction : The custom action to add to the PlaybackStateCompat . |
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setActions (long capabilities)
设置此会话中可用的当前功能。 这应该使用可用功能的位掩码。
ACTION_SKIP_TO_PREVIOUS
ACTION_REWIND
ACTION_PLAY
ACTION_PLAY_PAUSE
ACTION_PAUSE
ACTION_STOP
ACTION_FAST_FORWARD
ACTION_SKIP_TO_NEXT
ACTION_SEEK_TO
ACTION_SET_RATING
ACTION_PLAY_FROM_MEDIA_ID
ACTION_PLAY_FROM_SEARCH
ACTION_SKIP_TO_QUEUE_ITEM
ACTION_PLAY_FROM_URI
ACTION_PREPARE
ACTION_PREPARE_FROM_MEDIA_ID
ACTION_PREPARE_FROM_SEARCH
ACTION_PREPARE_FROM_URI
Parameters | |
---|---|
capabilities |
long
|
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setActiveQueueItemId (long id)
通过指定其ID,将活动项目设置在播放队列中。 默认值是UNKNOWN_ID
Parameters | |
---|---|
id |
long : The id of the active item. |
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setBufferedPosition (long bufferPosition)
以ms为单位设置当前缓冲位置。 这是可以使用缓冲内容从当前位置到达的最远的播放点。
Parameters | |
---|---|
bufferPosition |
long
|
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setErrorMessage (CharSequence errorMessage)
设置用户可读的错误消息。 这应该在状态为STATE_ERROR
时设置。
Parameters | |
---|---|
errorMessage |
CharSequence
|
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setExtras (Bundle extras)
设置任何自定义附加功能以包含在播放状态中。
Parameters | |
---|---|
extras |
Bundle : The extras to include. |
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |
PlaybackStateCompat.Builder setState (int state, long position, float playbackSpeed)
设置播放的当前状态。
该位置必须以毫秒为单位并指示轨道中当前的播放位置。 如果位置未知,请使用PLAYBACK_POSITION_UNKNOWN
。
速率是正常播放的倍数,暂停时为0,倒带时为负。 正常播放速率为1.0。
国家必须是以下之一:
STATE_NONE
STATE_STOPPED
STATE_PLAYING
STATE_PAUSED
STATE_FAST_FORWARDING
STATE_REWINDING
STATE_BUFFERING
STATE_ERROR
STATE_CONNECTING
STATE_SKIPPING_TO_PREVIOUS
STATE_SKIPPING_TO_NEXT
STATE_SKIPPING_TO_QUEUE_ITEM
Parameters | |
---|---|
state |
int : The current state of playback. |
position |
long : The position in the current track in ms. |
playbackSpeed |
float : The current rate of playback as a multiple of normal playback. |
Returns | |
---|---|
PlaybackStateCompat.Builder |
PlaybackStateCompat.Builder setState (int state, long position, float playbackSpeed, long updateTime)
设置播放的当前状态。
该位置必须以毫秒为单位并指示轨道中当前的播放位置。 如果头寸未知,请使用PLAYBACK_POSITION_UNKNOWN
。
速率是正常播放的倍数,暂停时为0,倒带时为负。 正常播放速率为1.0。
国家必须是以下之一:
STATE_NONE
STATE_STOPPED
STATE_PLAYING
STATE_PAUSED
STATE_FAST_FORWARDING
STATE_REWINDING
STATE_BUFFERING
STATE_ERROR
STATE_CONNECTING
STATE_SKIPPING_TO_PREVIOUS
STATE_SKIPPING_TO_NEXT
STATE_SKIPPING_TO_QUEUE_ITEM
Parameters | |
---|---|
state |
int : The current state of playback. |
position |
long : The position in the current item in ms. |
playbackSpeed |
float : The current speed of playback as a multiple of normal playback. |
updateTime |
long : The time in the elapsedRealtime() timebase that the position was updated at. |
Returns | |
---|---|
PlaybackStateCompat.Builder |
this |