Corso GCKSession

Riferimento classe GCKSession

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à

GCKDevicedevice
 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...
 
GCKSessionTraitstraits
 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...
 
GCKRemoteMediaClientremoteMediaClient
 L'oggetto GCKRemoteMediaClient che può essere utilizzato per controllare la riproduzione di contenuti multimediali in questa sessione. Altro...
 
GCKMediaMetadatamediaMetadata
 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
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.
- (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
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.
sessionOptionsThe 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
volumeThe 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
mutedThe 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
actionThe 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
sessionIDThe 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
errorThe 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
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.
willTryToResumeWhether 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
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: (nullable NSString *)  statusText

Chiamata dalle sottoclassi per notificare al framework che è stato ricevuto lo stato aggiornato dal dispositivo.

Parameters
statusTextThe 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à

- (GCKDevice*) device
readnonatomicstrong

Il dispositivo a cui è associata questa sessione.

- (NSString*) sessionID
readnonatomiccopy

L'ID sessione corrente, se presente.

- (GCKSessionOptions*) sessionOptions
readnonatomicstrong

Le eventuali opzioni per la sessione.

Dal
4,0
- (GCKConnectionState) connectionState
readnonatomicassign

Lo stato di connessione della sessione attuale.

- (BOOL) suspended
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.
- (NSString*) deviceStatusText
readnonatomiccopy

Il testo dello stato attuale del dispositivo.

- (GCKSessionTraits*) traits
readnonatomiccopy

Le caratteristiche della sessione.

- (float) currentDeviceVolume
readnonatomicassign

Il volume attuale del dispositivo, nell'intervallo [0,0, 1,0].

- (BOOL) currentDeviceMuted
readnonatomicassign

Lo stato attuale di disattivazione audio del dispositivo.

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

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