Panoramica
Una classe base astratta che rappresenta una sessione con un dispositivo di ricezione.
Le sottoclassi devono implementare i metodi start (GCKSession(Protected)) e endWithAction: (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, con le 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: |
Consente di impostare lo stato di disattivazione del dispositivo. Altro... | |
(void) | - start |
Avvia la sessione. Altro... | |
(void) | - endWithAction: |
Termina la sessione con l'azione specificata. 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) | - notifyDidEndWithError:willTryToResume: |
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... | |
(void) | - notifyDidSuspendWithReason: |
Obsoleto, non utilizzare - implementato come autonomo. Altro... | |
(void) | - notifyDidResume |
Obsoleto, non utilizzare - implementato come autonomo. Altro... | |
Riepilogo proprietà | |
GCKDevice * | device |
Il dispositivo a cui è associata questa sessione. Altro... | |
NSString * | sessionID |
L'eventuale ID sessione corrente. Altro... | |
GCKSessionOptions * | sessionOptions |
Le opzioni della sessione, se disponibili. 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: | (nullable GCKSessionTraits *) | traits | |
sessionID: | (nullable NSString *) | sessionID | |
Inizializza un nuovo oggetto sessione per il dispositivo specificato, con le 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
.
- Since
- 4,0
- (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) endWithAction: | (GCKSessionEndAction) | action |
Termina la sessione con l'azione specificata.
Questa è un'operazione asincrona. Devono essere sostituite da 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 |
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) notifyDidEndWithError: | (nullable NSError *) | error | |
willTryToResume: | (BOOL) | willTryToResume | |
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.willTryToResume Whether the session will try to resume itself automatically.
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: | (nullable NSString *) | 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).
- (void) notifyDidSuspendWithReason: | (GCKConnectionSuspendReason) | reason |
Obsoleto, non utilizzare - implementato come autonomo.
- Deprecated:
- Non chiamare.
Fornito dalla categoria GCKSession(Protected).
- (void) notifyDidResume |
Obsoleto, non utilizzare - implementato come autonomo.
- Deprecated:
- Non chiamare.
Fornito dalla categoria GCKSession(Protected).
Dettaglio proprietà
|
readnonatomicstrong |
Il dispositivo a cui è associata questa sessione.
|
readnonatomiccopy |
L'eventuale ID sessione corrente.
|
readnonatomicstrong |
Le opzioni della sessione, se disponibili.
- Since
- 4,0
|
readnonatomicassign |
Lo stato attuale della connessione di sessione.
|
readnonatomicassign |
Un flag che indica se al momento la sessione è sospesa.
- Deprecated: Lo stato di
- GCKSession non è più sospeso. Se necessario, sposta questa funzionalità in una classe secondaria.
|
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.