Visão geral
Uma classe que gerencia o processo de descoberta de dispositivos.
O GCKDiscoveryManager gerencia uma coleção de instâncias de subclasses GCKDeviceProvider, cada uma sendo 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 ele passa para o segundo plano. Geralmente, 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 nas áreas do aplicativo que não usam a funcionalidade de transmissão.
Se o aplicativo estiver usando a caixa de diálogo "Transmitir" do framework, seja pelo GCKUICastButton ou pela apresentação direta, essa caixa de diálogo usará GCKDiscoveryManager para preencher a lista de dispositivos disponíveis. No entanto, se o aplicativo estiver fornecendo a própria IU da caixa de diálogo de controle/seleção de dispositivos, ele precisará usar a GCKDiscoveryManager e o protocolo de listener associado, GCKDiscoveryManagerListener, para preencher e atualizar a lista de dispositivos disponíveis.
- Since
- 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 o Discovery está ativo para a categoria de dispositivo especificada. Mais... | |
| (GCKDevice *) | - deviceAtIndex: |
| Retorna o dispositivo no índice especificado na lista de dispositivos descobertos pelo gerente. Mais... | |
| (nullable GCKDevice *) | - deviceWithUniqueID: |
| Retorna o dispositivo com o ID exclusivo fornecido na lista de dispositivos descobertos pelo gerente. Mais... | |
| (void) | - findDeviceWithUniqueID:timeout:completion: |
| Espera um dispositivo com o ID exclusivo fornecido ser descoberto e invocar 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 de descoberta atual. Mais... | |
| BOOL | hasDiscoveredDevices |
| Uma sinalização que indica se algum dispositivo foi descoberto por qualquer um dos provedores de descoberta gerenciados por esse objeto. Mais... | |
| BOOL | passiveScan |
| Uma sinalização que indica se a descoberta deve empregar 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 retido para evitar a desalocação inesperada.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKDiscoveryManagerListener >) | listener |
Remove um listener registrado anteriormente.
- Parameters
-
listener The listener to remove.
| - (void) startDiscovery |
Inicia o processo de descoberta.
| - (void) stopDiscovery |
Interrompe o processo de descoberta.
| - (BOOL) isDiscoveryActiveForDeviceCategory: | (NSString *) | deviceCategory |
Testa se o Discovery está ativo para a categoria de dispositivo especificada.
| - (GCKDevice *) deviceAtIndex: | (NSUInteger) | index |
Retorna o dispositivo no índice especificado na lista de dispositivos descobertos pelo gerente.
| - (nullable GCKDevice *) deviceWithUniqueID: | (NSString *) | uniqueID |
Retorna o dispositivo com o ID exclusivo fornecido na lista de dispositivos descobertos pelo gerente.
- Parameters
-
uniqueID The device's unique ID.
- Retorna
- O objeto GCKDevice correspondente, ou
nil, se um dispositivo correspondente não foi encontrado.
| - (void) findDeviceWithUniqueID: | (NSString *) | uniqueID | |
| timeout: | (NSTimeInterval) | timeout | |
| completion: | (void(^)(GCKDevice *)) | completion | |
Espera um dispositivo com o ID exclusivo fornecido ser descoberto e invocar um bloco de conclusão.
Se um dispositivo correspondente já estiver na lista de dispositivos descobertos, o bloco de conclusão vai ser invocado imediatamente, mas depois que esse método for retornado. 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 vai cancelar a atual.
- Parameters
-
uniqueID The unique ID of the device. timeout The maximum amount of time to wait for the device to be discovered. completion The 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.
- Since
- 4,0
| - (void) cancelFindOperation |
Cancela qualquer operação de localização em andamento iniciada por findDeviceWithUniqueID:timeout:completion:.
- Since
- 4,0
Detalhes da propriedade
|
readnonatomicassign |
O estado de descoberta atual.
|
readnonatomicassign |
Uma sinalização que indica se algum dispositivo foi descoberto por qualquer um dos provedores de descoberta gerenciados por esse objeto.
|
readwritenonatomicassign |
Uma sinalização que indica se a descoberta deve empregar uma verificação "passiva".
As verificações passivas exigem menos recursos, mas não fornecem resultados tão recentes quanto as verificações ativas.
|
readnonatomicassign |
Uma sinalização que indica se a descoberta está ativa ou não.
- Since
- 3,4
|
readnonatomicassign |
O número de dispositivos descobertos no momento.