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)) 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à

GCKDevicedevice
 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...
 
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: (nullable GCKSessionTraits *)  traits
sessionID: (nullable NSString *)  sessionID 

Inizializza un nuovo oggetto sessione per il dispositivo specificato, con le 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.
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
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) endWithAction: (GCKSessionEndAction action

Termina la sessione con l'azione specificata.

Questa è un'operazione asincrona. Devono essere sostituite da sottoclassi.

Parameters
actionThe 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
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) notifyDidEndWithError: (nullable NSError *)  error
willTryToResume: (BOOL)  willTryToResume 

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.
willTryToResumeWhether 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
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

Richiamato dalle sottoclassi per notificare il framework che ha ricevuto lo stato aggiornato dal dispositivo.

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

- (GCKDevice*) device
readnonatomicstrong

Il dispositivo a cui è associata questa sessione.

- (NSString*) sessionID
readnonatomiccopy

L'eventuale ID sessione corrente.

- (GCKSessionOptions*) sessionOptions
readnonatomicstrong

Le opzioni della sessione, se disponibili.

Since
4,0
- (GCKConnectionState) connectionState
readnonatomicassign

Lo stato attuale della connessione di sessione.

- (BOOL) suspended
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.
- (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.