History log of /frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
Revision Date Author Comments (<<< Hide modified files) (Show modified files >>>)
bf1bbdfcb39667dfb3a98f5c14c118fab278ede0 18-Sep-2013 Jeff Brown <jeffbrown@google.com> Add queue actions, http header and duration metadata.

Bug: 10260186
Change-Id: I1356979f929d25f96133288d4fa1b3711890d04e
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
eff7719415542ba819054863b0995f07742a7a8a 10-Jul-2013 Jeff Brown <jeffbrown@google.com> Media router API updates.

Added a MediaRouteDialogFactory to make it easier for applications
to customize the dialog fragments such as adding custom views
into the media route controller dialog.

Added an API to disable volume control in the media route
controller dialog.

Added a method that the application can override to change how
routes are filtered in the chooser dialog.

Changed the remote playback protocol to isolate the queuing
feature and @hide it. This required a few semantic changes
to the protocol so that the non-queuing subset is able to
stand on its own and be coherent. Most of these changes are
simple renames and incremental changes of existing concepts
but the documentation had to be substantially updated to keep
it clear.

The protocol changes are roughly as follows.

- QUEUE_ID renamed to SESSION_ID. Sessions are created
implicitly by ACTION_PLAY just like queues but the concept is
somewhat more generic. The session is documented conceptually
as having a queue that can only contain at most one item which
makes it easier to explain certain behaviors. However, we
now deemphasize the concept of the queue in the documentation and
focus more on the session. Since the word "queue" no longer
appears in the API, we could go either way in the future and choose
to expand on or abandon the queue concept just by changing
the documentation.

- ACTION_STOP renamed to ACTION_REMOVE and now @hide. The action
removes one specific item from the queue.

- ACTION_CLEAR_QUEUE renamed to ACTION_STOP. Now documented to
have the side-effect of both clearing and unpausing the queue
like hitting a reset switch on the session. The choice of name
creates good symmetry with ACTION_PLAY in the single item case.

- ACTION_ENQUEUE (@hide) added to represent the previous
queuing behavior so that we can continue to experiment with it.
Support for this action might be optional in the future.

- ACTION_PLAY is documented in a way that makes it equivalent
to ACTION_STOP followed by ACTION_ENQUEUE. This way we enforce
the constraint that the queue can have at most one item in it
while still leaving the door open to exposing more features later.

- ACTION_PAUSE_QUEUE renamed to ACTION_PAUSE. We still refer to
it as conceptually pausing a queue but this now fits in better with
the one at a time nature of ACTION_PLAY.

- ACTION_RESUME_QUEUE renamed to ACTION_RESUME.

- PLAYBACK_STATE_QUEUED renamed to PLAYBACK_STATE_PENDING.

- PLAYBACK_STATE_STOPPED renamed to PLAYBACK_STATE_FINISHED to make
it clear that this state means the media item finished playing
normally.

- PLAYBACK_STATE_CANCELED now only means that the media item was
canceled by the app by way of ACTION_PLAY or ACTION_STOP
(or ACTION_REMOVE) which caused the item to be removed from the
queue before it had a chance to finish normally.

- PLAYBACK_STATE_INVALIDATED added to specifically refer to the
case where another application takes control of the route and
stomps on the session and its media items. The documentation now
consistently uses the word invalidate rather than cancel when
referring to sessions or media items that have been involuntarily
aborted by an external cause.

- @hide HTTP request headers, response headers and status code.

Bug: 9743462
Change-Id: I3bdb4cd8947112ab409983a74fa4bc062465149a
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
fb75232cb13b19004ec1189888b46767db20daf4 22-Jun-2013 Jeff Brown <jeffbrown@google.com> mediarouter: Improve HTTP status reporting.

Add support for reporting HTTP response headers in status
as an extra.
Make the HTTP status code an extra as well.

Bug: 9532200
Change-Id: I8c6340df27f23670d1a61fb71a0aa5cdbd338227
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
ba811896e3057cb48ad0f017efe1bf0c262430ec 12-Jun-2013 Jeff Brown <jeffbrown@google.com> Redefine content position in milliseconds instead of seconds.

Bug: 9380827
Change-Id: I92a2df6ae2aeb2257625d75c8ba9e0791568bf7e
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
de3d4d3c033fc939af83775a443b295a4034444c 08-Jun-2013 Jeff Brown <jeffbrown@google.com> Update media router remote playback protocol.

Introduce concept of queue ids to simplify the queuing story.

Bug: 9380827
Change-Id: Idd67cef36fbf26c01b04558907116bd1ecb91e2a
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
3d4c9459ed77f732dd3ba602713af6ebf9280c8c 21-May-2013 Jeff Brown <jeffbrown@google.com> Streamline media router API.

Merge progress and status and remove ACTION_GET_PROGRESS.

Add a new MediaItemStatus object to ensure that apps package the
status information correctly into the Bundle and to remove
possible ambiguity about the interpretation of each field.

Add EXTRA_ITEM_STATUS as a standard output result from
most requests include ACTION_PLAY, ACTION_PAUSE, etc.

Add a timestamp to the status object.

Add a mechanism for returning an error string from failed
media control requests.

Add a unique prefix to all mediarouter library resources
to make conflicts with application resources less likely.

Bug: 8175766
Change-Id: Ifca759424125ca62e8a72d35068dd3cc045d21ad
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java
43f79f79a5117550a7dfedf9c65124afd163ea43 12-Apr-2013 Jeff Brown <jeffbrown@google.com> Update media router API.

Use the nomenclature "media item" rather than "media stream"
to refer to playback requests to avoid confusion.

Add a STOP action.

Document that the status broadcasts should include the item id.

Bug: 8175766
Change-Id: Ideb5c674d48b4a5ba2cb276c19beaafda83900b5
/frameworks/support/v7/mediarouter/src/android/support/v7/media/MediaItemStatus.java