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

Dal
3,0

Eredita GCKSession.

Riepilogo del metodo di istanza

(instancetype) - initWithDevice:sessionID:castOptions:
 Inizializzatore designato. 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. 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) - endAndStopCasting:
 Termina la sessione. Altro...
 
(void) - suspendWithReason:
 Sospende la sessione per il motivo specificato. Altro...
 
(void) - resume
 Riprende la sessione. 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) - notifyDidResume
 Chiamata dalle sottoclassi per notificare al framework che la sessione è stata ripresa. Altro...
 
(void) - notifyDidSuspendWithReason:
 Chiamata dalle sottoclassi per notificare al framework che la sessione è stata sospesa. Altro...
 
(void) - notifyDidEndWithError:
 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...
 

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

Inizializzatore designato.

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.
castOptionsThe Cast options.
- (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.

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

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

Termina la sessione.

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

Parameters
stopCastingWhether to stop casting content to the receiver.

Fornito dalla categoria GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

Sospende la sessione per il motivo specificato.

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

Fornito dalla categoria GCKSession(Protected).

- (void) resume

Riprende la sessione.

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

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: (NSError *)  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) notifyDidResume

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

Fornito dalla categoria GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

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

Parameters
reasonThe reason for the suspension.

Fornito dalla categoria GCKSession(Protected).

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

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.

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: (NSString *__nullable)  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).

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.

- (GCKConnectionState) connectionState
readnonatomicassigninherited

Lo stato di connessione della sessione attuale.

- (BOOL) suspended
readnonatomicassigninherited

Un flag che indica se la sessione è attualmente sospesa.

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