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 endWithAction: (GCKSession(Protected)).

Como
3,0

Herda GCKSession.

Resumo do método de instância

(instancetype) - initWithDevice:sessionID:sessionOptions:castOptions:
 Cria uma nova sessão do Google Cast com as opções de transmissão fornecidas. 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, 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

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...
 
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...
 
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: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions
castOptions: (GCKCastOptions *)  castOptions 

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.
sessionOptionsThe session options, if any; otherwise nil.
castOptionsThe Cast options.
Como
4,0
- (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.

O listener adicionado é fraco e precisa ser mantido para evitar desalocação inesperada.

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: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID 

Inicializa um novo objeto de sessão para o dispositivo especificado, com opções padrão.

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.
- (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
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.
sessionOptionsThe 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
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) 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
actionThe 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
sessionIDThe 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
errorThe 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
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResumeWhether 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
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: (nullable NSString *)  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).

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

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

- (GCKSessionOptions*) sessionOptions
readnonatomicstronginherited

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

Como
4,0
- (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.

Deprecated:
O GCKSession não permite mais o estado suspenso. Se necessário, mova essa funcionalidade para uma subclasse.
- (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.