Übersicht

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

Abgeleitete Klassen müssen die Methoden start (GCKSession(Protected)) und endWithAction: (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 mit Standardoptionen. Mehr...

(instancetype)	- initWithDevice:traits:sessionID:sessionOptions:
	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)	- endWithAction:
	Beendet die Sitzung mit der angegebenen Aktion. 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)	- notifyDidEndWithError:willTryToResume:
	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...

(void)	- notifyDidSuspendWithReason:
	Verworfen, nicht verwenden - implementiert als eine Nulloperation. Mehr...

(void)	- notifyDidResume
	Verworfen, nicht verwenden - implementiert als eine Nulloperation. Mehr...

Property-Zusammenfassung
GCKDevice *	device
	Das Gerät, mit dem diese Sitzung verknüpft ist. Mehr...

NSString *	sessionID
	Die aktuelle Sitzungs-ID, falls vorhanden. Mehr...

GCKSessionOptions *	sessionOptions
	Die Sitzungsoptionen, 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...

GCKSessionTraits *	traits
	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...

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

GCKMediaMetadata *	mediaMetadata
	Die aktuellen Medienmetadaten, falls vorhanden. Mehr...

Methodendetail

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

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

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 `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

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

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 `nil` if it will be used to start a new session.
sessionOptions	The session options, if any; otherwise `nil`.

Sincé: 4,0

- (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

volume The 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

muted The 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) endWithAction: (GCKSessionEndAction) action

Beendet die Sitzung mit der angegebenen Aktion.

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

Parameters

action The action to take when ending the session; see GCKSessionEndAction for more details.

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

sessionID The 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

error The error that occurred.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidEndWithError:	(nullable NSError *)	error
willTryToResume:	(BOOL)	willTryToResume

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

Parameters

error	The error that caused the session to end, if any. Should be `nil` if the session was ended intentionally.
willTryToResume	Whether the session will try to resume itself automatically.

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

volume	The device's current volume. Must be in the range [0, 1.0];
muted	The device's current mute state.

Bereitgestellt von der Kategorie GCKSession(Protected).

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

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

Parameters

statusText The new status.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

Eingestellt, nicht verwenden – implementiert als operativ.

Deprecated:: Rufen Sie nicht an.

Bereitgestellt von der Kategorie GCKSession(Protected).

- (void) notifyDidResume

Eingestellt, nicht verwenden – implementiert als operativ.

Deprecated:: Rufen Sie nicht an.

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.

- (GCKSessionOptions*) sessionOptions

readnonatomicstrong

Die Sitzungsoptionen, falls vorhanden.

Sincé: 4,0

- (GCKConnectionState) connectionState

readnonatomicassign

Der aktuelle Verbindungsstatus der Sitzung.

- (BOOL) suspended

readnonatomicassign

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

Deprecated:: GCKSession kann nicht mehr gesperrt werden. Verschieben Sie diese Funktion bei Bedarf in eine Unterklasse.

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

GCKSession-Klasse

Übersicht

Zusammenfassung der Instanzmethoden

Property-Zusammenfassung

Methodendetail

Property-Details