GCKDiscoveryManager 类

GCKDiscoveryManager 类参考文档

概览

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

GCKDiscoveryManager 管理 GCKDeviceProvider 子类实例的集合,其中每个子类负责发现特定类型的设备。它还按字典顺序对当前发现的设备进行了维护。

当应用进入前台时,框架会自动启动发现进程;当应用移至后台时,框架会暂停发现进程。通常,应用无需调用 startDiscovery (GCKDiscoveryManager)stopDiscovery (GCKDiscoveryManager),除非它是作为优化措施,可减少应用中不使用 Cast 功能的区域的网络流量和 CPU 利用率。

如果应用正在使用框架的 Cast 对话框(通过 GCKUICastButton 或通过直接呈现),则该对话框将使用 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

目前发现的设备数量。