Classe GCKDeviceProvider

Referência da classe GCKDeviceProvider

Informações gerais

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

O suporte a outros tipos de dispositivos pode ser adicionado 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).

Como
3,0

Herda o NSObject.

Resumo do método de instância

(instancetype) - initWithDeviceCategory:
 Iniciador designado. Mais...
 
(void) - startDiscovery
 Inicia uma nova verificação de descoberta. Mais...
 
(void) - stopDiscovery
 Interrompe a verificação de descoberta. Mais...
 
(GCKSession *) - createSessionForDevice:sessionID:sessionOptions:
 Cria uma nova sessão para o dispositivo especificado e, opcionalmente, um ID de sessão existente. 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 administrador 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 gerenciador de descobertas de que a publicação de um dispositivo publicado anteriormente foi cancelada porque ele não está mais disponível. Mais...
 
(void) - notifyDidUpdateDevice:
 Notifica o gerenciador de descobertas de que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome de fácil utilização ou ícones) mudaram. Mais...
 
(GCKDevice *) - createDeviceWithID:ipAddress:servicePort:
 
(GCKDevice *) - createDeviceWithID:networkAddress:servicePort:
 Método Factory 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

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

Geralmente, essa é uma operação assíncrona. Se algum dos dispositivos descobertos pela verificação anterior não for mais válido, o provedor deve cancelar a publicação dele. Precisa ser substituído por subclasses.

O provedor precisa notificar o gerenciador de descobertas quando a verificação for iniciada (e a publicação de todos os dispositivos obsoletos tiver sido cancelada) chamando notifyDidStartDiscovery (GCKDeviceProvider(Protected)). Se uma implementação específica desse método não tiver trabalho assíncrono 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: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

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.
sessionOptionsThe session options, if any; otherwise nil.
Como
4,0
- (GCKSession *) createSessionForDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID 

Cria uma nova sessão para o dispositivo especificado e, opcionalmente, um ID de sessão existente.

Parameters
deviceThe device to connect to.
sessionIDThe ID of the session to resume; or nil to start a new session.
Deprecated:
Como alternativa, as subclasses precisam chamar createSessionForDevice:sessionID:sessionOptions.
- (void) notifyDidStartDiscovery

Notifica o administrador de descoberta que a descoberta foi iniciada.

Fornecido por categoria GCKDeviceProvider(Protected).

- (void) notifyDidPublishDevice: (GCKDevice *)  device

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

Fornecido por categoria GCKDeviceProvider(Protected).

- (void) notifyDidUnpublishDevice: (GCKDevice *)  device

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

Fornecido por categoria GCKDeviceProvider(Protected).

- (void) notifyDidUpdateDevice: (GCKDevice *)  device

Notifica o gerenciador de descobertas de que um ou mais atributos de exibição de um dispositivo publicado anteriormente (como nome de fácil utilização ou ícones) mudaram.

Fornecido por categoria GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
ipAddress: (NSString *)  ipAddress
servicePort: (uint16_t)  servicePort 
Deprecated:
Use createDeviceWithID:networkAddress:servicePort: para ter compatibilidade com IPv4 e IPv6

Método Factory para criar 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. Supports IPv4 only.
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.

Fornecido por categoria GCKDeviceProvider(Protected).

- (GCKDevice *) createDeviceWithID: (NSString *)  deviceID
networkAddress: (GCKNetworkAddress *)  networkAddress
servicePort: (uint16_t)  servicePort 

Método Factory para criar 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.
networkAddressThe IP address of the device, either IPv4 or IPv6
servicePortThe service port on which connections should be made to this device. May be 0 if a service port is not applicable.
Como
4,2

Fornecido por categoria GCKDeviceProvider(Protected).

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

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

- (NSArray<GCKDevice *>*) devices
readnonatomiccopy

A matriz de dispositivos descobertos.