Lines Matching defs:media
17 package android.support.v7.media;
24 * Constants for media control intents.
26 * This class declares a set of standard media control intent categories and actions that
27 * applications can use to identify the capabilities of media routes and control them.
33 * send media to the destination of a media route. Categories are sometimes referred
37 * then an application can ask it to play media remotely by sending a
39 * media content to play. Such a route may then be referred to as
55 * remote playback requests for media content to the destination. The content to be
58 * Media route providers may define custom media control intent categories of their own in
61 * a media route provider might define a custom category to indicate that its routes
69 * creating {@link MediaRouteSelector media route selectors} that contain the desired
70 * categories and are used to filter routes in several parts of the media router API.
76 * can ask the destination of a media route to perform. Media route control requests
78 * or send broadcasts. The difference is that media control intents are directed to
81 * Each media route control intent specifies an action, a category and some number of parameters
82 * that are supplied as extras. Applications send media control requests to routes using the
86 * All media control intent actions are associated with the media control intent categories
95 * routes present media using standard system interfaces such as audio streams,
108 * {@link #CATEGORY_REMOTE_PLAYBACK Remote playback} routes present media remotely
112 * send control requests to initiate play, pause, resume, or stop media items and receive
118 * Each remote media playback action is conducted within the scope of a session.
134 * media playback is stopped before the requested action is performed. Any attempt
146 * returns a unique media item id that an application can use to monitor and control
147 * playback. The media item id may be passed to other actions such as
151 * Each media item is scoped to the session in which it was created. Therefore media item
153 * on their own. When the session is invalidated, all of its media items are also
159 * Each session has its own playback queue that consists of the media items that
164 * As described in the {@link MediaItemStatus} class, media items initially
193 * new media item to be played immediately. Play is therefore equivalent
209 * will be informed that it has lost control by way of individual media item status
210 * update broadcasts that indicate that its queued media items have become
228 * and returns a new media item id to describe the request. Implicitly creates a new
230 * <li>{@link #ACTION_SEEK Seek}: Sets the content playback position of a specific media item.
231 * <li>{@link #ACTION_GET_STATUS Get status}: Gets the status of a media item
245 * and returns a new media item id to describe the request. Implicitly creates a new
247 * <li>{@link #ACTION_REMOVE Remove}: Removes a specified media item from the queue.
266 * Compliant media route provider implementations of this protocol must support all
276 * A route that supports live audio routing will allow the media audio stream
281 * All audio played on the media stream will be routed to the selected destination.
286 public static final String CATEGORY_LIVE_AUDIO = "android.media.intent.category.LIVE_AUDIO";
308 public static final String CATEGORY_LIVE_VIDEO = "android.media.intent.category.LIVE_VIDEO";
318 * playing on the destination by sending media control actions to the route.
328 "android.media.intent.category.REMOTE_PLAYBACK";
333 * Remote playback media control action: Play media item.
336 * media control.
340 * The action returns a media session id and media item id which can be used
345 * of the media item changes.
363 * to enqueue a new media item to be played immediately.
368 * This request has the effect of implicitly creating a media session whenever the
371 * has the side-effect of invalidating any existing sessions and their media items,
383 * For more information on sessions, queues and media items, please refer to the
399 * about the media item.
408 * omit this key)</em>: Specifies the status of the media session.
410 * to use to refer to the media item in subsequent requests such as
413 * the new media item.
420 * then the media route provider is responsible for sending status updates to the receiver
421 * when significant media item state changes occur such as when playback starts or
472 public static final String ACTION_PLAY = "android.media.intent.action.PLAY";
475 * Remote playback media control action: Enqueue media item.
478 * media control.
482 * new media item into the session's playback queue. This action only
483 * enqueues a media item with no other side-effects on the queue.
496 public static final String ACTION_ENQUEUE = "android.media.intent.action.ENQUEUE";
499 * Remote playback media control action: Seek media item to a new playback position.
502 * media control.
505 * of the specified media item.
507 * This action only affects the playback position of the media item; not its playback state.
514 * If successful, the media item's playback position is changed.
520 * to which the media item belongs.
521 * <li>{@link #EXTRA_ITEM_ID} <em>(required)</em>: Specifies the media item id of
522 * the media item to seek.
531 * omit this key)</em>: Specifies the status of the media session.
533 * the media item.
538 * This action returns an error if the session id or media item id are unknown
539 * or no longer valid, if the content position is invalid, or if the media item
548 public static final String ACTION_SEEK = "android.media.intent.action.SEEK";
551 * Remote playback media control action: Get media item playback status
555 * media control.
558 * information about the specified media item.
564 * to which the media item belongs.
565 * <li>{@link #EXTRA_ITEM_ID} <em>(required)</em>: Specifies the media item id of
566 * the media item to query.
572 * omit this key)</em>: Specifies the status of the media session.
574 * the media item.
579 * This action returns an error if the session id or media item id are unknown
589 public static final String ACTION_GET_STATUS = "android.media.intent.action.GET_STATUS";
592 * Remote playback media control action: Remove media item from session's queue.
595 * media control.
597 * This action asks a remote playback route to remove the specified media item
599 * playback will proceed to the next media item (assuming the queue has not been
610 * to which the media item belongs.
611 * <li>{@link #EXTRA_ITEM_ID} <em>(required)</em>: Specifies the media item id of
612 * the media item to remove.
618 * omit this key)</em>: Specifies the status of the media session.
620 * the media item.
625 * This action returns an error if the session id or media item id are unknown
626 * or no longer valid, or if the media item is in a terminal state (and therefore
635 public static final String ACTION_REMOVE = "android.media.intent.action.REMOVE";
640 * Remote playback media control action: Pause media playback.
643 * media control.
657 * omit this key)</em>: Specifies the status of the media session.
671 public static final String ACTION_PAUSE = "android.media.intent.action.PAUSE";
674 * Remote playback media control action: Resume media playback (unpause).
677 * media control.
692 * omit this key)</em>: Specifies the status of the media session.
706 public static final String ACTION_RESUME = "android.media.intent.action.RESUME";
709 * Remote playback media control action: Stop media playback (clear queue and unpause).
712 * media control.
715 * all media items from the session's media item queue and, reset the queue's
718 * If successful, the status of all media items in the queue is set to
732 * omit this key)</em>: Specifies the status of the media session.
745 public static final String ACTION_STOP = "android.media.intent.action.STOP";
748 * Remote playback media control action: Start session.
751 * media control.
756 * If successful, the status of all media items in the previous session's queue is set to
767 * about the media session.
776 * status of the media session.
783 * then the media route provider is responsible for sending status updates to the receiver
784 * when significant media session state changes occur such as when the session's
800 public static final String ACTION_START_SESSION = "android.media.intent.action.START_SESSION";
803 * Remote playback media control action: Get media session status information.
806 * media control.
809 * about the specified media session.
821 * current status of the media session.
836 "android.media.intent.action.GET_SESSION_STATUS";
839 * Remote playback media control action: End session.
842 * media control.
852 * Additionally, the status of all media items in the queue is set to
866 * status of the media session.
881 public static final String ACTION_END_SESSION = "android.media.intent.action.END_SESSION";
888 * An opaque unique identifier that identifies the remote playback media session.
890 * Used with various actions to specify the id of the media session to be controlled.
900 * The value is a unique string value generated by the media route provider
901 * to represent one particular media session.
915 "android.media.intent.extra.SESSION_ID";
920 * Returned as a result from media session actions such as {@link #ACTION_START_SESSION},
922 * to describe the status of the specified media session.
944 "android.media.intent.extra.SESSION_STATUS";
950 * broadcast receiver that will receive status updates about the media session.
952 * Whenever the status of the media session changes, the media route provider will
970 "android.media.intent.extra.SESSION_STATUS_UPDATE_RECEIVER";
976 * {@link #ACTION_ENQUEUE} that represents the media item that was created by the
979 * Used with various actions to specify the id of the media item to be controlled.
985 * The value is a unique string value generated by the media route provider
986 * to represent one particular media item.
995 "android.media.intent.extra.ITEM_ID";
1000 * Returned as a result from media item actions such as {@link #ACTION_PLAY},
1002 * to describe the status of the specified media item.
1019 "android.media.intent.extra.ITEM_STATUS";
1037 "android.media.intent.extra.ITEM_POSITION";
1043 * associated with the content of a media item.
1053 "android.media.intent.extra.ITEM_METADATA";
1059 * headers to be included when fetching to the content indicated by the media
1063 * parameters to the server separately from the media item's data Uri.
1073 "android.media.intent.extra.HTTP_HEADERS";
1081 * media item.
1083 * Whenever the status of the media item changes, the media route provider will
1089 * media items since the broadcast intent includes the media session id
1090 * and media item id.
1100 * omit this key)</em>: Specifies the status of the media session.
1101 * <li>{@link #EXTRA_ITEM_ID} <em>(required)</em>: Specifies the media item id of the
1102 * media item in question.
1111 "android.media.intent.extra.ITEM_STATUS_UPDATE_RECEIVER";
1116 * Used with all media control requests to describe the cause of an error.
1123 public static final String EXTRA_ERROR_CODE = "android.media.intent.extra.ERROR_CODE";