public
final
class
MediaRouteDescriptor
extends Object
java.lang.Object | |
↳ | android.support.v7.media.MediaRouteDescriptor |
Describes the properties of a route.
Each route is uniquely identified by an opaque id string. This token may take any form as long as it is unique within the media route provider.
This object is immutable once created using a MediaRouteDescriptor.Builder
instance.
Nested classes | |
---|---|
class |
MediaRouteDescriptor.Builder
Builder for |
Public methods | |
---|---|
Bundle
|
asBundle()
Converts this object to a bundle for serialization. |
boolean
|
canDisconnectAndKeepPlaying()
Gets whether the route can be disconnected without stopping playback. |
static
MediaRouteDescriptor
|
fromBundle(Bundle bundle)
Creates an instance from a bundle. |
int
|
getConnectionState()
Gets the connection state of the route. |
List<IntentFilter>
|
getControlFilters()
Gets the route's |
String
|
getDescription()
Gets the user-visible description of the route. |
int
|
getDeviceType()
Gets the type of the receiver device associated with this route. |
Bundle
|
getExtras()
Gets a bundle of extras for this route descriptor. |
Uri
|
getIconUri()
Gets the URI of the icon representing this route. |
String
|
getId()
Gets the unique id of the route. |
String
|
getName()
Gets the user-visible name of the route. |
int
|
getPlaybackStream()
Gets the route's playback stream. |
int
|
getPlaybackType()
Gets the type of playback associated with this route. |
int
|
getPresentationDisplayId()
Gets the route's presentation display id, or -1 if none. |
IntentSender
|
getSettingsActivity()
Gets an |
int
|
getVolume()
Gets the route's current volume, or 0 if unknown. |
int
|
getVolumeHandling()
Gets information about how volume is handled on the route. |
int
|
getVolumeMax()
Gets the route's maximum volume, or 0 if unknown. |
boolean
|
isConnecting()
This method is deprecated.
Use |
boolean
|
isEnabled()
Gets whether the route is enabled. |
boolean
|
isValid()
Returns true if the route descriptor has all of the required fields. |
String
|
toString()
Returns a string representation of the object. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
Bundle asBundle ()
Converts this object to a bundle for serialization.
Returns | |
---|---|
Bundle |
The contents of the object represented as a bundle. |
boolean canDisconnectAndKeepPlaying ()
Gets whether the route can be disconnected without stopping playback.
The route can normally be disconnected without stopping playback when the destination device on the route is connected to two or more source devices. The route provider should update the route immediately when the number of connected devices changes.
To specify that the route should disconnect without stopping use
unselect(int)
with
UNSELECT_REASON_DISCONNECTED
.
Returns | |
---|---|
boolean |
MediaRouteDescriptor fromBundle (Bundle bundle)
Creates an instance from a bundle.
Parameters | |
---|---|
bundle |
Bundle :
The bundle, or null if none. |
Returns | |
---|---|
MediaRouteDescriptor |
The new instance, or null if the bundle was null. |
int getConnectionState ()
Gets the connection state of the route.
Returns | |
---|---|
int |
The connection state of this route:
CONNECTION_STATE_DISCONNECTED ,
CONNECTION_STATE_CONNECTING , or
CONNECTION_STATE_CONNECTED .
|
List<IntentFilter> getControlFilters ()
Gets the route's media control intent
filters.
Returns | |
---|---|
List<IntentFilter> |
String getDescription ()
Gets the user-visible description of the route.
The route description describes the kind of destination represented by the route. It may be a user-supplied string, a model number or brand of device.
Returns | |
---|---|
String |
int getDeviceType ()
Gets the type of the receiver device associated with this route.
Returns | |
---|---|
int |
The type of the receiver device associated with this route:
DEVICE_TYPE_TV or
DEVICE_TYPE_SPEAKER .
|
Bundle getExtras ()
Gets a bundle of extras for this route descriptor. The extras will be ignored by the media router but they may be used by applications.
Returns | |
---|---|
Bundle |
Uri getIconUri ()
Gets the URI of the icon representing this route.
This icon will be used in picker UIs if available.
Returns | |
---|---|
Uri |
String getId ()
Gets the unique id of the route.
The route id associated with a route descriptor functions as a stable identifier for the route and must be unique among all routes offered by the provider.
Returns | |
---|---|
String |
String getName ()
Gets the user-visible name of the route.
The route name identifies the destination represented by the route. It may be a user-supplied name, an alias, or device serial number.
Returns | |
---|---|
String |
int getPlaybackStream ()
Gets the route's playback stream.
Returns | |
---|---|
int |
int getPlaybackType ()
Gets the type of playback associated with this route.
Returns | |
---|---|
int |
The type of playback associated with this route:
PLAYBACK_TYPE_LOCAL or
PLAYBACK_TYPE_REMOTE .
|
int getPresentationDisplayId ()
Gets the route's presentation display id, or -1 if none.
Returns | |
---|---|
int |
IntentSender getSettingsActivity ()
Gets an IntentSender
for starting a settings activity for this
route. The activity may have specific route settings or general settings
for the connected device or route provider.
Returns | |
---|---|
IntentSender |
An IntentSender to start a settings activity.
|
int getVolume ()
Gets the route's current volume, or 0 if unknown.
Returns | |
---|---|
int |
int getVolumeHandling ()
Gets information about how volume is handled on the route.
Returns | |
---|---|
int |
How volume is handled on the route:
PLAYBACK_VOLUME_FIXED or
PLAYBACK_VOLUME_VARIABLE .
|
int getVolumeMax ()
Gets the route's maximum volume, or 0 if unknown.
Returns | |
---|---|
int |
boolean isConnecting ()
This method is deprecated.
Use getConnectionState()
instead
Gets whether the route is connecting.
Returns | |
---|---|
boolean |
boolean isEnabled ()
Gets whether the route is enabled.
Returns | |
---|---|
boolean |
boolean isValid ()
Returns true if the route descriptor has all of the required fields.
Returns | |
---|---|
boolean |
String toString ()
Returns a string representation of the object. In general, the
toString
method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@
', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |