GCKSession-Klasse

GCKSession-Klassenreferenz

Übersicht

Eine abstrakte Basisklasse, die eine Sitzung mit einem Empfängergerät darstellt.

Abgeleitete Klassen müssen die Methoden start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) und resume (GCKSession(Protected)) implementieren und die entsprechenden Benachrichtigungsmethoden (z. B. notifyDidStartWithSessionID: (GCKSession(Protected))) aufrufen, um die entsprechenden Änderungen im Sitzungsstatus anzugeben. Abgeleitete Klassen können auch setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) und remoteMediaClient implementieren, wenn das Gerät solche Vorgänge unterstützt.

Eine Sitzung wird mithilfe der Sitzungsmethoden in GCKSessionManager erstellt und gesteuert. Dabei wird die entsprechende GCKDeviceProvider verwendet, um die Sitzung zu erstellen. Anschließend werden Sitzungsanfragen an dieses GCKSession-Objekt delegiert.

Sincé
3,0

Übernimmt NSObject.

Von GCKCastSession übernommen.

Zusammenfassung der Instanzmethoden

(instancetype) - initWithDevice:traits:sessionID:
 Initialisiert ein neues Sitzungsobjekt für das angegebene Gerät. Mehr...
 
(GCKRequest *) - setDeviceVolume:
 Legt die Lautstärke des Geräts fest. Mehr...
 
(GCKRequest *) - setDeviceMuted:
 Legt die Stummschaltung des Geräts fest. Mehr...
 
(void) - start
 Startet die Sitzung. Mehr...
 
(void) - endAndStopCasting:
 Beendet die Sitzung. Mehr...
 
(void) - suspendWithReason:
 Sperrt die Sitzung aus dem angegebenen Grund. Mehr...
 
(void) - resume
 Setzt die Sitzung fort. Mehr...
 
(void) - notifyDidStartWithSessionID:
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung gestartet wurde. Mehr...
 
(void) - notifyDidFailToStartWithError:
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung nicht gestartet werden konnte. Mehr...
 
(void) - notifyDidResume
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung fortgesetzt wurde. Mehr...
 
(void) - notifyDidSuspendWithReason:
 Wird von Unterklassen aufgerufen, um das Framework über die Sperrung der Sitzung zu informieren. Mehr...
 
(void) - notifyDidEndWithError:
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung beendet wurde. Mehr...
 
(void) - notifyDidReceiveDeviceVolume:muted:
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass das Gerätelautstärke und der Stummschaltungsstatus vom Gerät empfangen wurden. Mehr...
 
(void) - notifyDidReceiveDeviceStatus:
 Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass der aktualisierte Status vom Gerät empfangen wurde. Mehr...
 

Property-Zusammenfassung

GCKDevicedevice
 Das Gerät, mit dem diese Sitzung verknüpft ist. Mehr...
 
NSString * sessionID
 Die aktuelle Sitzungs-ID, falls vorhanden. Mehr...
 
GCKConnectionState connectionState
 Der aktuelle Verbindungsstatus der Sitzung. Mehr...
 
BOOL suspended
 Eine Markierung, die angibt, ob die Sitzung gerade gesperrt ist. Mehr...
 
NSString * deviceStatusText
 Der aktuelle Text zum Gerätestatus. Mehr...
 
GCKSessionTraitstraits
 Die Sitzung läuft. Mehr...
 
float currentDeviceVolume
 Die aktuelle Gerätelautstärke im Bereich [0,0, 1,0]. Mehr...
 
BOOL currentDeviceMuted
 Der aktuelle Status zum Stummschalten des Geräts. Mehr...
 
GCKRemoteMediaClientremoteMediaClient
 Das GCKRemoteMediaClient-Objekt, mit dem die Medienwiedergabe in dieser Sitzung gesteuert werden kann. Mehr...
 
GCKMediaMetadatamediaMetadata
 Die aktuellen Medienmetadaten, falls vorhanden. Mehr...
 

