Classe GCKDeviceProvider

Referência da classe GCKDeviceProvider

Visão geral

Uma classe base abstrata para realizar a descoberta de dispositivos e a criação de sessões.

A compatibilidade com outros tipos de dispositivos pode ser adicionada estendendo essa classe. Consulte a categoria GCKDeviceProvider(Protected) para ver uma lista de métodos auxiliares para uso em subclasses. Os novos provedores de dispositivos são registrados no framework usando registerDeviceProvider: (GCKCastContext).

Since
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 que a descoberta foi iniciada. Mais...
 
(void) - notifyDidPublishDevice:
 Notifica o gerenciador de descoberta que um novo dispositivo foi publicado. Mais...
 
(void) - notifyDidUnpublishDevice:
 Notifica o administrador de descoberta que a publicação de um dispositivo publicado anteriormente foi cancelada porque não está mais disponível. Mais...
 
(void) - notifyDidUpdateDevice:
 Notifica o gerenciador de descoberta que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome fácil ou ícones) mudaram. Mais...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 Método de fábrica para criar novas instâncias de GCKDevice. Mais...
 

Resumo da propriedade

NSString * deviceCategory
 Uma string que identifica exclusivamente o tipo de dispositivo que será descoberto por esse provedor. Mais...
 
BOOL passiveScan
 Se a verificação deve ser passiva. Mais...
 
NSArray< GCKDevice * > * devices
 A matriz de dispositivos descobertos. Mais...
 

Detalhes dos métodos

- (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.

Isso é (normalmente) uma operação assíncrona. Se algum dos dispositivos descobertos pela verificação anterior não for mais válido, o provedor precisará cancelar a publicação dele no momento. Precisa ser substituído por subclasses.

O provedor precisa notificar o gerenciador de descoberta assim que a verificação for iniciada e todos os dispositivos desatualizados tiverem sido cancelados chamando notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Se uma implementação específica desse método não tiver trabalho assíncrono para iniciar uma verificação, ele 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 que a descoberta foi iniciada.

Fornecido pela categoria GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

Notifica o gerenciador de descoberta que um novo dispositivo foi publicado.

Fornecido pela categoria GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

Notifica o administrador de descoberta que a publicação de um dispositivo publicado anteriormente foi cancelada porque não está mais disponível.

Fornecido pela categoria GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Notifica o gerenciador de descoberta que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome fácil 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 criar novas instâncias de GCKDevice.

Os parâmetros correspondem às 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 exclusivamente o tipo de dispositivo que será descoberto por esse provedor.

- (BOOL) passiveScan
readwritenonatomicassign

Se a verificação deve ser passiva.

Uma verificação passiva envia consultas de descoberta com menos frequência, por isso é mais eficiente, mas os resultados não serão tão atualizados. É adequado fazer uma verificação passiva quando o usuário não estiver selecionando ativamente um destino de transmissão. Nem todas as implementações respeitarão essa propriedade.

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

A matriz de dispositivos descobertos.