Classe GCKSession

Riferimento alla classe GCKSession

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à

GCKDevicedevice
 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...
 
GCKSessionTraitstraits
 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...
 
GCKRemoteMediaClientremoteMediaClient
 L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione dei contenuti multimediali in questa sessione. Altro...
 
GCKMediaMetadatamediaMetadata
 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
deviceThe device.
traitsThe session traits.
sessionIDThe 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
volumeThe 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
mutedThe 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
stopCastingWhether 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
sessionIDThe 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
errorThe 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
reasonThe 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
errorThe 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
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe 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
statusTextThe new status.

Fornito dalla categoria GCKSession(Protected).

Dettaglio proprietà

- (GCKDevice*) device
readnonatomicstrong

Il dispositivo a cui è associata questa sessione.

- (NSString*) sessionID
readnonatomiccopy

L'eventuale ID sessione corrente.

- (GCKConnectionState) connectionState
readnonatomicassign

Lo stato attuale della connessione di sessione.

- (BOOL) suspended
readnonatomicassign

Un flag che indica se al momento la sessione è sospesa.

- (NSString*) deviceStatusText
readnonatomiccopy

L'attuale testo dello stato del dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopy

La sessione ha dei tratti.

- (float) currentDeviceVolume
readnonatomicassign

Il volume attuale del dispositivo, nell'intervallo [0.0, 1.0].

- (BOOL) currentDeviceMuted
readnonatomicassign

Lo stato di disattivazione del dispositivo attuale.

- (GCKRemoteMediaClient*) remoteMediaClient
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.

- (GCKMediaMetadata*) mediaMetadata
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.