# MediaItemStatus added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) belongs to Maven artifact com.android.support:mediarouter-v7:28.0.0-alpha1 Summary:[Nested Classes](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#nestedclasses)\|[Constants](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#constants)\|[Methods](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#) # MediaItemStatus | This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings). ` public final class MediaItemStatus ` ` extends Object `` ` |---|------------------------------------------| | java.lang.Object || | ↳ | android.support.v7.media.MediaItemStatus |
*** ** * ** *** Describes the playback status of a media item. This class is part of the remote playback protocol described by the[MediaControlIntent](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent)class. As a media item is played, it transitions through a sequence of states including:[pending](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PENDING),[buffering](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_BUFFERING),[playing](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PLAYING),[paused](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PAUSED),[finished](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_FINISHED),[canceled](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_CANCELED),[invalidated](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_INVALIDATED), and[error](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_ERROR). Refer to the documentation of each state for an explanation of its meaning. While the item is playing, the playback status may also include progress information about the[content position](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getContentPosition())and[content duration](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getContentDuration())although not all route destinations will report it. To monitor playback status, the application should supply a[PendingIntent](https://developer.android.com/reference/android/app/PendingIntent.html)to use as the[item status update receiver](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#EXTRA_ITEM_STATUS_UPDATE_RECEIVER)for a given[playback request](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY). Note that the status update receiver will only be invoked for major status changes such as a transition from playing to finished. The status update receiver will not be invoked for minor progress updates such as changes to playback position or duration. If the application wants to monitor playback progress, then it must use the[get status request](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_GET_STATUS)to poll for changes periodically and estimate the playback position while playing. Note that there may be a significant power impact to polling so the application is advised only to poll when the screen is on and never more than about once every 5 seconds or so. This object is immutable once created using a[MediaItemStatus.Builder](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus.Builder)instance.
## Summary | ### Nested classes || |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` class` | [MediaItemStatus.Builder](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus.Builder) Builder for[media item status objects](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus). | | ### Constants || |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `String` | [EXTRA_HTTP_RESPONSE_HEADERS](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#EXTRA_HTTP_RESPONSE_HEADERS) Bundle extra: HTTP response headers. | | `String` | [EXTRA_HTTP_STATUS_CODE](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#EXTRA_HTTP_STATUS_CODE) Integer extra: HTTP status code. | | `int` | [PLAYBACK_STATE_BUFFERING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_BUFFERING) Playback state: Buffering or seeking to a new position. | | `int` | [PLAYBACK_STATE_CANCELED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_CANCELED) Playback state: Canceled. | | `int` | [PLAYBACK_STATE_ERROR](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_ERROR) Playback state: Playback halted or aborted due to an error. | | `int` | [PLAYBACK_STATE_FINISHED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_FINISHED) Playback state: Finished. | | `int` | [PLAYBACK_STATE_INVALIDATED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_INVALIDATED) Playback state: Invalidated. | | `int` | [PLAYBACK_STATE_PAUSED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PAUSED) Playback state: Paused. | | `int` | [PLAYBACK_STATE_PENDING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PENDING) Playback state: Pending. | | `int` | [PLAYBACK_STATE_PLAYING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PLAYING) Playback state: Playing. | | ### Public methods || |---------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Bundle](https://developer.android.com/reference/android/os/Bundle.html) | ` `[asBundle](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#asBundle())`() ` Converts this object to a bundle for serialization. | | ` static `[MediaItemStatus](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus) | ` `[fromBundle](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#fromBundle(android.os.Bundle))`(`[Bundle](https://developer.android.com/reference/android/os/Bundle.html)` bundle) ` Creates an instance from a bundle. | | ` long` | ` `[getContentDuration](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getContentDuration())`() ` Gets the total duration of the content to be played as a long integer number of milliseconds. | | ` long` | ` `[getContentPosition](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getContentPosition())`() ` Gets the content playback position as a long integer number of milliseconds from the beginning of the content. | | ` `[Bundle](https://developer.android.com/reference/android/os/Bundle.html) | ` `[getExtras](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getExtras())`() ` Gets a bundle of extras for this status object. | | ` int` | ` `[getPlaybackState](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getPlaybackState())`() ` Gets the playback state of the media item. | | ` long` | ` `[getTimestamp](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#getTimestamp())`() ` Gets the timestamp associated with the status information in milliseconds since boot in the[elapsedRealtime()](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())time base. | | ` String` | ` `[toString](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#toString())`() ` | | ### Inherited methods | |-----------------------|---| | [![](https://developer.android.com/static/assets/images/styles/disclosure_down.png)](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#)From class` java.lang.Object ` |-------------------|-------------------------------| | ` Object` | ` clone() ` | | ` boolean` | ` equals(Object arg0) ` | | ` void` | ` finalize() ` | | ` final Class` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` String` | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | || ## Constants ### EXTRA_HTTP_RESPONSE_HEADERS added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` String EXTRA_HTTP_RESPONSE_HEADERS ``` Bundle extra: HTTP response headers. Specifies the HTTP response headers that were returned when the content was requested from the network. The headers may include additional information about the content or any errors conditions that were encountered while trying to fetch the content. The value is a[Bundle](https://developer.android.com/reference/android/os/Bundle.html)of string based key-value pairs that describe the HTTP response headers.

Constant Value: "android.media.status.extra.HTTP_RESPONSE_HEADERS" ### EXTRA_HTTP_STATUS_CODE added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` String EXTRA_HTTP_STATUS_CODE ``` Integer extra: HTTP status code. Specifies the HTTP status code that was encountered when the content was requested after all redirects were followed. This key only needs to specified when the content uri uses the HTTP or HTTPS scheme and an error occurred. This key may be omitted if the content was able to be played successfully; there is no need to report a 200 (OK) status code. The value is an integer HTTP status code, such as 401 (Unauthorized), 404 (Not Found), or 500 (Server Error), or 0 if none.

Constant Value: "android.media.status.extra.HTTP_STATUS_CODE" ### PLAYBACK_STATE_BUFFERING added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_BUFFERING ``` Playback state: Buffering or seeking to a new position. Indicates that the media item has been temporarily interrupted to fetch more content. Playback will continue automatically when enough content has been buffered.

Constant Value: 3 (0x00000003) ### PLAYBACK_STATE_CANCELED added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_CANCELED ``` Playback state: Canceled. Indicates that the media item was explicitly removed from the queue by the application. Items may be canceled and removed from the queue using the[remove](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_REMOVE)or[stop](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_STOP)action or by issuing another[play](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY)action that has the side-effect of clearing the queue. A canceled media item cannot be resumed. To play the content again, the application must send a new[play](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY)or[enqueue](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_ENQUEUE)action.

Constant Value: 5 (0x00000005) ### PLAYBACK_STATE_ERROR added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_ERROR ``` Playback state: Playback halted or aborted due to an error. Examples of errors are no network connectivity when attempting to retrieve content from a server, or expired user credentials when trying to play subscription-based content. A media item in the error state cannot be resumed. To play the content again, the application must send a new[play](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY)or[enqueue](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_ENQUEUE)action.

Constant Value: 7 (0x00000007) ### PLAYBACK_STATE_FINISHED added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_FINISHED ``` Playback state: Finished. Indicates that the media item played to the end of the content and finished normally. A finished media item cannot be resumed. To play the content again, the application must send a new[play](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY)or[enqueue](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_ENQUEUE)action.

Constant Value: 4 (0x00000004) ### PLAYBACK_STATE_INVALIDATED added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_INVALIDATED ``` Playback state: Invalidated. Indicates that the media item was invalidated permanently and involuntarily. This state is used to indicate that the media item was invalidated and removed from the queue because the session to which it belongs was invalidated (typically by another application taking control of the route). When invalidation occurs, the application should generally wait for the user to perform an explicit action, such as clicking on a play button in the UI, before creating a new media session to avoid unnecessarily interrupting another application that may have just started using the route. An invalidated media item cannot be resumed. To play the content again, the application must send a new[play](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_PLAY)or[enqueue](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_ENQUEUE)action.

Constant Value: 6 (0x00000006) ### PLAYBACK_STATE_PAUSED added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_PAUSED ``` Playback state: Paused. Indicates that playback of the media item has been paused. Playback can be resumed using the[resume](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent#ACTION_RESUME)action.

Constant Value: 2 (0x00000002) ### PLAYBACK_STATE_PENDING added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_PENDING ``` Playback state: Pending. Indicates that the media item has not yet started playback but will be played eventually.

Constant Value: 0 (0x00000000) ### PLAYBACK_STATE_PLAYING added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int PLAYBACK_STATE_PLAYING ``` Playback state: Playing. Indicates that the media item is currently playing.

Constant Value: 1 (0x00000001) ## Public methods ### asBundle added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` Bundle asBundle () ``` Converts this object to a bundle for serialization.
| Returns || |--------------------------------------------------------------------------|------------------------------------------------------------| | [Bundle](https://developer.android.com/reference/android/os/Bundle.html) | The contents of the object represented as a bundle.
| ### fromBundle added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` MediaItemStatus fromBundle (Bundle bundle) ``` Creates an instance from a bundle.
| Parameters || |----------|-----------------------------------------------| | `bundle` | `Bundle`: The bundle, or null if none.
| | Returns || |-----------------------------------------------------------------------------------------------------|----------------------------------------------------------| | [MediaItemStatus](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus) | The new instance, or null if the bundle was null.
| ### getContentDuration added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` long getContentDuration () ``` Gets the total duration of the content to be played as a long integer number of milliseconds.
| Returns || |--------|----------------------------------------------------------------| | `long` | The content duration in milliseconds, or -1 if unknown.
| ### getContentPosition added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` long getContentPosition () ``` Gets the content playback position as a long integer number of milliseconds from the beginning of the content.
| Returns || |--------|-------------------------------------------------------------------------| | `long` | The content playback position in milliseconds, or -1 if unknown.
| ### getExtras added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` Bundle getExtras () ``` Gets a bundle of extras for this status object. The extras will be ignored by the media router but they may be used by applications.
| Returns || |--------------------------------------------------------------------------|--------| | [Bundle](https://developer.android.com/reference/android/os/Bundle.html) |
| ### getPlaybackState added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` int getPlaybackState () ``` Gets the playback state of the media item.
| Returns || |-------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | The playback state. One of[PLAYBACK_STATE_PENDING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PENDING),[PLAYBACK_STATE_PLAYING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PLAYING),[PLAYBACK_STATE_PAUSED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_PAUSED),[PLAYBACK_STATE_BUFFERING](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_BUFFERING),[PLAYBACK_STATE_FINISHED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_FINISHED),[PLAYBACK_STATE_CANCELED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_CANCELED),[PLAYBACK_STATE_INVALIDATED](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_INVALIDATED), or[PLAYBACK_STATE_ERROR](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus#PLAYBACK_STATE_ERROR).
| ### getTimestamp added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions) ``` long getTimestamp () ``` Gets the timestamp associated with the status information in milliseconds since boot in the[elapsedRealtime()](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())time base.
| Returns || |--------|--------------------------------------------------------------------------------------------------------------------------------------------------------| | `long` | The status timestamp in the[elapsedRealtime()](https://developer.android.com/reference/android/os/SystemClock.html#elapsedRealtime())time base.
| ### toString ``` String toString () ```

| Returns || |----------|--------| | `String` |
| - ## Interfaces - [RemotePlaybackClient.OnMessageReceivedListener](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient.OnMessageReceivedListener) - ## Classes - [MediaControlIntent](https://developer.android.com/reference/android/support/v7/media/MediaControlIntent) - [MediaItemMetadata](https://developer.android.com/reference/android/support/v7/media/MediaItemMetadata) - [MediaItemStatus](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus) - [MediaItemStatus.Builder](https://developer.android.com/reference/android/support/v7/media/MediaItemStatus.Builder) - [MediaRouteDescriptor](https://developer.android.com/reference/android/support/v7/media/MediaRouteDescriptor) - [MediaRouteDescriptor.Builder](https://developer.android.com/reference/android/support/v7/media/MediaRouteDescriptor.Builder) - [MediaRouteDiscoveryRequest](https://developer.android.com/reference/android/support/v7/media/MediaRouteDiscoveryRequest) - [MediaRouteProvider](https://developer.android.com/reference/android/support/v7/media/MediaRouteProvider) - [MediaRouteProvider.Callback](https://developer.android.com/reference/android/support/v7/media/MediaRouteProvider.Callback) - [MediaRouteProvider.ProviderMetadata](https://developer.android.com/reference/android/support/v7/media/MediaRouteProvider.ProviderMetadata) - [MediaRouteProvider.RouteController](https://developer.android.com/reference/android/support/v7/media/MediaRouteProvider.RouteController) - [MediaRouteProviderDescriptor](https://developer.android.com/reference/android/support/v7/media/MediaRouteProviderDescriptor) - [MediaRouteProviderDescriptor.Builder](https://developer.android.com/reference/android/support/v7/media/MediaRouteProviderDescriptor.Builder) - [MediaRouteProviderService](https://developer.android.com/reference/android/support/v7/media/MediaRouteProviderService) - [MediaRouter](https://developer.android.com/reference/android/support/v7/media/MediaRouter) - [MediaRouter.Callback](https://developer.android.com/reference/android/support/v7/media/MediaRouter.Callback) - [MediaRouter.ControlRequestCallback](https://developer.android.com/reference/android/support/v7/media/MediaRouter.ControlRequestCallback) - [MediaRouter.ProviderInfo](https://developer.android.com/reference/android/support/v7/media/MediaRouter.ProviderInfo) - [MediaRouter.RouteInfo](https://developer.android.com/reference/android/support/v7/media/MediaRouter.RouteInfo) - [MediaRouteSelector](https://developer.android.com/reference/android/support/v7/media/MediaRouteSelector) - [MediaRouteSelector.Builder](https://developer.android.com/reference/android/support/v7/media/MediaRouteSelector.Builder) - [MediaSessionStatus](https://developer.android.com/reference/android/support/v7/media/MediaSessionStatus) - [MediaSessionStatus.Builder](https://developer.android.com/reference/android/support/v7/media/MediaSessionStatus.Builder) - [RemotePlaybackClient](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient) - [RemotePlaybackClient.ActionCallback](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient.ActionCallback) - [RemotePlaybackClient.ItemActionCallback](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient.ItemActionCallback) - [RemotePlaybackClient.SessionActionCallback](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient.SessionActionCallback) - [RemotePlaybackClient.StatusCallback](https://developer.android.com/reference/android/support/v7/media/RemotePlaybackClient.StatusCallback)