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 o GCKDeviceProvider para esse tipo de dispositivo e cria um objeto GCKSession, ao qual delega todas as solicitações de sessão.
O GCKSessionManager processa a retomada automática de sessões suspensas, ou seja, retoma sessões que foram encerradas quando o aplicativo foi para o segundo plano ou em caso de falha ou encerramento forçado pelo usuário. Quando o aplicativo é retomado ou reiniciado, o gerenciador de sessão aguarda um pouco para que o provedor de dispositivos da sessão suspensa descubra o dispositivo novamente. Se isso acontecer, ele tentará se reconectar ao dispositivo e restabelecer a sessão automaticamente.
Se o aplicativo tiver criado um GCKUICastButton sem fornecer um destino e um seletor, um toque do usuário no botão vai mostrar a caixa de diálogo padrão do Google Cast e iniciar e interromper automaticamente as sessões com base na seleção ou desconexão de um dispositivo pelo usuário. No entanto, se o aplicativo estiver fornecendo a própria interface de seleção/controle de dispositivo, ele deverá usar o GCKSessionManager diretamente para criar e controlar sessões.
Independente de o aplicativo usar o GCKSessionManager para controlar sessões, ele pode anexar um GCKSessionManagerListener para receber notificações de eventos de sessão e usar KVO para monitorar a propriedade connectionState e rastrear o estado atual do ciclo de vida da sessão.
- Desde
- 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, interrompendo opcionalmente a transmissão. Mais... | |
| (BOOL) | - hasConnectedSession |
| Testa se uma sessão está sendo gerenciada por este gerenciador de sessões e se está conectada. Mais... | |
| (BOOL) | - hasConnectedCastSession |
| Testa se uma sessão do Cast está sendo gerenciada pelo gerenciador de sessão e se está conectada. 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 | |
| GCKSession * | currentSession |
| A sessão atual, se houver. Mais... | |
| GCKCastSession * | currentCastSession |
| A sessão de transmissão atual, se houver. Mais... | |
| GCKConnectionState | connectionState |
| O estado atual da conexão da sessão. Mais... | |
Detalhes do método
| - (instancetype) init |
O inicializador padrão não está disponível.
| - (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
Inicia uma nova sessão com o dispositivo especificado.
Essa é uma operação assíncrona.
- Parameters
-
device The device to use for this session.
- Retorna
YESse a operação foi iniciada com sucesso,NOse houver uma sessão estabelecida ou se a operação não puder ser iniciada.
| - (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
Suspende a sessão atual.
Essa é uma operação assíncrona.
- Parameters
-
reason The reason for the suspension.
- Retorna
YESse a operação foi iniciada com sucesso,NOse não houver uma sessão estabelecida ou se a operação não puder ser iniciada.
| - (BOOL) endSession |
Encerra a sessão atual.
Essa é uma operação assíncrona.
- Retorna
YESse a operação foi iniciada com sucesso,NOse não houver uma sessão estabelecida ou se a operação não puder ser iniciada.
| - (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
Encerra a sessão atual, interrompendo opcionalmente a transmissão.
Essa é uma operação assíncrona.
- Parameters
-
stopCasting Whether casting of content on the receiver should be stopped when the session is ended.
- Retorna
YESse a operação foi iniciada com sucesso,NOse não houver uma sessão estabelecida ou se a operação não puder ser iniciada.
| - (BOOL) hasConnectedSession |
Testa se uma sessão está sendo gerenciada por este gerenciador de sessões e se está conectada.
Será YES se o estado da sessão for GCKConnectionStateConnected.
| - (BOOL) hasConnectedCastSession |
Testa se uma sessão do Cast está sendo gerenciada pelo gerenciador de sessão e se está conectada.
Será YES se o estado da sessão for GCKConnectionStateConnected e a sessão for de transmissão.
| - (void) addListener: | (id< GCKSessionManagerListener >) | listener |
Adiciona um listener para receber notificações.
- Parameters
-
listener The listener to add.
| - (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
Remove um listener que foi adicionado anteriormente com addListener:.
- Parameters
-
listener The listener to remove.
Detalhes da propriedade
|
readnonatomicstrong |
A sessão atual, se houver.
|
readnonatomicstrong |
A sessão de transmissão atual, se houver.
|
readnonatomicassign |
O estado atual da conexão da sessão.