Panoramica
Una classe base astratta che rappresenta una sessione con un dispositivo ricevente.
Le sottoclassi devono implementare i metodi start (GCKSession(Protected)) e endWithAction: (GCKSession(Protected)) e chiamare 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 sessione in GCKSessionManager, che utilizza il valore GCKDeviceProvider appropriato per creare la sessione e poi delega le richieste di sessione a questo oggetto GCKSession.
- Dal
- 3,0
Eredita NSObject.
Ereditato da GCKCastSession.
Riepilogo del metodo di istanza | |
| (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à | |
| 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 | |
| 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 nilif 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 nilif 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 nilif 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à
|
readnonatomicstrong |
Il dispositivo a cui è associata questa sessione.
|
readnonatomiccopy |
L'ID sessione corrente, se presente.
|
readnonatomicstrong |
Le eventuali opzioni per la sessione.
- Dal
- 4,0
|
readnonatomicassign |
Lo stato di connessione della sessione attuale.
|
readnonatomicassign |
Un flag che indica se la sessione è attualmente sospesa.
- Deprecated:
- GCKSession non supporta più la sospensione. Se necessario, sposta questa funzionalità in una sottoclasse.
|
readnonatomiccopy |
Il testo dello stato attuale del dispositivo.
|
readnonatomiccopy |
Le caratteristiche della sessione.
|
readnonatomicassign |
Il volume attuale del dispositivo, nell'intervallo [0,0, 1,0].
|
readnonatomicassign |
Lo stato attuale di disattivazione audio del dispositivo.
|
readnonatomicstrong |
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.
|
readnonatomicstrong |
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.