public static class MediaRouter.RouteInfo
extends Object
| java.lang.Object | |
| ↳ | android.support.v7.media.MediaRouter.RouteInfo |
提供有关媒体路由的信息。
每个媒体路由都有一个列表 media control intent filters ，其中描述了路由的功能以及使用和控制路由的方式。
Constants |
|
|---|---|
int |
CONNECTION_STATE_CONNECTED 指示路线的连接状态被连接。 |
int |
CONNECTION_STATE_CONNECTING 指示路由的连接状态正处于连接过程中，尚未准备好使用。 |
int |
CONNECTION_STATE_DISCONNECTED 指示路由的默认连接状态被断开。 |
int |
DEVICE_TYPE_SPEAKER 指示媒体呈现的路由的接收器设备类型发生在扬声器上。 |
int |
DEVICE_TYPE_TV 指示媒体呈现的路由的接收器设备类型正在TV上发生。 |
int |
PLAYBACK_TYPE_LOCAL 表示媒体呈现的默认回放类型“本地”发生在同一设备上（例如， |
int |
PLAYBACK_TYPE_REMOTE 指示媒体呈现的重放类型发生在不同的设备上（即， |
int |
PLAYBACK_VOLUME_FIXED 指示回放音量的回放信息是固定的，即， |
int |
PLAYBACK_VOLUME_VARIABLE 指示回放音量的回放信息是可变的并且可以从该对象进行控制。 |
Public methods |
|
|---|---|
boolean |
canDisconnect() 获取此路由是否支持断开连接而不中断播放。 |
int |
getConnectionState() 获取路由的连接状态。 |
List<IntentFilter> |
getControlFilters() 获取 |
String |
getDescription() 获取用户可见的路由描述。 |
int |
getDeviceType() 获取与此路由关联的接收方设备的类型。 |
Bundle |
getExtras() 获取由其媒体路由提供程序提供的有关此路由的其他属性的集合，如果没有，则返回null。 |
Uri |
getIconUri() 获取表示此路线的图标的URI。 |
String |
getId() 获取路由的唯一标识。 |
String |
getName() 获取路径的用户可见名称。 |
int |
getPlaybackStream() 获取执行与此路线相关的回放的音频流。 |
int |
getPlaybackType() 获取与此路线关联的播放类型。 |
Display |
getPresentationDisplay() 获取应用程序使用的 |
MediaRouter.ProviderInfo |
getProvider() 获取有关此媒体路由提供者的信息。 |
IntentSender |
getSettingsIntent() 获取一个意图发件人以启动此路线的设置活动。 |
int |
getVolume() 获取此路线的当前音量。 |
int |
getVolumeHandling() 获取有关如何在路线上处理卷的信息。 |
int |
getVolumeMax() 获取与此路线相关的播放执行的最大音量。 |
boolean |
isConnecting() 如果路线正处于连接过程中并且尚未准备好使用，则返回true。 |
boolean |
isDefault() 如果此路线是默认路线，则返回true。 |
boolean |
isEnabled() 如果此路线已启用且可能被选中，则返回true。 |
boolean |
isSelected() 如果当前选择此路线，则返回true。 |
boolean |
matchesSelector(MediaRouteSelector selector) 如果路由至少支持媒体路由选择器描述的其中一项功能，则返回true。 |
void |
requestSetVolume(int volume) 异步请求此路由的卷更改。 |
void |
requestUpdateVolume(int delta) 异步请求此路由的增量卷更新。 |
void |
select() 选择此媒体路线。 |
void |
sendControlRequest(Intent intent, MediaRouter.ControlRequestCallback callback) 发送一个 |
boolean |
supportsControlAction(String category, String action) 如果路由支持指定的 |
boolean |
supportsControlCategory(String category) 如果路线支持指定的 |
boolean |
supportsControlRequest(Intent intent) 如果路由支持指定的 |
String |
toString() 返回对象的字符串表示形式。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
int CONNECTION_STATE_CONNECTED
指示路线的连接状态被连接。
也可以看看：
常量值：2（0x00000002）
int CONNECTION_STATE_CONNECTING
指示路由的连接状态正处于连接过程中，尚未准备好使用。
也可以看看：
常数值：1（0x00000001）
int CONNECTION_STATE_DISCONNECTED
指示路由的默认连接状态被断开。
也可以看看：
常量值：0（0x00000000）
int DEVICE_TYPE_SPEAKER
指示媒体呈现的路由的接收器设备类型发生在扬声器上。
也可以看看：
常量值：2（0x00000002）
int DEVICE_TYPE_TV
指示媒体呈现的路由的接收器设备类型正在TV上发生。
也可以看看：
常数值：1（0x00000001）
int PLAYBACK_TYPE_LOCAL
表示媒体呈现的默认回放类型“本地”发生在同一设备（例如手机，平板电脑）上，因为它受控于此处。
也可以看看：
常量值：0（0x00000000）
int PLAYBACK_TYPE_REMOTE
指示媒体呈现的重放类型发生在不同的设备（即，远程设备）上，而不是其被控制的位置。
也可以看看：
常数值：1（0x00000001）
int PLAYBACK_VOLUME_FIXED
表示播放音量的播放信息是固定的，即不能从该对象控制。 固定播放音量的示例是远程播放器，通过HDMI播放，用户喜欢控制HDMI接收器上的音量，而不是在源处衰减。
也可以看看：
常量值：0（0x00000000）
int PLAYBACK_VOLUME_VARIABLE
指示回放音量的回放信息是可变的并且可以从该对象进行控制。
也可以看看：
常数值：1（0x00000001）
boolean canDisconnect ()
获取此路由是否支持断开连接而不中断播放。
| Returns | |
|---|---|
boolean |
True if this route can disconnect without stopping playback, false otherwise. |
int getConnectionState ()
获取路由的连接状态。
| Returns | |
|---|---|
int |
The connection state of this route: CONNECTION_STATE_DISCONNECTED, CONNECTION_STATE_CONNECTING, or CONNECTION_STATE_CONNECTED. |
List<IntentFilter> getControlFilters ()
获取 media control intent过滤器的列表，描述此路由的功能以及它支持的媒体控制操作。
| Returns | |
|---|---|
List<IntentFilter> |
A list of intent filters that specifies the media control intents that this route supports. |
String getDescription ()
获取用户可见的路由描述。
路线描述描述了路线所代表的目的地的种类。 它可能是用户提供的字符串，型号或设备品牌。
| Returns | |
|---|---|
String |
The description of the route, or null if none. |
int getDeviceType ()
获取与此路由关联的接收方设备的类型。
| Returns | |
|---|---|
int |
The type of the receiver device associated with this route: DEVICE_TYPE_TV or DEVICE_TYPE_SPEAKER. |
Uri getIconUri ()
获取表示此路线的图标的URI。
如果可用，此图标将用于选取器用户界面。
| Returns | |
|---|---|
Uri |
The URI of the icon representing this route, or null if none. |
String getId ()
获取路由的唯一标识。
路由唯一标识符用作已知路由的稳定标识符。 例如，应用程序可以使用此标识作为令牌来记住跨重新启动的选定路由或将其身份传送到服务。
| Returns | |
|---|---|
String |
The unique id of the route, never null. |
String getName ()
获取路径的用户可见名称。
路线名称标识路线表示的目的地。 它可能是用户提供的名称，别名或设备序列号。
| Returns | |
|---|---|
String |
The user-visible name of a media route. This is the string presented to users who may select this as the active route. |
int getPlaybackStream ()
获取执行与此路线相关的回放的音频流。
| Returns | |
|---|---|
int |
The stream over which the playback associated with this route is performed. |
int getPlaybackType ()
获取与此路线关联的播放类型。
| Returns | |
|---|---|
int |
The type of playback associated with this route: PLAYBACK_TYPE_LOCAL or PLAYBACK_TYPE_REMOTE. |
Display getPresentationDisplay ()
获取应用程序使用的Display ， Presentation在选择此路线时在外部显示器上显示Presentation 。 根据路线，这只有在当前选择路线时才有效。
优选的演示显示可以独立于被选择或未被选择的路线而改变。 例如，即使路由本身没有改变，当外部HDMI显示器连接或断开连接时，默认系统路由的显示显示可能会改变。
如果没有与路由关联的外部显示或者显示还没有准备好显示UI，则此方法可能会返回null。
应用程序应该使用 onRoutePresentationDisplayChanged(MediaRouter, MediaRouter.RouteInfo)回调来监听演示显示的更改，并在显示器变为可用或已被移除时相应地显示或取消 Presentation 。
这种方法只适用于 live video路由。
| Returns | |
|---|---|
Display |
The preferred presentation display to use when this route is selected or null if none. |
也可以看看：
MediaRouter.ProviderInfo getProvider ()
获取有关此媒体路由提供者的信息。
| Returns | |
|---|---|
MediaRouter.ProviderInfo |
|
int getVolume ()
获取此路线的当前音量。 根据路线，这只有在当前选择路线时才有效。
| Returns | |
|---|---|
int |
The volume at which the playback associated with this route is performed. |
int getVolumeHandling ()
获取有关如何在路线上处理卷的信息。
| Returns | |
|---|---|
int |
How volume is handled on the route: PLAYBACK_VOLUME_FIXED or PLAYBACK_VOLUME_VARIABLE. |
int getVolumeMax ()
获取与此路线相关的播放执行的最大音量。
| Returns | |
|---|---|
int |
The maximum volume at which the playback associated with this route is performed. |
boolean isConnecting ()
如果路线正处于连接过程中并且尚未准备好使用，则返回true。
| Returns | |
|---|---|
boolean |
True if this route is in the process of connecting. |
boolean isDefault ()
如果此路线是默认路线，则返回true。
| Returns | |
|---|---|
boolean |
True if this route is the default route. |
也可以看看：
boolean isEnabled ()
如果此路线已启用且可能被选中，则返回true。
| Returns | |
|---|---|
boolean |
True if this route is enabled. |
boolean isSelected ()
如果当前选择此路线，则返回true。
| Returns | |
|---|---|
boolean |
True if this route is currently selected. |
也可以看看：
boolean matchesSelector (MediaRouteSelector selector)
如果路由至少支持媒体路由选择器描述的其中一项功能，则返回true。
| Parameters | |
|---|---|
selector |
MediaRouteSelector: The selector that specifies the capabilities to check. |
| Returns | |
|---|---|
boolean |
True if the route supports at least one of the capabilities described in the media route selector. |
void requestSetVolume (int volume)
异步请求此路由的卷更改。
此功能只能在选定的路线上调用。 如果路线当前未被选择，它将不起作用。
| Parameters | |
|---|---|
volume |
int: The new volume value between 0 and getVolumeMax(). |
void requestUpdateVolume (int delta)
异步请求此路由的增量卷更新。
此功能只能在选定的路线上调用。 如果路线当前未被选择，它将不起作用。
| Parameters | |
|---|---|
delta |
int: The delta to add to the current volume. |
void select ()
选择此媒体路线。
void sendControlRequest (Intent intent, MediaRouter.ControlRequestCallback callback)
发送一个 media control请求，由路由的目的地异步执行。
媒体控制请求用于请求路由执行操作，例如开始媒体项目的远程播放。
此功能只能在选定的路线上调用。 发送给未被选择的路由的控制请求将失败。
| Parameters | |
|---|---|
intent |
Intent: A media control intent. |
callback |
MediaRouter.ControlRequestCallback: A MediaRouter.ControlRequestCallback to invoke with the result of the request, or null if no result is required. |
也可以看看：
boolean supportsControlAction (String category, String action)
如果路线支持指定的 media control类别和操作，则返回true。
媒体控制操作描述了应用程序可以请求路由执行的特定请求。
| Parameters | |
|---|---|
category |
String: A media control category such as CATEGORY_LIVE_AUDIO, CATEGORY_LIVE_VIDEO, CATEGORY_REMOTE_PLAYBACK, or a provider-defined media control category. |
action |
String: A media control action such as ACTION_PLAY. |
| Returns | |
|---|---|
boolean |
True if the route supports the specified intent action. |
boolean supportsControlCategory (String category)
如果路线支持指定的 media control类别，则返回true。
媒体控制类别描述了该路由的功能，例如它是否支持实时音频流或远程播放。
| Parameters | |
|---|---|
category |
String: A media control category such as CATEGORY_LIVE_AUDIO, CATEGORY_LIVE_VIDEO, CATEGORY_REMOTE_PLAYBACK, or a provider-defined media control category. |
| Returns | |
|---|---|
boolean |
True if the route supports the specified intent category. |
boolean supportsControlRequest (Intent intent)
如果路由支持指定的 media control请求，则返回true。
媒体控制请求用于请求路由执行操作，例如开始媒体项目的远程播放。
| Parameters | |
|---|---|
intent |
Intent: A media control intent. |
| Returns | |
|---|---|
boolean |
True if the route can handle the specified intent. |
String toString ()
返回对象的字符串表示形式。 一般来说， toString方法返回一个“文本地表示”这个对象的字符串。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object的toString方法将返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说，这个方法返回一个字符串，其值等于：
getClass().getName() + '@' + Integer.toHexString(hashCode())
| Returns | |
|---|---|
String |
a string representation of the object. |
Android开发手册