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
YESse il canale è stato registrato correttamente,NOnegli altri casi.
| - (BOOL) removeChannel: | (GCKCastChannel *) | channel |
Rimuove dalla sessione un canale registrato in precedenza.
- Parameters
-
channel The channel to unregister.
- Ritorni
YESse la registrazione del canale è stata annullata correttamente,NOin 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 nilif 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 nilif 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.