Corso GCKCastSession

Riferimento classe GCKCastSession

Panoramica

Una classe che gestisce una sessione di trasmissione con un dispositivo ricevitore.

Le sessioni vengono create e gestite automaticamente dall'GCKSessionManager. L'applicazione non deve chiamare direttamente i metodi del ciclo di vita delle sessioni, come start (GCKSession(Protected)) o endWithAction: (GCKSession(Protected)).

Dal
3,0

Eredita GCKSession.

Riepilogo del metodo di istanza

(instancetype) - initWithDevice:sessionID:sessionOptions:castOptions:
 Consente di creare una nuova sessione di trasmissione con le opzioni di trasmissione specificate. Altro...
 
(BOOL) - addChannel:
 Registra un canale alla sessione. Altro...
 
(BOOL) - removeChannel:
 Rimuove dalla sessione un canale registrato in precedenza. Altro...
 
(void) - addDeviceStatusListener:
 Aggiunge un valore GCKCastDeviceStatusListener all'elenco dei listener di questo oggetto. Altro...
 
(void) - removeDeviceStatusListener:
 Rimuove un elemento GCKCastDeviceStatusListener dall'elenco dei listener di questo oggetto. Altro...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 Consente di impostare il volume del singolo dispositivo in un gruppo multizona. Altro...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 Imposta lo stato disattivato del singolo dispositivo in un gruppo multizona. Altro...
 
(GCKRequest *) - requestMultizoneStatus
 Richiedi lo stato multizona da un gruppo multizona. Altro...
 
(instancetype) - initWithDevice:traits:sessionID:
 Inizializza un nuovo oggetto sessione per il dispositivo specificato, con opzioni predefinite. Altro...
 
(instancetype) - initWithDevice:traits:sessionID:sessionOptions:
 Inizializza un nuovo oggetto sessione per il dispositivo specificato. Altro...
 
(GCKRequest *) - setDeviceVolume:
 Imposta il volume del dispositivo. Altro...
 
(GCKRequest *) - setDeviceMuted:
 Imposta la disattivazione audio del dispositivo. Altro...
 
(void) - start
 Avvia la sessione. Altro...
 
(void) - endWithAction:
 Termina la sessione con l'azione specificata. Altro...
 
(void) - notifyDidStartWithSessionID:
 Chiamata dalle sottoclassi per notificare al framework che la sessione è stata avviata. Altro...
 
(void) - notifyDidFailToStartWithError:
 Chiamata dalle sottoclassi per notificare al framework che l'avvio della sessione non è riuscito. Altro...
 
(void) - notifyDidEndWithError:willTryToResume:
 Chiamata dalle sottoclassi per notificare al framework che la sessione è terminata. Altro...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 Chiamata dalle sottoclassi per notificare al framework che l'aggiornamento del volume e della disattivazione dell'audio è stato ricevuto dal dispositivo. Altro...
 
(void) - notifyDidReceiveDeviceStatus:
 Chiamata dalle sottoclassi per notificare al framework che è stato ricevuto lo stato aggiornato dal dispositivo. Altro...
 
(void) - notifyDidSuspendWithReason:
 Deprecato, non utilizzare - implementato come no-op. Altro...
 
(void) - notifyDidResume
 Deprecato, non utilizzare - implementato come no-op. Altro...
 

Riepilogo proprietà

GCKActiveInputStatus activeInputStatus
 Lo stato attuale di "ingresso attivo" del dispositivo. Altro...
 
GCKStandbyStatus standbyStatus
 Lo stato "standby" attuale del dispositivo. Altro...
 
GCKApplicationMetadataapplicationMetadata
 I metadati per l'applicazione ricevitore attualmente in esecuzione sul dispositivo ricevitore, se presenti; altrimenti nil. Altro...
 
GCKDevicedevice
 Il dispositivo a cui è associata questa sessione. Altro...
 
NSString * sessionID
 L'ID sessione corrente, se presente. Altro...
 
GCKSessionOptions * sessionOptions
 Le eventuali opzioni per la sessione. Altro...
 
GCKConnectionState connectionState
 Lo stato di connessione della sessione attuale. Altro...
 
BOOL suspended
 Un flag che indica se la sessione è attualmente sospesa. Altro...
 
NSString * deviceStatusText
 Il testo dello stato attuale del dispositivo. Altro...
 
GCKSessionTraitstraits
 Le caratteristiche della sessione. Altro...
 
float currentDeviceVolume
 Il volume attuale del dispositivo, nell'intervallo [0,0, 1,0]. Altro...
 
BOOL currentDeviceMuted
 Lo stato attuale di disattivazione audio del dispositivo. Altro...
 
GCKRemoteMediaClientremoteMediaClient
 L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione di contenuti multimediali in questa sessione. Altro...
 
GCKMediaMetadatamediaMetadata
 Gli eventuali metadati multimediali attuali. Altro...
 

Dettaglio metodo

- (instancetype) initWithDevice: (GCKDevice *)  device
sessionID: (nullable NSString *)  sessionID
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions
castOptions: (GCKCastOptions *)  castOptions 

Consente di creare una nuova sessione di trasmissione con le opzioni di trasmissione specificate.

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

Registra un canale alla sessione.

Se la sessione è connessa e l'applicazione destinatario supporta lo spazio dei nomi del canale, il canale verrà connesso automaticamente. Se la sessione non è connessa, il canale rimarrà in uno stato disconnesso fino all'avvio della sessione.

Parameters
channelThe channel to register.
Ritorni
YES se il canale è stato registrato correttamente, NO negli altri casi.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Rimuove dalla sessione un canale registrato in precedenza.

