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 `nil` if 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 `nil` if 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 `nil` if 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

- (GCKDevice*) device

readnonatomicstrong

O dispositivo a que esta sessão está associada.

- (NSString*) sessionID

readnonatomiccopy

O ID da sessão atual, se houver.

- (GCKSessionOptions*) sessionOptions

readnonatomicstrong

As opções da sessão, se houver.

Como: 4,0

- (GCKConnectionState) connectionState

readnonatomicassign

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

- (BOOL) suspended

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.

- (NSString*) deviceStatusText

readnonatomiccopy

O texto de status atual do dispositivo.

- (GCKSessionTraits*) traits

readnonatomiccopy

As características da sessão.

- (float) currentDeviceVolume

readnonatomicassign

O volume atual do dispositivo, no intervalo [0,0, 1,0].

- (BOOL) currentDeviceMuted

readnonatomicassign

O estado atual do som desativado do dispositivo.

- (GCKRemoteMediaClient*) remoteMediaClient

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.

- (GCKMediaMetadata*) mediaMetadata

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.

Classe GCKSession

Informações gerais

Resumo do método de instância

Resumo da propriedade

Detalhes dos métodos

Detalhe da propriedade