Visão geral
Uma classe base abstrata para realizar a descoberta de dispositivos e a construção de sessões.
É possível adicionar suporte para outros tipos de dispositivos estendendo essa classe. Consulte a categoria GCKDeviceProvider(Protected) para ver uma lista de métodos auxiliares destinados ao uso por subclasses. Novos provedores de dispositivos são registrados com o framework usando registerDeviceProvider: (GCKCastContext).
- Desde
- 3.0
Herda o NSObject.
Resumo do método de instância | |
(instancetype) | - initWithDeviceCategory: |
Inicializador designado. Mais... | |
(void) | - startDiscovery |
Inicia uma nova verificação de descoberta. Mais... | |
(void) | - stopDiscovery |
Interrompe a verificação de descoberta. Mais... | |
(GCKSession *) | - createSessionForDevice:sessionID: |
Cria uma nova sessão para o dispositivo especificado e, opcionalmente, um ID de sessão existente. Mais... | |
(void) | - notifyDidStartDiscovery |
Notifica o gerenciador de descoberta de que a descoberta foi iniciada. Mais... | |
(void) | - notifyDidPublishDevice: |
Notifica o gerenciador de descoberta de que um novo dispositivo foi publicado. Mais... | |
(void) | - notifyDidUnpublishDevice: |
Notifica o gerenciador de descoberta de que um dispositivo publicado anteriormente foi removido da publicação porque não está mais disponível. Mais... | |
(void) | - notifyDidUpdateDevice: |
Notifica o gerenciador de descoberta de que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome amigável ou ícones) mudaram. Mais... | |
(GCKDevice *) | - createDeviceWithID:ipAddress:servicePort: |
Método de fábrica para construir novas instâncias de GCKDevice. Mais... | |
Resumo da propriedade | |
NSString * | deviceCategory |
Uma string que identifica de forma exclusiva o tipo de dispositivo que será descoberto por esse provedor. Mais... | |
BOOL | passiveScan |
Indica se a verificação deve ser passiva. Mais... | |
NSArray< GCKDevice * > * | devices |
A matriz de dispositivos descobertos. Mais... | |
Detalhes do método
- (instancetype) initWithDeviceCategory: | (NSString *) | deviceCategory |
Inicializador designado.
Cria um novo GCKDeviceProvider para dispositivos do tipo especificado.
- Parameters
-
deviceCategory A string that uniquely identifies the type of device that is managed by by this provider.
- (void) startDiscovery |
Inicia uma nova verificação de descoberta.
Essa é (geralmente) uma operação assíncrona. Se algum dos dispositivos descobertos pela verificação anterior não for mais válido, o provedor deverá cancelar a publicação deles neste momento. Precisa ser substituído por subclasses.
O provedor precisa notificar o gerenciador de descoberta assim que a verificação for iniciada (e os dispositivos desatualizados forem cancelados) chamando notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Se uma implementação específica desse método não tiver trabalho assíncrono a ser feito ao iniciar uma verificação, ela poderá chamar o método de notificação diretamente antes de retornar.
- (void) stopDiscovery |
Interrompe a verificação de descoberta.
Precisa ser substituído por subclasses.
- (GCKSession *) createSessionForDevice: | (GCKDevice *) | device | |
sessionID: | (NSString *__nullable) | sessionID | |
Cria uma nova sessão para o dispositivo especificado e, opcionalmente, um ID de sessão existente.
Precisa ser substituído por subclasses.
- Parameters
-
device The device to connect to. sessionID The ID of the session to resume; or nil
to start a new session.
- (void) notifyDidStartDiscovery |
Notifica o gerenciador de descoberta de que a descoberta foi iniciada.
Fornecido pela categoria GCKDeviceProvider(Protected).
- (void) notifyDidPublishDevice: | (GCKDevice *) | device |
Notifica o gerenciador de descoberta de que um novo dispositivo foi publicado.
Fornecido pela categoria GCKDeviceProvider(Protected).
- (void) notifyDidUnpublishDevice: | (GCKDevice *) | device |
Notifica o gerenciador de descoberta de que um dispositivo publicado anteriormente foi removido da publicação porque não está mais disponível.
Fornecido pela categoria GCKDeviceProvider(Protected).
- (void) notifyDidUpdateDevice: | (GCKDevice *) | device |
Notifica o gerenciador de descoberta de que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome amigável ou ícones) mudaram.
Fornecido pela categoria GCKDeviceProvider(Protected).
- (GCKDevice *) createDeviceWithID: | (NSString *) | deviceID | |
ipAddress: | (NSString *) | ipAddress | |
servicePort: | (uint16_t) | servicePort | |
Método de fábrica para construir novas instâncias de GCKDevice.
Os parâmetros correspondem a propriedades imutáveis de um GCKDevice.
- Parameters
-
deviceID The unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider. ipAddress The IP address of the device, in numeric form (for example, @"10.0.0.10"
). May not benil
.servicePort The service port on which connections should be made to this device. May be 0 if a service port is not applicable.
Fornecido pela categoria GCKDeviceProvider(Protected).
Detalhes da propriedade
|
readnonatomiccopy |
Uma string que identifica de forma exclusiva o tipo de dispositivo que será descoberto por esse provedor.
|
readwritenonatomicassign |
Indica se a verificação deve ser passiva.
Uma verificação passiva envia consultas de descoberta com menos frequência, o que a torna mais eficiente, mas os resultados não são tão recentes. É adequado fazer uma verificação passiva quando o usuário não está selecionando ativamente um destino do Cast. Nem todas as implementações vão honrar essa propriedade.
|
readnonatomiccopy |
A matriz de dispositivos descobertos.