GCKDiscoveryManager 类

GCKDiscoveryManager 类参考

概览

用于管理设备发现流程的类。

GCKDiscoveryManager 管理着一组 GCKDeviceProvider 子类实例,每个实例负责发现特定类型的设备。它还会维护一个按字典顺序排列的当前已发现设备的列表。

当应用移至前台时,框架会自动启动发现过程;当应用移至后台时,框架会自动暂停发现过程。通常情况下,应用无需调用 startDiscovery (GCKDiscoveryManager)stopDiscovery (GCKDiscoveryManager),除非是为了优化应用中不使用投屏功能的部分,以减少网络流量和 CPU 利用率。

如果应用通过 GCKUICastButton 或直接呈现框架的 Cast 对话框来使用该对话框,则该对话框将使用 GCKDiscoveryManager 来填充其可用设备列表。不过,如果应用提供自己的设备选择/控制对话框界面,则应使用 GCKDiscoveryManager 及其关联的监听器协议 GCKDiscoveryManagerListener 来填充和更新可用设备列表。

开始时间
3.0

此类继承 NSObject。

实例方法摘要

(instancetype) - init
 默认初始化程序不可用。更多…
 
(void) - addListener:
 添加一个将接收发现通知的监听器。更多…
 
(void) - removeListener:
 移除之前注册的监听器。更多…
 
(void) - startDiscovery
 启动发现过程。更多…
 
(void) - stopDiscovery
 停止发现过程。更多…
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 测试给定设备类别的发现功能目前是否处于活动状态。更多…
 
(GCKDevice *) - deviceAtIndex:
 返回管理器发现的设备列表中指定索引处的设备。更多…
 
(GCKDevice *__nullable) - deviceWithUniqueID:
 返回管理器发现的设备列表中具有指定唯一 ID 的设备。更多…
 

房源摘要

GCKDiscoveryState discoveryState
 当前发现状态。更多…
 
BOOL hasDiscoveredDevices
 一个标志,用于指示此对象管理的任何发现提供程序是否已发现任何设备。更多…
 
BOOL passiveScan
 一个标志,用于指示发现是否应采用“被动”扫描。更多…
 
BOOL discoveryActive
 一个标志,用于指示发现功能是否处于有效状态。更多…
 
NSUInteger deviceCount
 当前发现的设备数量。更多…
 

方法详细信息

- (instancetype) init

默认初始化程序不可用。

- (void) addListener: (id< GCKDiscoveryManagerListener >)  listener

添加一个将接收发现通知的监听器。

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKDiscoveryManagerListener >)  listener

移除之前注册的监听器。

Parameters
listenerThe listener to remove.
- (void) startDiscovery

启动发现流程。

- (void) stopDiscovery

停止发现过程。

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

测试给定设备类别的发现功能目前是否处于活动状态。

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

返回管理器发现的设备列表中指定索引处的设备。

- (GCKDevice *__nullable) deviceWithUniqueID: (NSString *)  uniqueID

返回管理器发现的设备列表中具有指定唯一 ID 的设备。

Parameters
uniqueIDThe device's unique ID.
返回
匹配的 GCKDevice 对象;如果未找到匹配的设备,则返回 nil

媒体资源详情

- (GCKDiscoveryState) discoveryState
readnonatomicassign

当前发现状态。

- (BOOL) hasDiscoveredDevices
readnonatomicassign

一个标志,用于指示此对象管理的任何发现提供程序是否已发现任何设备。

- (BOOL) passiveScan
readwritenonatomicassign

一个标志,用于指示发现是否应采用“被动”扫描。

被动扫描消耗的资源较少,但提供的结果不如主动扫描新鲜。

- (BOOL) discoveryActive
readnonatomicassign

一个标志,用于指示发现功能是否处于有效状态。

开始时间
3.4
- (NSUInteger) deviceCount
readnonatomicassign

当前发现的设备数量。