Classe GCKDiscoveryManager

Referência da classe GCKDiscoveryManager

Informações gerais

Uma classe que gerencia o processo de descoberta de dispositivos.

O GCKDiscoveryManager gerencia uma coleção de instâncias de subclasse GCKDeviceProvider, cada uma responsável por descobrir dispositivos de um tipo específico. Ele também mantém uma lista lexicograficamente ordenada dos dispositivos descobertos no momento.

O framework inicia automaticamente o processo de descoberta quando o aplicativo passa para o primeiro plano e o suspende quando o aplicativo passa para o segundo plano. Em geral, não é necessário que o aplicativo chame startDiscovery (GCKDiscoveryManager) e stopDiscovery (GCKDiscoveryManager), exceto como uma medida de otimização para reduzir o tráfego de rede e o uso da CPU em áreas do aplicativo que não usam a funcionalidade do Google Cast.

Se o aplicativo estiver usando a caixa de diálogo "Transmitir" do framework, seja por GCKUICastButton ou apresentando diretamente, essa caixa de diálogo vai usar GCKDiscoveryManager para preencher a lista de dispositivos disponíveis. No entanto, se o aplicativo estiver fornecendo a própria IU de caixa de diálogo de seleção/controle de dispositivos, ele precisará usar o GCKDiscoveryManager e o protocolo de listener associado, GCKDiscoveryManagerListener, para preencher e atualizar a lista de dispositivos disponíveis.

Como
3,0

Herda o NSObject.

Resumo do método de instância

(instancetype) - init
 O inicializador padrão não está disponível. Mais...
 
(void) - addListener:
 Adiciona um listener que receberá notificações de descoberta. Mais...
 
(void) - removeListener:
 Remove um listener registrado anteriormente. Mais...
 
(void) - startDiscovery
 Inicia o processo de descoberta. Mais...
 
(void) - stopDiscovery
 Interrompe o processo de descoberta. Mais...
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 Testa se a descoberta está ativa no momento para a categoria de dispositivo especificada. Mais...
 
(GCKDevice *) - deviceAtIndex:
 Retorna o dispositivo no índice especificado na lista de dispositivos descobertos do gerenciador. Mais...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 Retorna o dispositivo com o ID exclusivo fornecido na lista de dispositivos descobertos do gerenciador. Mais...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 Espera que um dispositivo com o ID exclusivo fornecido seja descoberto e invoca um bloco de conclusão. Mais...
 
(void) - cancelFindOperation
 Cancela qualquer operação de localização em andamento iniciada por findDeviceWithUniqueID:timeout:completion:. Mais...
 

Resumo da propriedade

GCKDiscoveryState discoveryState
 O estado atual da descoberta. Mais...
 
BOOL hasDiscoveredDevices
 Uma sinalização que indica se algum dispositivo foi descoberto por algum dos provedores de descoberta gerenciados por este objeto. Mais...
 
BOOL passiveScan
 Uma sinalização que indica se a descoberta precisa usar uma verificação "passiva". Mais...
 
BOOL discoveryActive
 Uma sinalização que indica se a descoberta está ativa ou não. Mais...
 
NSUInteger deviceCount
 É o número de dispositivos descobertos no momento. Mais...
 

Detalhes dos métodos

- (instancetype) init

O inicializador padrão não está disponível.

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

Adiciona um listener que receberá notificações de descoberta.

O listener adicionado é fraco e precisa ser mantido para evitar desalocação inesperada.

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

Remove um listener registrado anteriormente.

Parameters
listenerThe listener to remove.
- (void) startDiscovery

Inicia o processo de descoberta.

- (void) stopDiscovery

Interrompe o processo de descoberta.

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

Testa se a descoberta está ativa no momento para a categoria de dispositivo especificada.

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

Retorna o dispositivo no índice especificado na lista de dispositivos descobertos do gerenciador.

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

Retorna o dispositivo com o ID exclusivo fornecido na lista de dispositivos descobertos do gerenciador.

Parameters
uniqueIDThe device's unique ID.
Retorna
O objeto GCKDevice correspondente, ou nil, se um dispositivo correspondente não for encontrado.
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

Espera que um dispositivo com o ID exclusivo fornecido seja descoberto e invoca um bloco de conclusão.

Se um dispositivo correspondente já estiver na lista de dispositivos descobertos, o bloco de conclusão será invocado imediatamente, mas depois que esse método retornar. Apenas uma operação de localização pode estar ativa por vez. Iniciar uma nova operação de localização enquanto outra estiver em andamento cancelará a atual.

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.
Como
4,0
- (void) cancelFindOperation

Cancela qualquer operação de localização em andamento iniciada por findDeviceWithUniqueID:timeout:completion:.

Como
4,0

Detalhe da propriedade

- (GCKDiscoveryState) discoveryState
readnonatomicassign

O estado atual da descoberta.

- (BOOL) hasDiscoveredDevices
readnonatomicassign

Uma sinalização que indica se algum dispositivo foi descoberto por algum dos provedores de descoberta gerenciados por este objeto.

- (BOOL) passiveScan
readwritenonatomicassign

Uma sinalização que indica se a descoberta precisa usar uma verificação "passiva".

As verificações passivas usam menos recursos, mas não fornecem resultados tão recentes quanto as ativas.

- (BOOL) discoveryActive
readnonatomicassign

Uma sinalização que indica se a descoberta está ativa ou não.

Como
3,4
- (NSUInteger) deviceCount
readnonatomicassign

É o número de dispositivos descobertos no momento.