Informações gerais
Uma classe base abstrata que representa uma sessão com um dispositivo receptor.
As subclasses precisam implementar os métodos start (GCKSession(Protected)) e endWithAction: (GCKSession(Protected)) e chamar os métodos de notificador apropriados (por exemplo, notifyDidStartWithSessionID: (GCKSession(Protected))) para indicar as mudanças correspondentes no estado da sessão. As subclasses também podem implementar setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) e remoteMediaClient se o dispositivo oferecer suporte a essas operações.
Uma sessão é criada e controlada usando os métodos de sessão em GCKSessionManager, que usa o GCKDeviceProvider apropriado para criar a sessão e, em seguida, delega solicitações de sessão para esse objeto GCKSession.
- Como
- 3,0
Herda o NSObject.
Herdado pelo GCKCastSession.
Resumo do método de instância | |
| (instancetype) | - initWithDevice:traits:sessionID: |
| Inicializa um novo objeto de sessão para o dispositivo especificado, com opções padrão. Mais... | |
| (instancetype) | - initWithDevice:traits:sessionID:sessionOptions: |
| Inicializa um novo objeto de sessão para o dispositivo especificado. Mais... | |
| (GCKRequest *) | - setDeviceVolume: |
| Define o volume do dispositivo. Mais... | |
| (GCKRequest *) | - setDeviceMuted: |
| Define o estado mudo do dispositivo. Mais... | |
| (void) | - start |
| Inicia a sessão. Mais... | |
| (void) | - endWithAction: |
| Encerra a sessão com a ação especificada. Mais... | |
| (void) | - notifyDidStartWithSessionID: |
| Chamado por subclasses para notificar o framework de que a sessão foi iniciada. Mais... | |
| (void) | - notifyDidFailToStartWithError: |
| Chamado por subclasses para notificar o framework de que a sessão não foi iniciada. Mais... | |
| (void) | - notifyDidEndWithError:willTryToResume: |
| Chamado por subclasses para notificar o framework de que a sessão foi encerrada. Mais... | |
| (void) | - notifyDidReceiveDeviceVolume:muted: |
| Chamado por subclasses para notificar o framework de que o volume atualizado do dispositivo e o estado silencioso foram recebidos do dispositivo. Mais... | |
| (void) | - notifyDidReceiveDeviceStatus: |
| Chamado por subclasses para notificar o framework de que o status atualizado foi recebido do dispositivo. Mais... | |
| (void) | - notifyDidSuspendWithReason: |
| Obsoleto, não use: implementado como um ambiente autônomo. Mais... | |
| (void) | - notifyDidResume |
| Obsoleto, não use: implementado como um ambiente autônomo. Mais... | |
Resumo da propriedade | |
| GCKDevice * | device |
| O dispositivo a que esta sessão está associada. Mais... | |
| NSString * | sessionID |
| O ID da sessão atual, se houver. Mais... | |
| GCKSessionOptions * | sessionOptions |
| As opções da sessão, se houver. Mais... | |
| GCKConnectionState | connectionState |
| O estado atual da conexão da sessão. Mais... | |
| BOOL | suspended |
| Uma sinalização que indica se a sessão está suspensa no momento. Mais... | |
| NSString * | deviceStatusText |
| O texto de status atual do dispositivo. Mais... | |
| GCKSessionTraits * | traits |
| As características da sessão. Mais... | |
| float | currentDeviceVolume |
| O volume atual do dispositivo, no intervalo [0,0, 1,0]. Mais... | |
| BOOL | currentDeviceMuted |
| O estado atual do som desativado do dispositivo. Mais... | |
| GCKRemoteMediaClient * | remoteMediaClient |
| O objeto GCKRemoteMediaClient que pode ser usado para controlar a reprodução de mídia nesta sessão. Mais... | |
| GCKMediaMetadata * | mediaMetadata |
| Os metadados de mídia atuais, se houver. Mais... | |
Detalhes dos métodos
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| traits: | (nullable GCKSessionTraits *) | traits | |
| sessionID: | (nullable NSString *) | sessionID | |
Inicializa um novo objeto de sessão para o dispositivo especificado, com opções padrão.
- Parameters
-
device The device. traits The session traits. sessionID The session ID of an existing session, if this object will be used to resume a session; otherwise nilif it will be used to start a new session.
| - (instancetype) initWithDevice: | (GCKDevice *) | device | |
| traits: | (nullable GCKSessionTraits *) | traits | |
| sessionID: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
Inicializa um novo objeto de sessão para o dispositivo especificado.
- Parameters
-
device The device. traits The session traits. sessionID The session ID of an existing session, if this object will be used to resume a session; otherwise nilif it will be used to start a new session.sessionOptions The session options, if any; otherwise nil.
- Como
- 4,0
| - (GCKRequest *) setDeviceVolume: | (float) | volume |
Define o volume do dispositivo.
Essa é uma operação assíncrona. A implementação padrão é um ambiente autônomo que falha a solicitação com um erro GCKErrorCodeSupportedFeature.
- Parameters
-
volume The new volume.
- Retorna
- Um objeto GCKRequest para rastrear a solicitação.
- Como
- 3.4; nas versões anteriores do framework, esse método retornou
void.
| - (GCKRequest *) setDeviceMuted: | (BOOL) | muted |
Define o estado mudo do dispositivo.
Essa é uma operação assíncrona. A implementação padrão é um ambiente autônomo que falha a solicitação com um erro GCKErrorCodeSupportedFeature.
- Parameters
-
muted The new mute state.
- Retorna
- Um objeto GCKRequest para rastrear a solicitação.
- Como
- 3.4; nas versões anteriores do framework, esse método retornou
void.
| - (void) start |
Inicia a sessão.
Essa é uma operação assíncrona. Precisa ser substituído por subclasses.
Fornecido por categoria GCKSession(Protected).
| - (void) endWithAction: | (GCKSessionEndAction) | action |
Encerra a sessão com a ação especificada.
Essa é uma operação assíncrona. Precisa ser substituído por subclasses.
- Parameters
-
action The action to take when ending the session; see GCKSessionEndAction for more details.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
Chamado por subclasses para notificar o framework de que a sessão foi iniciada.
- Parameters
-
sessionID The session's unique ID.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidFailToStartWithError: | (GCKError *) | error |
Chamado por subclasses para notificar o framework de que a sessão não foi iniciada.
- Parameters
-
error The error that occurred.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidEndWithError: | (nullable NSError *) | error | |
| willTryToResume: | (BOOL) | willTryToResume | |
Chamado por subclasses para notificar o framework de que a sessão foi encerrada.
- Parameters
-
error The error that caused the session to end, if any. Should be nilif the session was ended intentionally.willTryToResume Whether the session will try to resume itself automatically.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidReceiveDeviceVolume: | (float) | volume | |
| muted: | (BOOL) | muted | |
Chamado por subclasses para notificar o framework de que o volume atualizado do dispositivo e o estado silencioso foram recebidos do dispositivo.
- Parameters
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The device's current mute state.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidReceiveDeviceStatus: | (nullable NSString *) | statusText |
Chamado por subclasses para notificar o framework de que o status atualizado foi recebido do dispositivo.
- Parameters
-
statusText The new status.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidSuspendWithReason: | (GCKConnectionSuspendReason) | reason |
Obsoleto, não use, implementado como um ambiente autônomo.
- Deprecated:
- Não ligue.
Fornecido por categoria GCKSession(Protected).
| - (void) notifyDidResume |
Obsoleto, não use, implementado como um ambiente autônomo.
- Deprecated:
- Não ligue.
Fornecido por categoria GCKSession(Protected).
Detalhe da propriedade
|
readnonatomicstrong |
O dispositivo a que esta sessão está associada.
|
readnonatomiccopy |
O ID da sessão atual, se houver.
|
readnonatomicstrong |
As opções da sessão, se houver.
- Como
- 4,0
|
readnonatomicassign |
O estado atual da conexão da sessão.
|
readnonatomicassign |
Uma sinalização que indica se a sessão está suspensa no momento.
- Deprecated:
- O GCKSession não permite mais o estado suspenso. Se necessário, mova essa funcionalidade para uma subclasse.
|
readnonatomiccopy |
O texto de status atual do dispositivo.
|
readnonatomiccopy |
As características da sessão.
|
readnonatomicassign |
O volume atual do dispositivo, no intervalo [0,0, 1,0].
|
readnonatomicassign |
O estado atual do som desativado do dispositivo.
|
readnonatomicstrong |
O objeto GCKRemoteMediaClient que pode ser usado para controlar a reprodução de mídia nesta sessão.
É nil antes do início da sessão ou caso a sessão não tenha suporte à API GCKRemoteMediaClient. As subclasses que fornecem uma interface GCKRemoteMediaClient precisam modificar o método getter.
|
readnonatomicstrong |
Os metadados de mídia atuais, se houver.
Será nil se a sessão não oferecer suporte ao namespace de mídia ou se nenhuma mídia estiver carregada no momento no receptor.