Most visited

Recently visited

MediaRouter.RouteInfo

public static class MediaRouter.RouteInfo
extends Object

java.lang.Object
   ↳ android.support.v7.media.MediaRouter.RouteInfo


提供有关媒体路由的信息。

每个媒体路由都有一个列表 media control intent filters ,其中描述了路由的功能以及使用和控制路由的方式。

Summary

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()

获取 media control intent过滤器的列表,描述此路由的功能以及它支持的媒体控制操作。

String getDescription()

获取用户可见的路由描述。

int getDeviceType()

获取与此路由关联的接收方设备的类型。

Bundle getExtras()

获取由其媒体路由提供程序提供的有关此路由的其他属性的集合,如果没有,则返回null。

Uri getIconUri()

获取表示此路线的图标的URI。

String getId()

获取路由的唯一标识。

String getName()

获取路径的用户可见名称。

int getPlaybackStream()

获取执行与此路线相关的回放的音频流。

int getPlaybackType()

获取与此路线关联的播放类型。

Display getPresentationDisplay()

获取应用程序使用的 DisplayPresentation在选择此路由时在外部显示器上显示 Presentation

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)

发送一个 media control请求,由路由的目的地异步执行。

boolean supportsControlAction(String category, String action)

如果路由支持指定的 media control类别和操作,则返回true。

boolean supportsControlCategory(String category)

如果路线支持指定的 media control类别,则返回true。

boolean supportsControlRequest(Intent intent)

如果路由支持指定的 media control请求,则返回true。

String toString()

返回对象的字符串表示形式。

Inherited methods

From class java.lang.Object

Constants

CONNECTION_STATE_CONNECTED

int CONNECTION_STATE_CONNECTED

指示路线的连接状态被连接。

也可以看看:

常量值:2(0x00000002)

CONNECTION_STATE_CONNECTING

int CONNECTION_STATE_CONNECTING

指示路由的连接状态正处于连接过程中,尚未准备好使用。

也可以看看:

常数值:1(0x00000001)

CONNECTION_STATE_DISCONNECTED

int CONNECTION_STATE_DISCONNECTED

指示路由的默认连接状态被断开。

也可以看看:

常量值:0(0x00000000)

DEVICE_TYPE_SPEAKER

int DEVICE_TYPE_SPEAKER

指示媒体呈现的路由的接收器设备类型发生在扬声器上。

也可以看看:

常量值:2(0x00000002)

DEVICE_TYPE_TV

int DEVICE_TYPE_TV

指示媒体呈现的路由的接收器设备类型正在TV上发生。

也可以看看:

常数值:1(0x00000001)

PLAYBACK_TYPE_LOCAL

int PLAYBACK_TYPE_LOCAL

表示媒体呈现的默认回放类型“本地”发生在同一设备(例如手机,平板电脑)上,因为它受控于此处。

也可以看看:

常量值:0(0x00000000)

PLAYBACK_TYPE_REMOTE

int PLAYBACK_TYPE_REMOTE

指示媒体呈现的重放类型发生在不同的设备(即,远程设备)上,而不是其被控制的位置。

也可以看看:

常数值:1(0x00000001)

PLAYBACK_VOLUME_FIXED

int PLAYBACK_VOLUME_FIXED

表示播放音量的播放信息是固定的,即不能从该对象控制。 固定播放音量的示例是远程播放器,通过HDMI播放,用户喜欢控制HDMI接收器上的音量,而不是在源处衰减。

也可以看看:

常量值:0(0x00000000)

PLAYBACK_VOLUME_VARIABLE

int PLAYBACK_VOLUME_VARIABLE

指示回放音量的回放信息是可变的并且可以从该对象进行控制。

也可以看看:

常数值:1(0x00000001)

Public methods

canDisconnect

boolean canDisconnect ()

获取此路由是否支持断开连接而不中断播放。

Returns
boolean True if this route can disconnect without stopping playback, false otherwise.

getConnectionState

int getConnectionState ()

获取路由的连接状态。

Returns
int The connection state of this route: CONNECTION_STATE_DISCONNECTED, CONNECTION_STATE_CONNECTING, or CONNECTION_STATE_CONNECTED.

getControlFilters

List<IntentFilter> getControlFilters ()

