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... | |
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... | |
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... | |
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: | (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
-
device The receiver device. sessionID The session ID, if resuming; otherwise nil
.sessionOptions The session options, if any; otherwise nil
.castOptions The 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
-
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.
Il listener aggiunto è bloccato in modo debole e deve essere mantenuto per evitare una deallocation imprevista.
- 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: | (nullable GCKSessionTraits *) | traits | |
sessionID: | (nullable NSString *) | sessionID | |
Inizializza un nuovo oggetto sessione per il dispositivo specificato, con opzioni predefinite.
- 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.
- (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
-
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.sessionOptions The 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
-
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) endWithAction: | (GCKSessionEndAction) | action |
Termina la sessione con l'azione specificata.
Si tratta di un'operazione asincrona. Deve essere sostituita dalle sottoclassi.
- Parameters
-
action The 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
-
sessionID The 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
-
error The 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
-
error The error that caused the session to end, if any. Should be nil
if the session was ended intentionally.willTryToResume Whether 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
-
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: | (nullable NSString *) | 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).
- (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à
|
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.
|
readnonatomicstronginherited |
Le eventuali opzioni per la sessione.
- Dal
- 4,0
|
readnonatomicassigninherited |
Lo stato di connessione della sessione attuale.
|
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.
|
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.