Methodendetail

- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  sessionID 

Initialisiert ein neues Sitzungsobjekt für das angegebene Gerät.

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

Legt die Lautstärke des Geräts fest.

Dies ist ein asynchroner Vorgang. Die Standardimplementierung ist eine No-Op, die die Anfrage mit dem Fehler „GCKErrorCodeSupportedFeature“ nicht besteht.

Parameters
volumeThe new volume.
Gibt Folgendes zurück:
Ein GCKRequest-Objekt zum Verfolgen der Anfrage.
Sincé
3.4: In früheren Framework-Versionen hat diese Methode void zurückgegeben.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

Legt die Stummschaltung des Geräts fest.

Dies ist ein asynchroner Vorgang. Die Standardimplementierung ist eine No-Op, die die Anfrage mit dem Fehler „GCKErrorCodeSupportedFeature“ nicht besteht.

Parameters
mutedThe new mute state.
Gibt Folgendes zurück:
Ein GCKRequest-Objekt zum Verfolgen der Anfrage.
Sincé
3.4: In früheren Framework-Versionen hat diese Methode void zurückgegeben.
- (void) start

Startet die Sitzung.

Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) endAndStopCasting: (BOOL)  stopCasting

Beendet die Sitzung.

Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.

Parameters
stopCastingWhether to stop casting content to the receiver.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

Sperrt die Sitzung aus dem angegebenen Grund.

Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) resume

Setzt die Sitzung fort.

Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung gestartet wurde.

Parameters
sessionIDThe session's unique ID.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidFailToStartWithError: (NSError *)  error

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung nicht gestartet werden konnte.

Parameters
errorThe error that occurred.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidResume

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung fortgesetzt wurde.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

Wird von Unterklassen aufgerufen, um das Framework über die Sperrung der Sitzung zu informieren.

Parameters
reasonThe reason for the suspension.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidEndWithError: (NSError *__nullable)  error

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung beendet wurde.

Parameters
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidReceiveDeviceVolume: (float)  volume
muted: (BOOL)  muted 

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass das Gerätelautstärke und der Stummschaltungsstatus vom Gerät empfangen wurden.

Parameters
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable)  statusText

Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass der aktualisierte Status vom Gerät empfangen wurde.

Parameters
statusTextThe new status.

Bereitgestellt von der Kategorie GCKSession(Protected).

Property-Details

- (GCKDevice*) device
readnonatomicstrong

Das Gerät, mit dem diese Sitzung verknüpft ist.

- (NSString*) sessionID
readnonatomiccopy

Die aktuelle Sitzungs-ID, falls vorhanden.

- (GCKConnectionState) connectionState
readnonatomicassign

Der aktuelle Verbindungsstatus der Sitzung.

- (BOOL) suspended
readnonatomicassign

Eine Markierung, die angibt, ob die Sitzung gerade gesperrt ist.

- (NSString*) deviceStatusText
readnonatomiccopy

Der aktuelle Text zum Gerätestatus.

- (GCKSessionTraits*) traits
readnonatomiccopy

Die Sitzung läuft.

- (float) currentDeviceVolume
readnonatomicassign

Die aktuelle Gerätelautstärke im Bereich [0,0, 1,0].

- (BOOL) currentDeviceMuted
readnonatomicassign

Der aktuelle Status zum Stummschalten des Geräts.

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstrong

Das GCKRemoteMediaClient-Objekt, mit dem die Medienwiedergabe in dieser Sitzung gesteuert werden kann.

Es ist nil vor Beginn der Sitzung oder wenn die Sitzung die GCKRemoteMediaClient API nicht unterstützt. Unterklassen, die eine GCKRemoteMediaClient-Schnittstelle bereitstellen, müssen die Getter-Methode überschreiben.

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstrong

Die aktuellen Medienmetadaten, falls vorhanden.

Ist nil, wenn die Sitzung den Media-Namespace nicht unterstützt oder wenn keine Medien derzeit auf dem Empfänger geladen sind.