public final class PlaybackStateCompat
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.support.v4.media.session.PlaybackStateCompat |
播放状态为MediaSessionCompat
。 这包括像STATE_PLAYING
这样的状态,当前播放位置以及当前的控制功能。
Nested classes |
|
---|---|
class |
PlaybackStateCompat.Builder 为 |
class |
PlaybackStateCompat.CustomAction |
Constants |
|
---|---|
long |
ACTION_FAST_FORWARD 表示此会话支持快进命令。 |
long |
ACTION_PAUSE 表示此会话支持暂停命令。 |
long |
ACTION_PLAY 表示此会话支持播放命令。 |
long |
ACTION_PLAY_FROM_MEDIA_ID 表示此会话支持从媒体id命令播放。 |
long |
ACTION_PLAY_FROM_SEARCH 表示此会话支持来自搜索命令的播放。 |
long |
ACTION_PLAY_FROM_URI 表示此会话支持来自URI命令的播放。 |
long |
ACTION_PLAY_PAUSE 表示此会话支持播放/暂停切换命令。 |
long |
ACTION_PREPARE 表示此会话支持prepare命令。 |
long |
ACTION_PREPARE_FROM_MEDIA_ID 指示此会话支持从媒体id命令准备。 |
long |
ACTION_PREPARE_FROM_SEARCH 表示此会话支持从搜索命令准备。 |
long |
ACTION_PREPARE_FROM_URI 表示此会话支持从URI准备命令。 |
long |
ACTION_REWIND 表示此会话支持倒带命令。 |
long |
ACTION_SEEK_TO 表示此会话支持寻求命令。 |
long |
ACTION_SET_RATING 表示此会话支持set rating命令。 |
long |
ACTION_SKIP_TO_NEXT 表示此会话支持下一个命令。 |
long |
ACTION_SKIP_TO_PREVIOUS 指示此会话支持上一个命令。 |
long |
ACTION_SKIP_TO_QUEUE_ITEM 表示此会话支持跳转到队列项目命令。 |
long |
ACTION_STOP 表示此会话支持停止命令。 |
long |
PLAYBACK_POSITION_UNKNOWN 使用此值表示位置未知。 |
int |
STATE_BUFFERING 指示此项目的状态当前正在缓冲,并且将在足够的数据已经缓冲时开始播放。 |
int |
STATE_CONNECTING 指示正在进行回放的班级的状态当前正在连接到路线。 |
int |
STATE_ERROR 指示此项目的状态当前处于错误状态。 |
int |
STATE_FAST_FORWARDING 指示此项目的状态当前正在快进。 |
int |
STATE_NONE 这是默认的播放状态,表示尚未添加媒体,或者表演者已重置且没有要播放的内容。 |
int |
STATE_PAUSED 指示此项目的状态当前已暂停。 |
int |
STATE_PLAYING 指示此项目正在播放的状态。 |
int |
STATE_REWINDING 指示此项目的状态当前正在倒带。 |
int |
STATE_SKIPPING_TO_NEXT 表示玩家正在跳到下一个项目的状态。 |
int |
STATE_SKIPPING_TO_PREVIOUS 显示玩家当前正在跳到前一个项目的状态。 |
int |
STATE_SKIPPING_TO_QUEUE_ITEM 指示玩家当前正在跳到队列中特定项目的状态。 |
int |
STATE_STOPPED 指示此项目的状态当前已停止。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<PlaybackStateCompat> |
CREATOR |
Public methods |
|
---|---|
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
static PlaybackStateCompat |
fromPlaybackState(Object stateObj) 从框架 |
long |
getActions() 获取本次会议上可用的当前操作。 |
long |
getActiveQueueItemId() 获取队列中当前活动项目的ID。 |
long |
getBufferedPosition() 以毫秒为单位获取当前缓冲位置。 |
List<PlaybackStateCompat.CustomAction> |
getCustomActions() 获取自定义操作的列表。 |
CharSequence |
getErrorMessage() 获取用户可读的错误消息。 |
Bundle |
getExtras() 获取在此播放状态下设置的任何自定义附加功能。 |
long |
getLastPositionUpdateTime() 获取上次更新位置所用的实时时间。 |
float |
getPlaybackSpeed() 获取当前播放速度为正常播放的倍数。 |
Object |
getPlaybackState() 获取底层框架 |
long |
getPosition() 以毫秒为单位获取当前播放位置。 |
int |
getState() 获取当前的播放状态。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
long ACTION_FAST_FORWARD
表示此会话支持快进命令。
也可以看看:
常量值:64(0x0000000000000040)
long ACTION_PLAY_FROM_MEDIA_ID
表示此会话支持从媒体id命令播放。
也可以看看:
常量值:1024(0x0000000000000400)
long ACTION_PLAY_FROM_SEARCH
表示此会话支持来自搜索命令的播放。
也可以看看:
常量值:2048(0x0000000000000800)
long ACTION_PLAY_FROM_URI
表示此会话支持来自URI命令的播放。
也可以看看:
常量值:8192(0x0000000000002000)
long ACTION_PLAY_PAUSE
表示此会话支持播放/暂停切换命令。
也可以看看:
常量值:512(0x0000000000000200)
long ACTION_PREPARE
表示此会话支持prepare命令。
也可以看看:
常量值:16384(0x0000000000004000)
long ACTION_PREPARE_FROM_MEDIA_ID
指示此会话支持从媒体id命令准备。
也可以看看:
常量值:32768(0x0000000000008000)
long ACTION_PREPARE_FROM_SEARCH
表示此会话支持从搜索命令准备。
也可以看看:
常量值:65536(0x0000000000010000)
long ACTION_PREPARE_FROM_URI
表示此会话支持从URI准备命令。
也可以看看:
常量值:131072(0x0000000000020000)
long ACTION_SET_RATING
表示此会话支持set rating命令。
也可以看看:
常量值:128(0x0000000000000080)
long ACTION_SKIP_TO_NEXT
表示此会话支持下一个命令。
也可以看看:
常量值:32(0x0000000000000020)
long ACTION_SKIP_TO_PREVIOUS
指示此会话支持上一个命令。
也可以看看:
常量值:16(0x0000000000000010)
long ACTION_SKIP_TO_QUEUE_ITEM
表示此会话支持跳转到队列项目命令。
也可以看看:
常量值:4096(0x0000000000001000)
long PLAYBACK_POSITION_UNKNOWN
使用此值表示位置未知。
常量值:-1(0xffffffffffffffff)
int STATE_BUFFERING
指示此项目的状态当前正在缓冲,并且将在足够的数据已经缓冲时开始播放。
也可以看看:
常数值:6(0x00000006)
int STATE_CONNECTING
指示正在进行回放的班级的状态当前正在连接到路线。 根据实施情况,您可能会在连接完成时返回到先前的状态或输入STATE_NONE
。 如果连接失败,应使用STATE_ERROR
。
在API 21之前的设备上,这将显示为 STATE_BUFFERING
也可以看看:
常量值:8(0x00000008)
int STATE_ERROR
指示此项目的状态当前处于错误状态。 进入此状态时,还应设置错误消息。
也可以看看:
常量值:7(0x00000007)
int STATE_FAST_FORWARDING
指示此项目的状态当前正在快进。
也可以看看:
常量值:4(0x00000004)
int STATE_NONE
这是默认的播放状态,表示尚未添加媒体,或者表演者已重置且没有要播放的内容。
也可以看看:
常量值:0(0x00000000)
int STATE_REWINDING
指示此项目的状态当前正在倒带。
也可以看看:
常量值:5(0x00000005)
int STATE_SKIPPING_TO_NEXT
表示玩家正在跳到下一个项目的状态。
也可以看看:
常量值:10(0x0000000a)
int STATE_SKIPPING_TO_PREVIOUS
显示玩家当前正在跳到前一个项目的状态。
也可以看看:
常量值:9(0x00000009)
int STATE_SKIPPING_TO_QUEUE_ITEM
指示玩家当前正在跳到队列中特定项目的状态。
在API 21之前的设备上,这将显示为 STATE_SKIPPING_TO_NEXT
也可以看看:
常量值:11(0x0000000b)
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
PlaybackStateCompat fromPlaybackState (Object stateObj)
从框架 PlaybackState
对象创建一个实例。
此方法仅在API 21+上受支持。
Parameters | |
---|---|
stateObj |
Object : A PlaybackState object, or null if none. |
Returns | |
---|---|
PlaybackStateCompat |
An equivalent PlaybackStateCompat object, or null if none. |
long getActions ()
获取本次会议上可用的当前操作。 这应该使用可用操作的位掩码。
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
Returns | |
---|---|
long |
long getActiveQueueItemId ()
获取队列中当前活动项目的ID。 如果没有队列或会话不支持队列,则这将是UNKNOWN_ID
。
Returns | |
---|---|
long |
The id of the currently active item in the queue or UNKNOWN_ID . |
long getBufferedPosition ()
以毫秒为单位获取当前缓冲位置。 这是可以使用缓冲内容从当前位置到达的最远的播放点。
Returns | |
---|---|
long |
List<PlaybackStateCompat.CustomAction> getCustomActions ()
获取自定义操作的列表。
Returns | |
---|---|
List<PlaybackStateCompat.CustomAction> |
CharSequence getErrorMessage ()
获取用户可读的错误消息。 这应该在状态为STATE_ERROR
时设置。
Returns | |
---|---|
CharSequence |
Bundle getExtras ()
获取在此播放状态下设置的任何自定义附加功能。
Returns | |
---|---|
Bundle |
The extras for this state or null. |
long getLastPositionUpdateTime ()
获取上次更新位置所用的实时时间。 如果位置从未设置,则返回0;
Returns | |
---|---|
long |
The last time the position was updated. |
float getPlaybackSpeed ()
获取当前播放速度为正常播放的倍数。 倒带时这应该是负面的。 值1表示正常播放,0表示暂停。
Returns | |
---|---|
float |
The current speed of playback. |
Object getPlaybackState ()
获取底层框架 PlaybackState
对象。
This method is only supported on API 21+.
Returns | |
---|---|
Object |
An equivalent PlaybackState object, or null if none. |
long getPosition ()
以毫秒为单位获取当前播放位置。
Returns | |
---|---|
long |
int getState ()
获取当前的播放状态。 以下之一:
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
dest |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |