GCKDiscoveryManager 클래스

GCKDiscoveryManager 클래스 참조

개요

기기 검색 프로세스를 관리하는 클래스입니다.

GCKDiscoveryManagerGCKDeviceProvider 서브클래스 인스턴스의 컬렉션을 관리하며 각 인스턴스는 특정 유형의 기기 검색을 담당합니다. 또한 현재 검색된 기기의 사전순으로 정렬된 목록을 유지합니다.

프레임워크는 애플리케이션이 포그라운드로 이동할 때 검색 프로세스를 자동으로 시작하고 애플리케이션이 백그라운드로 이동하면 프로세스를 정지합니다. Cast 기능을 사용하지 않는 애플리케이션 영역에서 네트워크 트래픽과 CPU 사용률을 줄이기 위한 최적화 조치의 경우를 제외하고는 일반적으로 애플리케이션이 startDiscovery (GCKDiscoveryManager)stopDiscovery (GCKDiscoveryManager)를 호출할 필요가 없습니다.

애플리케이션이 프레임워크의 전송 대화상자를 GCKUICastButton나 직접 표시하는 방법으로 사용하는 경우 이 대화상자는 GCKDiscoveryManager를 사용하여 사용 가능한 기기 목록을 채웁니다. 하지만 애플리케이션이 자체 기기 선택/제어 대화상자 UI를 제공하는 경우 GCKDiscoveryManager 및 연결된 리스너 프로토콜인 GCKDiscoveryManagerListener를 사용하여 사용 가능한 기기 목록을 채우고 업데이트해야 합니다.

다음 이후:
3.0

NSObject를 상속합니다.

인스턴스 메서드 요약

(instancetype) - init
 기본 이니셜라이저를 사용할 수 없습니다. 더보기...
 
(void) - addListener:
 검색 알림을 수신하는 리스너를 추가합니다. 더보기...
 
(void) - removeListener:
 이전에 등록된 리스너를 제거합니다. 더보기...
 
(void) - startDiscovery
 검색 프로세스를 시작합니다. 더보기...
 
(void) - stopDiscovery
 검색 프로세스를 중지합니다. 더보기...
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 지정된 기기 카테고리에서 검색이 현재 활성화되어 있는지 테스트합니다. 더보기...
 
(GCKDevice *) - deviceAtIndex:
 관리자의 검색된 기기 목록에서 지정된 색인에 있는 기기를 반환합니다. 더보기...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 관리자의 검색된 기기 목록에서 지정된 고유 ID가 있는 기기를 반환합니다. 더보기...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 지정된 고유 ID를 가진 기기가 검색될 때까지 대기하고 완료 블록을 호출합니다. 더보기...
 
(void) - cancelFindOperation
 findDeviceWithUniqueID:timeout:completion:에 의해 시작된 진행 중인 모든 찾기 작업을 취소합니다. 더보기...
 

속성 요약

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

관리자의 검색된 기기 목록에서 지정된 색인에 있는 기기를 반환합니다.

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

관리자의 검색된 기기 목록에서 지정된 고유 ID가 있는 기기를 반환합니다.

Parameters
uniqueIDThe device's unique ID.
반환 값
일치하는 GCKDevice 객체 또는 일치하는 기기를 찾을 수 없는 경우 nil입니다.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

지정된 고유 ID를 가진 기기가 검색될 때까지 대기하고 완료 블록을 호출합니다.

일치하는 기기가 이미 검색된 기기 목록에 있는 경우 완료 블록이 즉시 호출됩니다 (이 메서드가 반환된 후). 한 번에 하나의 찾기 작업만 활성화할 수 있습니다. 다른 작업이 진행되는 동안 새 찾기 작업을 시작하면 현재 작업이 취소됩니다.

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil (if not found) will be passed to the completion block.
다음 이후:
4.0
- (void) cancelFindOperation

findDeviceWithUniqueID:timeout:completion:에 의해 시작된 진행 중인 모든 찾기 작업을 취소합니다.

다음 이후:
4.0

부동산 세부정보

- (GCKDiscoveryState) discoveryState
readnonatomicassign

현재 검색 상태입니다.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

이 객체가 관리하는 검색 제공업체가 기기를 검색했는지 여부를 나타내는 플래그입니다.

- (BOOL) passiveScan
readwritenonatomicassign

검색에 '수동' 스캔을 사용해야 하는지 여부를 나타내는 플래그입니다.

수동 스캔은 리소스 사용량이 적지만 활성 스캔만큼 최신의 결과를 제공하지 않습니다.

- (BOOL) discoveryActive
readnonatomicassign

탐색이 활성 상태인지 여부를 나타내는 플래그입니다.

다음 이후:
3.4
- (NSUInteger) deviceCount
readnonatomicassign

현재 발견된 기기 수입니다.