Panoramica
Una classe base astratta che rappresenta una sessione con un dispositivo di ricezione.
Le sottoclassi devono implementare i metodi start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) e resume (GCKSession(Protected)) e devono richiamare i metodi di notifica appropriati (ad esempio notifyDidStartWithSessionID: (GCKSession(Protected))) per indicare le modifiche corrispondenti nello stato della sessione. Le sottoclassi possono anche implementare setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) e remoteMediaClient se il dispositivo supporta queste operazioni.
Una sessione viene creata e controllata utilizzando i metodi di sessione di GCKSessionManager, che utilizzano i GCKDeviceProvider appropriati per creare la sessione e delega le richieste di sessione all'oggetto GCKSession.
- Since
- 3,0
Eredita NSObject.
Ereditata da GCKCastSession.
Riepilogo del metodo dell'istanza | |
(instancetype) | - initWithDevice:traits:sessionID: |
Inizializza un nuovo oggetto sessione per il dispositivo specificato. Altro... | |
(GCKRequest *) | - setDeviceVolume: |
Imposta il volume del dispositivo. Altro... | |
(GCKRequest *) | - setDeviceMuted: |
Consente di impostare lo stato di disattivazione del dispositivo. Altro... | |
(void) | - start |
Avvia la sessione. Altro... | |
(void) | - endAndStopCasting: |
Termina la sessione. Altro... | |
(void) | - suspendWithReason: |
La sessione viene sospesa per il motivo specificato. Altro... | |
(void) | - resume |
Riprendi la sessione. Altro... | |
(void) | - notifyDidStartWithSessionID: |
Richiamate dalle sottoclassi per informare il framework che la sessione è stata avviata. Altro... | |
(void) | - notifyDidFailToStartWithError: |
Richiamate dalle sottoclassi per informare il framework che l'avvio della sessione non è riuscito. Altro... | |
(void) | - notifyDidResume |
Richiamato dalle sottoclassi per informare il framework che la sessione è stata ripresa. Altro... | |
(void) | - notifyDidSuspendWithReason: |
Richiamato dalle sottoclassi per informare il framework della sospensione della sessione. Altro... | |
(void) | - notifyDidEndWithError: |
Richiamate dalle sottoclassi per informare il framework che la sessione è terminata. Altro... | |
(void) | - notifyDidReceiveDeviceVolume:muted: |
Richiamate dalle sottoclassi per informare il framework che il dispositivo ha aggiornato lo stato del volume e della disattivazione audio. Altro... | |
(void) | - notifyDidReceiveDeviceStatus: |
Richiamato dalle sottoclassi per notificare il framework che ha ricevuto lo stato aggiornato dal dispositivo. Altro... | |
Riepilogo proprietà | |
GCKDevice * | device |
Il dispositivo a cui è associata questa sessione. Altro... | |
NSString * | sessionID |
L'eventuale ID sessione corrente. Altro... | |
GCKConnectionState | connectionState |
Lo stato attuale della connessione di sessione. Altro... | |
BOOL | suspended |
Un flag che indica se al momento la sessione è sospesa. Altro... | |
NSString * | deviceStatusText |
L'attuale testo dello stato del dispositivo. Altro... | |
GCKSessionTraits * | traits |
La sessione ha dei tratti. Altro... | |
float | currentDeviceVolume |
Il volume attuale del dispositivo, nell'intervallo [0.0, 1.0]. Altro... | |
BOOL | currentDeviceMuted |
Lo stato di disattivazione del dispositivo attuale. Altro... | |
GCKRemoteMediaClient * | remoteMediaClient |
L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione dei contenuti multimediali in questa sessione. Altro... | |
GCKMediaMetadata * | mediaMetadata |
Gli eventuali metadati sui contenuti multimediali correnti. Altro... | |
Dettaglio metodo
- (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.
Questa è un'operazione asincrona. L'implementazione predefinita è una soluzione no-ops che non riesce a soddisfare la richiesta con un errore GCKErrorCodeSupportedFeature.
- Parameters
-
volume The new volume.
- Valori restituiti
- Un oggetto GCKRequest per monitorare la richiesta.
- Since
- 3.4; nelle precedenti versioni del framework, questo metodo ha restituito
void
.
- (GCKRequest *) setDeviceMuted: | (BOOL) | muted |
Consente di impostare lo stato di disattivazione del dispositivo.
Questa è un'operazione asincrona. L'implementazione predefinita è una soluzione no-ops che non riesce a soddisfare la richiesta con un errore GCKErrorCodeSupportedFeature.
- Parameters
-
muted The new mute state.
- Valori restituiti
- Un oggetto GCKRequest per monitorare la richiesta.
- Since
- 3.4; nelle precedenti versioni del framework, questo metodo ha restituito
void
.
- (void) start |
Avvia la sessione.
Questa è un'operazione asincrona. Devono essere sostituite da sottoclassi.
Fornito dalla categoria GCKSession(Protected).
- (void) endAndStopCasting: | (BOOL) | stopCasting |
Termina la sessione.
Questa è un'operazione asincrona. Devono essere sostituite da sottoclassi.
- Parameters
-
stopCasting Whether to stop casting content to the receiver.
Fornito dalla categoria GCKSession(Protected).
- (void) suspendWithReason: | (GCKConnectionSuspendReason) | reason |
La sessione viene sospesa per il motivo specificato.
Questa è un'operazione asincrona. Devono essere sostituite da sottoclassi.
Fornito dalla categoria GCKSession(Protected).
- (void) resume |
Riprendi la sessione.
Questa è un'operazione asincrona. Devono essere sostituite da sottoclassi.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
Richiamate dalle sottoclassi per informare il framework che la sessione è stata avviata.
- Parameters
-
sessionID The session's unique ID.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidFailToStartWithError: | (NSError *) | error |
Richiamate dalle sottoclassi per informare il framework che l'avvio della sessione non è riuscito.
- Parameters
-
error The error that occurred.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidResume |
Richiamato dalle sottoclassi per informare il framework che la sessione è stata ripresa.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidSuspendWithReason: | (GCKConnectionSuspendReason) | reason |
Richiamato dalle sottoclassi per informare il framework della sospensione della sessione.
- Parameters
-
reason The reason for the suspension.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidEndWithError: | (NSError *__nullable) | error |
Richiamate dalle sottoclassi per informare il 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 | |
Richiamate dalle sottoclassi per informare il framework che il dispositivo ha aggiornato lo stato del volume e della disattivazione audio.
- 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 |
Richiamato dalle sottoclassi per notificare il framework che ha ricevuto lo stato aggiornato dal dispositivo.
- Parameters
-
statusText The new status.
Fornito dalla categoria GCKSession(Protected).
Dettaglio proprietà
|
readnonatomicstrong |
Il dispositivo a cui è associata questa sessione.
|
readnonatomiccopy |
L'eventuale ID sessione corrente.
|
readnonatomicassign |
Lo stato attuale della connessione di sessione.
|
readnonatomicassign |
Un flag che indica se al momento la sessione è sospesa.
|
readnonatomiccopy |
L'attuale testo dello stato del dispositivo.
|
readnonatomiccopy |
La sessione ha dei tratti.
|
readnonatomicassign |
Il volume attuale del dispositivo, nell'intervallo [0.0, 1.0].
|
readnonatomicassign |
Lo stato di disattivazione del dispositivo attuale.
|
readnonatomicstrong |
L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione dei contenuti multimediali in questa sessione.
È nil
prima dell'inizio della sessione o se la sessione non supporta l'API GCKRemoteMediaClient. Le sottoclassi che forniscono un'interfaccia GCKRemoteMediaClient devono sostituire il metodo getter.
|
readnonatomicstrong |
Gli eventuali metadati sui contenuti multimediali correnti.
È nil
se la sessione non supporta lo spazio dei nomi dei contenuti multimediali o se al momento non è presente alcun contenuto multimediale caricato sul ricevitore.