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... | |
GCKApplicationMetadata * | applicationMetadata |
I metadati per l'applicazione ricevitore attualmente in esecuzione sul dispositivo ricevitore, se presenti; altrimenti nil . Altro... | |
GCKDevice * | device |
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... | |
GCKSessionTraits * | traits |
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... | |
GCKRemoteMediaClient * | remoteMediaClient |
L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione di contenuti multimediali in questa sessione. Altro... | |
GCKMediaMetadata * | mediaMetadata |
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
-
device The receiver device. sessionID The session ID, if resuming; otherwise nil
.castOptions The 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
-
channel The 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
-
channel The 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
-
listener The listener to add.
- (void) removeDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
Rimuove un elemento GCKCastDeviceStatusListener dall'elenco dei listener di questo oggetto.
- Parameters
-
listener The 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
-
volume The new volume, in the range [0.0, 1.0]. device The 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
-
muted The new muted state. device The 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
-
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 |
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
-
volume The 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
-
muted The 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
-
stopCasting Whether 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
-
sessionID The 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
-
error The 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
-
reason The 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
-
error The 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
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The 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
-
statusText The new status.
Fornito dalla categoria GCKSession(Protected).
Dettagli della proprietà
|
readnonatomicassign |
Lo stato attuale di "ingresso attivo" del dispositivo.
|
readnonatomicassign |
Lo stato "standby" attuale del dispositivo.
|
readnonatomiccopy |
I metadati per l'applicazione ricevitore attualmente in esecuzione sul dispositivo ricevitore, se presenti; altrimenti nil
.
|
readnonatomicstronginherited |
Il dispositivo a cui è associata questa sessione.
|
readnonatomiccopyinherited |
L'ID sessione corrente, se presente.
|
readnonatomicassigninherited |
Lo stato di connessione della sessione attuale.
|
readnonatomicassigninherited |
Un flag che indica se la sessione è attualmente sospesa.
|
readnonatomiccopyinherited |
Il testo dello stato attuale del dispositivo.
|
readnonatomiccopyinherited |
Le caratteristiche della sessione.
|
readnonatomicassigninherited |
Il volume attuale del dispositivo, nell'intervallo [0,0, 1,0].
|
readnonatomicassigninherited |
Lo stato attuale di disattivazione audio del dispositivo.
|
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.
|
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.