Classe GCKCastSession

Referência da classe GCKCastSession

Informações gerais

Uma classe que gerencia uma sessão de transmissão com um dispositivo receptor.

As sessões são criadas e gerenciadas automaticamente pelo GCKSessionManager. O aplicativo não pode chamar diretamente os métodos de ciclo de vida da sessão, como start (GCKSession(Protected)) ou endAndStopCasting: (GCKSession(Protected)).

Como
3,0

Herda GCKSession.

Resumo do método de instância

(instancetype) - initWithDevice:sessionID:castOptions:
 Iniciador designado. Mais...
 
(BOOL) - addChannel:
 Registra um canal com a sessão. Mais...
 
(BOOL) - removeChannel:
 Remove da sessão um canal registrado anteriormente. Mais...
 
(void) - addDeviceStatusListener:
 Adiciona um GCKCastDeviceStatusListener à lista de listeners desse objeto. Mais...
 
(void) - removeDeviceStatusListener:
 Remove um GCKCastDeviceStatusListener da lista de listeners desse objeto. Mais...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 Define o volume do dispositivo individual em um grupo de várias zonas. Mais...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 Define o estado silenciado de um dispositivo individual em um grupo de várias zonas. Mais...
 
(GCKRequest *) - requestMultizoneStatus
 Solicitar o status de várias zonas de um grupo de várias zonas. Mais...
 
(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 especificado. 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 não foi iniciada. 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 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...
 

Resumo da propriedade

GCKActiveInputStatus activeInputStatus
 O status atual de "entrada ativa" do dispositivo. Mais...
 
GCKStandbyStatus standbyStatus
 O status de "em espera" atual do dispositivo. Mais...
 
GCKApplicationMetadataapplicationMetadata
 Os metadados do aplicativo receptor que está em execução no dispositivo receptor, se houver. Caso contrário, nil. Mais...
 
GCKDevicedevice
 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 de status atual do dispositivo. Mais...
 
GCKSessionTraitstraits
 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...
 
GCKRemoteMediaClientremoteMediaClient
 O objeto GCKRemoteMediaClient que pode ser usado para controlar a reprodução de mídia nesta sessão. Mais...
 
GCKMediaMetadatamediaMetadata
 Os metadados de mídia atuais, se houver. Mais...
 

Detalhes dos métodos

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (NSString *__nullable)  sessionID
castOptions: (GCKCastOptions *)  castOptions 

Iniciador designado.

Cria uma nova sessão do Google Cast com as opções de transmissão fornecidas.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
castOptionsThe Cast options.
- (BOOL) addChannel: (GCKCastChannel *)  channel

Registra um canal com a sessão.

Se a sessão estiver conectada e o aplicativo receptor oferecer suporte ao namespace do canal, o canal será conectado automaticamente. Se a sessão não for conectada, o canal vai permanecer no estado desconectado até o início dela.

Parameters
channelThe channel to register.
Retorna
YES se o canal tiver sido registrado. Caso contrário, NO.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Remove da sessão um canal registrado anteriormente.

Parameters
channelThe channel to unregister.
Retorna
YES se o registro do canal tiver sido cancelado. Caso contrário, NO.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Adiciona um GCKCastDeviceStatusListener à lista de listeners desse objeto.

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Remove um GCKCastDeviceStatusListener da lista de listeners desse objeto.

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Define o volume do dispositivo individual em um grupo de várias zonas.

Essa é uma operação assíncrona.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
Retorna
Um objeto GCKRequest para rastrear a solicitação.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Define o estado silenciado de um dispositivo individual em um grupo de várias zonas.

Essa é uma operação assíncrona.

Parameters
mutedThe new muted state.
deviceThe multizone device.
Retorna
Um objeto GCKRequest para rastrear a solicitação.
- (GCKRequest *) requestMultizoneStatus

Solicitar o status de várias zonas de um grupo de várias zonas.

Essa é uma operação assíncrona. Quando o status de várias zonas for recebido, o método delegado castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) receberá uma mensagem.

Retorna
Um objeto GCKRequest para rastrear a solicitação.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  sessionID 

Inicializa um novo objeto de sessão para o dispositivo especificado.

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe 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.

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
volumeThe 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
mutedThe 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) endAndStopCasting: (BOOL)  stopCasting

Encerra a sessão.

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

Parameters
stopCastingWhether to stop casting content to the receiver.

Fornecido por categoria GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

Suspende a sessão pelo motivo especificado.

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

Fornecido por categoria GCKSession(Protected).

- (void) resume

Retoma a sessão.

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

Fornecido por categoria GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

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

Parameters
sessionIDThe session's unique ID.

Fornecido por categoria GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (NSError *)  error

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

Parameters
errorThe error that occurred.

Fornecido por categoria GCKSession(Protected).

- (void) notifyDidResume

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

Fornecido por categoria GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

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

Parameters
reasonThe reason for the suspension.

Fornecido por categoria GCKSession(Protected).

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

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

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

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
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

Fornecido por 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
statusTextThe new status.

Fornecido por categoria GCKSession(Protected).

Detalhe da propriedade

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

O status atual de "entrada ativa" do dispositivo.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

O status de "em espera" atual do dispositivo.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

Os metadados do aplicativo receptor que está em execução no dispositivo receptor, se houver. Caso contrário, nil.

- (GCKDevice*) device
readnonatomicstronginherited

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

- (NSString*) sessionID
readnonatomiccopyinherited

O ID da sessão atual, se houver.

- (GCKConnectionState) connectionState
readnonatomicassigninherited

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

- (BOOL) suspended
readnonatomicassigninherited

Uma sinalização que indica se a sessão está suspensa no momento.

- (NSString*) deviceStatusText
readnonatomiccopyinherited

O texto de status atual do dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

As características da sessão.

- (float) currentDeviceVolume
readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

O estado atual do som desativado do dispositivo.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

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
readnonatomicstronginherited

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.