Visão geral

Uma classe base abstrata que representa uma sessão com um dispositivo receptor.

As subclasses precisam implementar os métodos start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) e resume (GCKSession(Protected)) e chamar os métodos de notificação 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 for compatível com essas operações.

Uma sessão é criada e controlada usando os métodos de sessão no GCKSessionManager, que usa o GCKDeviceProvider apropriado para criar a sessão e delega solicitações de sessão a esse objeto GCKSession.

Since: 3,0

Herda o NSObject.

Herdado por GCKCastSession.

Resumo do método de instância
(instancetype)	- initWithDevice:traits:sessionID:
	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)	- endAndStopCasting:
	Encerra a sessão. Mais...

(void)	- suspendWithReason:
	Suspende a sessão pelo motivo informado. Mais...

(void)	- resume
	Retoma a sessão. 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 falhou ao iniciar. Mais...

(void)	- notifyDidResume
	Chamado por subclasses para notificar o framework de que a sessão foi retomada. Mais...

(void)	- notifyDidSuspendWithReason:
	Chamado por subclasses para notificar o framework de que a sessão foi suspensa. Mais...

(void)	- notifyDidEndWithError:
	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 que o volume e o estado de silenciamento do dispositivo foram recebidos do dispositivo. Mais...

(void)	- notifyDidReceiveDeviceStatus:
	Chamado por subclasses para notificar o framework de que o status atualizado foi recebido do dispositivo. 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...

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 atual do status 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 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:	(GCKSessionTraits *)	traits
sessionID:	(NSString *__nullable)	sessionID

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.

- (GCKRequest *) setDeviceVolume: (float) volume

Define o volume do dispositivo.

Esta é 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.

Since: 3.4. Nas versões anteriores do framework, esse método retornava void.

- (GCKRequest *) setDeviceMuted: (BOOL) muted

Define o estado mudo do dispositivo.

Esta é 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.

Since: 3.4. Nas versões anteriores do framework, esse método retornava void.

- (void) start

Inicia a sessão.

Esta é uma operação assíncrona. Precisa ser substituído por subclasses.

Fornecido pela categoria GCKSession(Protected).

- (void) endAndStopCasting: (BOOL) stopCasting

Encerra a sessão.

Esta é uma operação assíncrona. Precisa ser substituído por subclasses.

Parameters

stopCasting Whether to stop casting content to the receiver.

Fornecido pela categoria GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

Suspende a sessão pelo motivo informado.

Esta é uma operação assíncrona. Precisa ser substituído por subclasses.

Fornecido pela categoria GCKSession(Protected).

- (void) resume

Retoma a sessão.

Esta é uma operação assíncrona. Precisa ser substituído por subclasses.

Fornecido pela 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 pela categoria GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (NSError *) error

Chamado por subclasses para notificar o framework de que a sessão falhou ao iniciar.

Parameters

error The error that occurred.

Fornecido pela categoria GCKSession(Protected).

- (void) notifyDidResume

Chamado por subclasses para notificar o framework de que a sessão foi retomada.

Fornecido pela categoria GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

Chamado por subclasses para notificar o framework de que a sessão foi suspensa.

Parameters

reason The reason for the suspension.

Fornecido pela categoria GCKSession(Protected).

- (void) notifyDidEndWithError: (NSError *__nullable) error

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.

Fornecido pela categoria GCKSession(Protected).

- (void) notifyDidReceiveDeviceVolume:	(float)	volume
muted:	(BOOL)	muted

Chamado por subclasses para notificar o framework que o volume e o estado de silenciamento do dispositivo 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 pela categoria GCKSession(Protected).

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable) statusText

Chamado por subclasses para notificar o framework de que o status atualizado foi recebido do dispositivo.

Parameters

statusText The new status.

Fornecido pela categoria GCKSession(Protected).

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

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

- (NSString*) deviceStatusText

readnonatomiccopy

O texto atual do status 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 do dispositivo.

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstrong

O objeto GCKRemoteMediaClient que pode ser usado para controlar a reprodução de mídia nesta sessão.

Ele é nil antes do início da sessão ou se ela não for compatível com a 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 for compatível com o namespace de mídia ou se nenhuma mídia estiver carregada no receptor no momento.

Aula sobre GCKSession

Visão geral

Resumo do método de instância

Resumo da propriedade

Detalhes dos métodos

Detalhes da propriedade