Classe GCKDeviceProvider

Referência da classe GCKDeviceProvider

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
deviceCategoryA 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
deviceThe device to connect to.
sessionIDThe 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
deviceIDThe unique ID identifying this device. This value must be unique among all GCKDevice objects that are created by this provider.
ipAddressThe IP address of the device, in numeric form (for example, @"10.0.0.10"). May not be nil.
servicePortThe 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

- (NSString*) deviceCategory
readnonatomiccopy

Uma string que identifica de forma exclusiva o tipo de dispositivo que será descoberto por esse provedor.

- (BOOL) passiveScan
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.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

A matriz de dispositivos descobertos.