获取 media control intent过滤器的列表,描述此路由的功能以及它支持的媒体控制操作。

Returns
List<IntentFilter> A list of intent filters that specifies the media control intents that this route supports.

也可以看看:

getDescription

String getDescription ()

获取用户可见的路由描述。

路线描述描述了路线所代表的目的地的种类。 它可能是用户提供的字符串,型号或设备品牌。

Returns
String The description of the route, or null if none.

getDeviceType

int getDeviceType ()

获取与此路由关联的接收方设备的类型。

Returns
int The type of the receiver device associated with this route: DEVICE_TYPE_TV or DEVICE_TYPE_SPEAKER.

getExtras

Bundle getExtras ()

获取由其媒体路由提供程序提供的有关此路由的其他属性的集合,如果没有,则返回null。

Returns
Bundle

getIconUri

Uri getIconUri ()

获取表示此路线的图标的URI。

如果可用,此图标将用于选取器用户界面。

Returns
Uri The URI of the icon representing this route, or null if none.

getId

String getId ()

获取路由的唯一标识。

路由唯一标识符用作已知路由的稳定标识符。 例如,应用程序可以使用此标识作为令牌来记住跨重新启动的选定路由或将其身份传送到服务。

Returns
String The unique id of the route, never null.

getName

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.

getPlaybackStream

int getPlaybackStream ()

获取执行与此路线相关的回放的音频流。

Returns
int The stream over which the playback associated with this route is performed.

getPlaybackType

int getPlaybackType ()

获取与此路线关联的播放类型。

Returns
int The type of playback associated with this route: PLAYBACK_TYPE_LOCAL or PLAYBACK_TYPE_REMOTE.

getPresentationDisplay

Display getPresentationDisplay ()

获取应用程序使用的DisplayPresentation在选择此路线时在外部显示器上显示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.

也可以看看:

getProvider

MediaRouter.ProviderInfo getProvider ()

获取有关此媒体路由提供者的信息。

Returns
MediaRouter.ProviderInfo

getSettingsIntent

IntentSender getSettingsIntent ()

获取一个意图发件人以启动此路线的设置活动。

Returns
IntentSender

getVolume

int getVolume ()

获取此路线的当前音量。 根据路线,这只有在当前选择路线时才有效。

Returns
int The volume at which the playback associated with this route is performed.

getVolumeHandling

int getVolumeHandling ()

获取有关如何在路线上处理卷的信息。

Returns
int How volume is handled on the route: PLAYBACK_VOLUME_FIXED or PLAYBACK_VOLUME_VARIABLE.

getVolumeMax

int getVolumeMax ()

获取与此路线相关的播放执行的最大音量。

Returns
int The maximum volume at which the playback associated with this route is performed.

isConnecting

boolean isConnecting ()

如果路线正处于连接过程中并且尚未准备好使用,则返回true。

Returns
boolean True if this route is in the process of connecting.

isDefault

boolean isDefault ()

如果此路线是默认路线,则返回true。

Returns
boolean True if this route is the default route.

也可以看看:

isEnabled

boolean isEnabled ()

如果此路线已启用且可能被选中,则返回true。

Returns
boolean True if this route is enabled.

isSelected

boolean isSelected ()

如果当前选择此路线,则返回true。

Returns
boolean True if this route is currently selected.

也可以看看:

matchesSelector

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.

requestSetVolume

void requestSetVolume (int volume)

异步请求此路由的卷更改。

此功能只能在选定的路线上调用。 如果路线当前未被选择,它将不起作用。

Parameters
volume int: The new volume value between 0 and getVolumeMax().

requestUpdateVolume

void requestUpdateVolume (int delta)

异步请求此路由的增量卷更新。

此功能只能在选定的路线上调用。 如果路线当前未被选择,它将不起作用。

Parameters
delta int: The delta to add to the current volume.

select

void select ()

选择此媒体路线。

sendControlRequest

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.

也可以看看:

supportsControlAction

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.

也可以看看:

supportsControlCategory

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.

也可以看看:

supportsControlRequest

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.

也可以看看:

toString

String toString ()

返回对象的字符串表示形式。 一般来说, toString方法返回一个“文本地表示”这个对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法将返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

Hooray!