Класс GCKDiscoveryManager

Справочник по классу GCKDiscoveryManager

Обзор

Класс, управляющий процессом обнаружения устройств.

GCKDiscoveryManager управляет коллекцией экземпляров подкласса GCKDeviceProvider , каждый из которых отвечает за обнаружение устройств определенного типа. Он также поддерживает лексикографически упорядоченный список обнаруженных в данный момент устройств.

Платформа автоматически запускает процесс обнаружения, когда приложение переходит на передний план, и приостанавливает его, когда приложение переходит в фоновый режим. Обычно приложению не требуется вызывать startDiscovery (GCKDiscoveryManager) и stopDiscovery (GCKDiscoveryManager) , за исключением мер по оптимизации, позволяющих снизить сетевой трафик и загрузку ЦП в областях приложения, которые не используют функции Cast.

Если приложение использует диалоговое окно Cast платформы либо с помощью GCKUICastButton , либо путем его непосредственного представления, тогда это диалоговое окно будет использовать GCKDiscoveryManager для заполнения списка доступных устройств. Однако если приложение предоставляет собственный диалоговый пользовательский интерфейс выбора/управления устройством, то ему следует использовать GCKDiscoveryManager и связанный с ним протокол прослушивателя GCKDiscoveryManagerListener для заполнения и обновления списка доступных устройств.

С
3.0

Наследует NSObject.

Сводка метода экземпляра

(instancetype) - init
Инициализатор по умолчанию недоступен. Более...
(void) - addListener:
Добавляет прослушиватель, который будет получать уведомления об обнаружении. Более...
(void) - removeListener:
Удаляет ранее зарегистрированный прослушиватель. Более...
(void) - startDiscovery
Запускает процесс обнаружения. Более...
(void) - stopDiscovery
Останавливает процесс обнаружения. Более...
(BOOL) - isDiscoveryActiveForDeviceCategory:
Проверяет, активно ли в данный момент обнаружение для данной категории устройств. Более...
( GCKDevice *) - deviceAtIndex:
Возвращает устройство по заданному индексу в списке обнаруженных устройств менеджера. Более...
(nullable GCKDevice *) - deviceWithUniqueID:
Возвращает устройство с заданным уникальным идентификатором в списке обнаруженных устройств менеджера. Более...
(void) - findDeviceWithUniqueID:timeout:completion:
Ожидает обнаружения устройства с заданным уникальным идентификатором и вызывает блок завершения. Более...
(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

Возвращает устройство с заданным уникальным идентификатором в списке обнаруженных устройств менеджера.

Parameters
uniqueIDThe device's unique ID.
Возврат
Соответствующий объект GCKDevice или nil , если подходящее устройство не найдено.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)( GCKDevice *))  completion  

Ожидает обнаружения устройства с заданным уникальным идентификатором и вызывает блок завершения.

Если подходящее устройство уже находится в списке обнаруженных устройств, блок завершения будет вызван немедленно (но после завершения работы этого метода). Одновременно может быть активна только одна операция поиска; запуск новой операции поиска во время выполнения другой приведет к отмене текущей.

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
read nonatomic assign

Текущее состояние обнаружения.

- (BOOL) hasDiscoveredDevices
read nonatomic assign

Флаг, указывающий, были ли обнаружены какие-либо устройства каким-либо из поставщиков обнаружения, управляемых этим объектом.

- (BOOL) passiveScan
read write nonatomic assign

Флаг, указывающий, должно ли обнаружение использовать «пассивное» сканирование.

Пассивное сканирование менее ресурсоемко, но не дает таких же свежих результатов, как активное сканирование.

- (BOOL) discoveryActive
read nonatomic assign

Флаг, указывающий, активно ли обнаружение или нет.

С
3.4
- (NSUInteger) deviceCount
read nonatomic assign

Количество устройств, обнаруженных на данный момент.