Panoramica
Una classe base astratta che rappresenta una sessione con un dispositivo ricevitore.
Le sottoclassi devono implementare i metodi start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) e resume (GCKSession(Protected)) e devono 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 di sessione in GCKSessionManager, che utilizza l'GCKDeviceProvider appropriato per creare la sessione, quindi delega le richieste di sessione a quell'oggetto GCKSession.
- Dal
- 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: |
| Imposta lo stato di disattivazione dell'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: |
| Chiamato dalle sottoclassi per notificare al framework che la sessione è stata avviata. Altro… | |
| (void) | - notifyDidFailToStartWithError: |
| Chiamato dalle sottoclassi per notificare al framework che la sessione non è stata avviata. Altro… | |
| (void) | - notifyDidResume |
| Chiamato dalle sottoclassi per notificare al framework che la sessione è stata ripresa. Altro… | |
| (void) | - notifyDidSuspendWithReason: |
| Chiamato dalle sottoclassi per notificare al framework che la sessione è stata sospesa. Altro… | |
| (void) | - notifyDidEndWithError: |
| Chiamato dalle sottoclassi per notificare al framework che la sessione è terminata. Altro… | |
| (void) | - notifyDidReceiveDeviceVolume:muted: |
| Chiamato dalle sottoclassi per comunicare al framework che sono stati ricevuti dal dispositivo il volume e lo stato di disattivazione dell'audio aggiornati. Altro… | |
| (void) | - notifyDidReceiveDeviceStatus: |
| Chiamato dalle sottoclassi per comunicare al framework che è stato ricevuto lo stato aggiornato dal dispositivo. Altro… | |
Riepilogo della proprietà | |
| GCKDevice * | device |
| Il dispositivo a cui è associata questa sessione. Altro… | |
| NSString * | sessionID |
| L'ID sessione corrente, se presente. Altro… | |
| GCKConnectionState | connectionState |
| Lo stato della connessione della sessione corrente. 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 |
| I tratti della sessione. Altro… | |
| float | currentDeviceVolume |
| Il volume attuale del dispositivo, nell'intervallo [0.0, 1.0]. Altro… | |
| BOOL | currentDeviceMuted |
| Lo stato di disattivazione dell'audio 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 multimediali correnti. Altro… | |
Dettagli 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 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 è un'operazione no-op che non riesce a eseguire la richiesta con un errore GCKErrorCodeUnsupportedFeature.
- Parameters
-
volume The new volume.
- Resi
- Un oggetto GCKRequest per monitorare la richiesta.
- Dal
- 3.4; nelle versioni precedenti del framework, questo metodo restituiva
void.
| - (GCKRequest *) setDeviceMuted: | (BOOL) | muted |
Imposta lo stato di disattivazione dell'audio del dispositivo.
Si tratta di un'operazione asincrona. L'implementazione predefinita è un'operazione no-op che non riesce a eseguire la richiesta con un errore GCKErrorCodeUnsupportedFeature.
- Parameters
-
muted The new mute state.
- Resi
- Un oggetto GCKRequest per monitorare la richiesta.
- Dal
- 3.4; nelle versioni precedenti del framework, questo metodo restituiva
void.
| - (void) start |
Avvia la sessione.
Si tratta di un'operazione asincrona. Deve essere sostituito dalle sottoclassi.
Fornito dalla categoria GCKSession(Protected).
| - (void) endAndStopCasting: | (BOOL) | stopCasting |
Termina la sessione.
Si tratta di un'operazione asincrona. Deve essere sostituito 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 sostituito dalle sottoclassi.
Fornito dalla categoria GCKSession(Protected).
| - (void) resume |
Riprende la sessione.
Si tratta di un'operazione asincrona. Deve essere sostituito dalle sottoclassi.
Fornito dalla categoria GCKSession(Protected).
| - (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
Chiamato 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 |
Chiamato dalle sottoclassi per notificare al framework che la sessione non è stata avviata.
- Parameters
-
error The error that occurred.
Fornito dalla categoria GCKSession(Protected).
| - (void) notifyDidResume |
Chiamato dalle sottoclassi per notificare al framework che la sessione è stata ripresa.
Fornito dalla categoria GCKSession(Protected).
| - (void) notifyDidSuspendWithReason: | (GCKConnectionSuspendReason) | reason |
Chiamato 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 |
Chiamato 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 | |
Chiamato dalle sottoclassi per comunicare al framework che sono stati ricevuti dal dispositivo il volume e lo stato di disattivazione dell'audio aggiornati.
- 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 |
Chiamato dalle sottoclassi per comunicare al framework che è stato 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'ID sessione corrente, se presente.
|
readnonatomicassign |
Lo stato della connessione della sessione corrente.
|
readnonatomicassign |
Un flag che indica se la sessione è attualmente sospesa.
|
readnonatomiccopy |
Il testo dello stato attuale del dispositivo.
|
readnonatomiccopy |
I tratti della sessione.
|
readnonatomicassign |
Il volume attuale del dispositivo, nell'intervallo [0.0, 1.0].
|
readnonatomicassign |
Lo stato di disattivazione dell'audio 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 eseguire l'override del metodo getter.
|
readnonatomicstrong |
Gli eventuali metadati multimediali correnti.
Sarà nil se la sessione non supporta lo spazio dei nomi multimediali o se al momento non sono caricati contenuti multimediali sul ricevitore.