Parameters
channelThe channel to unregister.
Ritorni
YES se la registrazione del canale è stata annullata correttamente, NO in caso contrario.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Aggiunge un valore GCKCastDeviceStatusListener all'elenco dei listener di questo oggetto.

Il listener aggiunto è bloccato in modo debole e deve essere mantenuto per evitare una deallocation imprevista.

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

Rimuove un elemento GCKCastDeviceStatusListener dall'elenco dei listener di questo oggetto.

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

Consente di impostare il volume del singolo dispositivo in un gruppo multizona.

Si tratta di un'operazione asincrona.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
Ritorni
Un oggetto GCKRequest per il monitoraggio della richiesta.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Imposta lo stato disattivato del singolo dispositivo in un gruppo multizona.

Si tratta di un'operazione asincrona.

Parameters
mutedThe new muted state.
deviceThe multizone device.
Ritorni
Un oggetto GCKRequest per il monitoraggio della richiesta.
- (GCKRequest *) requestMultizoneStatus

Richiedi lo stato multizona da un gruppo multizona.

Si tratta di un'operazione asincrona. Quando viene ricevuto lo stato multizona, viene inviato un messaggio al metodo del delegato castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p).

Ritorni
Un oggetto GCKRequest per il monitoraggio della richiesta.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID 

Inizializza un nuovo oggetto sessione per il dispositivo specificato, con opzioni predefinite.

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 

Inizializza un nuovo oggetto sessione per il dispositivo specificato.

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.
Dal
4,0
- (GCKRequest *) setDeviceVolume: (float)  volume

Imposta il volume del dispositivo.

Si tratta di un'operazione asincrona. L'implementazione predefinita è no-op che non supera la richiesta con un errore GCKErrorCodeSupportedFeature.

Parameters
volumeThe new volume.
Ritorni
Un oggetto GCKRequest per il monitoraggio della richiesta.
Dal
3.4; nelle versioni precedenti del framework, questo metodo ha restituito void.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

Imposta la disattivazione audio del dispositivo.

Si tratta di un'operazione asincrona. L'implementazione predefinita è no-op che non supera la richiesta con un errore GCKErrorCodeSupportedFeature.

Parameters
mutedThe new mute state.
Ritorni
Un oggetto GCKRequest per il monitoraggio della richiesta.
Dal
3.4; nelle versioni precedenti del framework, questo metodo ha restituito void.
- (void) start

Avvia la sessione.

Si tratta di un'operazione asincrona. Deve essere sostituita dalle sottoclassi.

Fornito dalla categoria GCKSession(Protected).

- (void) endWithAction: (GCKSessionEndAction action

Termina la sessione con l'azione specificata.

Si tratta di un'operazione asincrona. Deve essere sostituita dalle sottoclassi.

Parameters
actionThe action to take when ending the session; see GCKSessionEndAction for more details.

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

Chiamata dalle sottoclassi per notificare al framework che la sessione è stata avviata.

Parameters
sessionIDThe session's unique ID.

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (GCKError *)  error

Chiamata dalle sottoclassi per notificare al framework che l'avvio della sessione non è riuscito.

Parameters
errorThe error that occurred.

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidEndWithError: (nullable NSError *)  error
willTryToResume: (BOOL)  willTryToResume 

Chiamata dalle sottoclassi per notificare al framework che la sessione è terminata.

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.

Fornito dalla categoria GCKSession(Protected).

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

Chiamata dalle sottoclassi per notificare al framework che l'aggiornamento del volume e della disattivazione dell'audio è stato ricevuto dal dispositivo.

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

Fornito dalla categoria GCKSession(Protected).

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

Chiamata dalle sottoclassi per notificare al framework che è stato ricevuto lo stato aggiornato dal dispositivo.

Parameters
statusTextThe new status.

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

Deprecato, non utilizzare: implementato in modalità autonoma.

Deprecated:
Non chiamare.

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidResume

Deprecato, non utilizzare: implementato in modalità autonoma.

Deprecated:
Non chiamare.

Fornito dalla categoria GCKSession(Protected).

Dettagli della proprietà

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

Lo stato attuale di "ingresso attivo" del dispositivo.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

Lo stato "standby" attuale del dispositivo.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

I metadati per l'applicazione ricevitore attualmente in esecuzione sul dispositivo ricevitore, se presenti; altrimenti nil.

- (GCKDevice*) device
readnonatomicstronginherited

Il dispositivo a cui è associata questa sessione.

- (NSString*) sessionID
readnonatomiccopyinherited

L'ID sessione corrente, se presente.

- (GCKSessionOptions*) sessionOptions
readnonatomicstronginherited

Le eventuali opzioni per la sessione.

Dal
4,0
- (GCKConnectionState) connectionState
readnonatomicassigninherited

Lo stato di connessione della sessione attuale.

- (BOOL) suspended
readnonatomicassigninherited

Un flag che indica se la sessione è attualmente sospesa.

Deprecated:
GCKSession non supporta più la sospensione. Se necessario, sposta questa funzionalità in una sottoclasse.
- (NSString*) deviceStatusText
readnonatomiccopyinherited

Il testo dello stato attuale del dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

Le caratteristiche della sessione.

- (float) currentDeviceVolume
readnonatomicassigninherited

Il volume attuale del dispositivo, nell'intervallo [0,0, 1,0].

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

Lo stato attuale di disattivazione audio del dispositivo.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione di contenuti multimediali in questa sessione.

La sessione è nil prima dell'inizio oppure se non supporta l'API GCKRemoteMediaClient. Le sottoclassi che forniscono un'interfaccia GCKRemoteMediaClient devono eseguire l'override del metodo getter.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstronginherited

Gli eventuali metadati multimediali attuali.

Sarà nil se la sessione non supporta lo spazio dei nomi multimediale o se al momento non sono caricati contenuti multimediali sul destinatario.