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) |
|
|---|---|
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_PREVIOUSACTION_REWINDACTION_PLAYACTION_PLAY_PAUSEACTION_PAUSEACTION_STOPACTION_FAST_FORWARDACTION_SKIP_TO_NEXTACTION_SEEK_TOACTION_SET_RATINGACTION_PLAY_FROM_MEDIA_IDACTION_PLAY_FROM_SEARCHACTION_SKIP_TO_QUEUE_ITEMACTION_PLAY_FROM_URIACTION_PREPAREACTION_PREPARE_FROM_MEDIA_IDACTION_PREPARE_FROM_SEARCHACTION_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_NONESTATE_STOPPEDSTATE_PLAYINGSTATE_PAUSEDSTATE_FAST_FORWARDINGSTATE_REWINDINGSTATE_BUFFERINGSTATE_ERRORSTATE_CONNECTINGSTATE_SKIPPING_TO_PREVIOUSSTATE_SKIPPING_TO_NEXTSTATE_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_NONESTATE_STOPPEDSTATE_PLAYINGSTATE_PAUSEDSTATE_FAST_FORWARDINGSTATE_REWINDINGSTATE_BUFFERINGSTATE_ERRORSTATE_CONNECTINGSTATE_SKIPPING_TO_PREVIOUSSTATE_SKIPPING_TO_NEXTSTATE_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 |