Classe GCKSessionManager

Referência da classe GCKSessionManager

Visão geral

Uma classe que gerencia sessões.

O método startSessionWithDevice: (GCKSessionManager) é usado para criar uma nova sessão com um determinado GCKDevice. O gerenciador de sessões usa a GCKDeviceProvider para esse tipo de dispositivo a fim de criar um novo objeto GCKSession, ao qual delega todas as solicitações de sessão.

O GCKSessionManager processa a retomada automática de sessões suspensas, isto é, retomada das sessões que foram encerradas quando o app passou para o segundo plano ou se o app falhou ou foi forçado a ser encerrado pelo usuário. Quando o aplicativo for retomado ou reiniciado, o gerente da sessão aguardará um pouco para que o provedor do dispositivo da sessão suspensa descubra o dispositivo novamente. Se isso acontecer, ele tentará se reconectar e restabelecer a sessão automaticamente.

Se o app tiver criado uma GCKUICastButton sem fornecer um destino e um seletor, um toque do usuário no botão exibirá a caixa de diálogo "Transmitir" padrão e iniciará e interromperá automaticamente as sessões com base na seleção ou desconexão do usuário de um dispositivo. No entanto, se o aplicativo estiver fornecendo a própria IU da caixa de diálogo de seleção/controle do dispositivo, ele precisará usar a GCKSessionManager diretamente para criar e controlar sessões.

Mesmo que o aplicativo não use o GCKSessionManager para controlar as sessões, ele pode anexar um GCKSessionManagerListener para ser notificado sobre eventos de sessão e também pode usar o KVO para monitorar a propriedade connectionState para rastrear o estado atual do ciclo de vida da sessão.

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...
 
(BOOL) - startSessionWithDevice:
 Inicia uma nova sessão com o dispositivo especificado. Mais...
 
(BOOL) - suspendSessionWithReason:
 Suspende a sessão atual. Mais...
 
(BOOL) - endSession
 Encerra a sessão atual. Mais...
 
(BOOL) - endSessionAndStopCasting:
 Encerra a sessão atual, opcionalmente interrompendo a transmissão. Mais...
 
(BOOL) - hasConnectedSession
 Testa se uma sessão está sendo gerenciada por esse gerenciador de sessões e está conectada no momento. Mais...
 
(BOOL) - hasConnectedCastSession
 Testa se uma sessão do Google Cast está sendo gerenciada por esse gerenciador de sessões e ela está conectada no momento. Mais...
 
(void) - addListener:
 Adiciona um listener para receber notificações. Mais...
 
(void) - removeListener:
 Remove um listener que foi adicionado anteriormente com addListener:. Mais...
 

Resumo da propriedade

GCKSessioncurrentSession
 A sessão atual, se houver. Mais...
 
GCKCastSessioncurrentCastSession
 A sessão de transmissão atual, se houver. Mais...
 
GCKConnectionState connectionState
 O estado atual da conexão da sessão. Mais...
 

Detalhes dos métodos

- (instancetype) init

O inicializador padrão não está disponível.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

Inicia uma nova sessão com o dispositivo especificado.

Esta é uma operação assíncrona.

Parameters
deviceThe device to use for this session.
Retorna
YES se a operação foi iniciada com sucesso, NO se houver uma sessão estabelecida ou se não foi possível iniciar a operação.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

Suspende a sessão atual.

Esta é uma operação assíncrona.

Parameters
reasonThe reason for the suspension.
Retorna
YES se a operação foi iniciada com sucesso, NO se não houver uma sessão estabelecida no momento ou se a operação não puder ser iniciada.
- (BOOL) endSession

Encerra a sessão atual.

Esta é uma operação assíncrona.

Retorna
YES se a operação foi iniciada com sucesso, NO se não houver uma sessão estabelecida no momento ou se a operação não puder ser iniciada.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Encerra a sessão atual, opcionalmente interrompendo a transmissão.

Esta é uma operação assíncrona.

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
Retorna
YES se a operação foi iniciada com sucesso, NO se não houver uma sessão estabelecida no momento ou se a operação não puder ser iniciada.
- (BOOL) hasConnectedSession

Testa se uma sessão está sendo gerenciada por esse gerenciador de sessões e está conectada no momento.

Esse estado será YES se o estado da sessão for GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

Testa se uma sessão do Google Cast está sendo gerenciada por esse gerenciador de sessões e ela está conectada no momento.

Ele será YES se o estado da sessão for GCKConnectionStateConnected e ela for uma sessão de transmissão.

- (void) addListener: (id< GCKSessionManagerListener >)  listener

Adiciona um listener para receber notificações.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

Remove um listener que foi adicionado anteriormente com addListener:.

Parameters
listenerThe listener to remove.

Detalhes da propriedade

- (GCKSession*) currentSession
readnonatomicstrong

A sessão atual, se houver.

- (GCKCastSession*) currentCastSession
readnonatomicstrong

A sessão de transmissão atual, se houver.

- (GCKConnectionState) connectionState
readnonatomicassign

O estado atual da conexão da sessão.