Überblick

Eine Klasse, die eine Streamingsitzung mit einem Empfängergerät verwaltet.

Sitzungen werden automatisch von GCKSessionManager erstellt und verwaltet. Die Anwendung sollte die Methoden des Sitzungslebenszyklus wie start (GCKSession(Protected)) oder endAndStopCasting: (GCKSession(Protected)) nicht direkt aufrufen.

Seit: 3,0

Übernimmt GCKSession.

Übersicht über Instanzmethoden
(instancetype)	- initWithDevice:sessionID:castOptions:
	Definierter Initialisierer. Mehr...

(BOOL)	- addChannel:
	Registriert einen Kanal in der Sitzung. Mehr...

(BOOL)	- removeChannel:
	Entfernt einen zuvor registrierten Kanal aus der Sitzung. Mehr...

(void)	- addDeviceStatusListener:
	Fügt der Listener-Liste dieses Objekts ein GCKCastDeviceStatusListener hinzu. Mehr...

(void)	- removeDeviceStatusListener:
	Entfernt ein GCKCastDeviceStatusListener aus der Liste der Listener dieses Objekts. Mehr...

(GCKRequest *)	- setDeviceVolume:forMultizoneDevice:
	Legt die Lautstärke eines einzelnen Geräts in einer Gruppe in mehreren Zonen fest. Mehr...

(GCKRequest *)	- setDeviceMuted:forMultizoneDevice:
	Legt den stummgeschalteten Status des einzelnen Geräts in einer Mehrzonengruppe fest. Mehr...

(GCKRequest *)	- requestMultizoneStatus
	Fordern Sie den Mehrzonenstatus von einer Mehrzonengruppe an. Mehr...

(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:
	Unterbricht die Sitzung aus dem angegebenen Grund. Mehr...

(void)	- resume
	Setzt die Sitzung fort. Mehr...

(void)	- notifyDidStartWithSessionID:
	Wird von Unterklassen aufgerufen, um das Framework zu benachrichtigen, dass die Sitzung gestartet wurde. Mehr...

(void)	- notifyDidFailToStartWithError:
	Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung nicht gestartet wurde. 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 darüber zu informieren, dass die Sitzung ausgesetzt wurde. Mehr...

(void)	- notifyDidEndWithError:
	Wird von Unterklassen aufgerufen, um das Framework über das Ende der Sitzung zu informieren. Mehr...

(void)	- notifyDidReceiveDeviceVolume:muted:
	Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Gerätelautstärke und der Stummschaltungsstatus vom Gerät aktualisiert 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
GCKActiveInputStatus	activeInputStatus
	Der aktuelle Status des Geräts als „aktive Eingabe“. Mehr...

GCKStandbyStatus	standbyStatus
	Der aktuelle Stand-by-Status des Geräts. Mehr...

GCKApplicationMetadata *	applicationMetadata
	Die Metadaten für die Empfangsanwendung, die aktuell auf dem Empfängergerät ausgeführt wird, falls vorhanden; andernfalls `nil`. Mehr...

GCKDevice *	device
	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 derzeit ausgesetzt ist. Mehr...

NSString *	deviceStatusText
	Text für den aktuellen Gerätestatus Mehr...

GCKSessionTraits *	traits
	Die Sitzungseigenschaften. Mehr...

float	currentDeviceVolume
	Die aktuelle Gerätelautstärke im Bereich [0, 0 bis 1, 0]. Mehr...

BOOL	currentDeviceMuted
	Der aktuelle Stummschaltungsstatus 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
sessionID:	(NSString *__nullable)	sessionID
castOptions:	(GCKCastOptions *)	castOptions

Definierter Initialisierer.

Erstellt eine neue Streamingsitzung mit den angegebenen Streamingoptionen.

Parameters

device	The receiver device.
sessionID	The session ID, if resuming; otherwise `nil`.
castOptions	The Cast options.

- (BOOL) addChannel: (GCKCastChannel *) channel

Registriert einen Kanal in der Sitzung.

Wenn die Sitzung verbunden ist und die Empfängeranwendung den Namespace des Kanals unterstützt, wird der Kanal automatisch verbunden. Wenn keine Verbindung zur Sitzung besteht, bleibt der Kanal so lange getrennt, bis die Sitzung gestartet wird.

Parameters

channel The channel to register.

Rückgaben: YES, wenn der Kanal erfolgreich registriert wurde, andernfalls NO.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Entfernt einen zuvor registrierten Kanal aus der Sitzung.

Parameters

channel The channel to unregister.

Rückgaben: YES, wenn die Registrierung des Kanals aufgehoben wurde, andernfalls NO.

- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

Fügt der Listener-Liste dieses Objekts ein GCKCastDeviceStatusListener hinzu.

Parameters

listener The listener to add.

- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

Entfernt ein GCKCastDeviceStatusListener aus der Liste der Listener dieses Objekts.

Parameters

listener The listener to remove.

- (GCKRequest *) setDeviceVolume:	(float)	volume
forMultizoneDevice:	(GCKMultizoneDevice *)	device

Legt die Lautstärke eines einzelnen Geräts in einer Gruppe in mehreren Zonen fest.

Dies ist ein asynchroner Vorgang.

Parameters

volume	The new volume, in the range [0.0, 1.0].
device	The multizone device.

Rückgaben: Ein GCKRequest-Objekt zum Verfolgen der Anfrage.

- (GCKRequest *) setDeviceMuted:	(BOOL)	muted
forMultizoneDevice:	(GCKMultizoneDevice *)	device

Legt den stummgeschalteten Status des einzelnen Geräts in einer Mehrzonengruppe fest.

Dies ist ein asynchroner Vorgang.

Parameters

muted	The new muted state.
device	The multizone device.

Rückgaben: Ein GCKRequest-Objekt zum Verfolgen der Anfrage.

- (GCKRequest *) requestMultizoneStatus

Fordern Sie den Mehrzonenstatus von einer Mehrzonengruppe an.

Dies ist ein asynchroner Vorgang. Wenn der Mehrzonenstatus empfangen wird, wird die Delegatmethode castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) benachrichtigt.

Rückgaben: Ein GCKRequest-Objekt zum Verfolgen der Anfrage.

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

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.

- (GCKRequest *) setDeviceVolume: (float) volume

Legt die Lautstärke des Geräts fest.

Dies ist ein asynchroner Vorgang. Die Standardimplementierung ist ein No-Op, bei dem die Anfrage mit dem Fehler GCKErrorCodeSupportedFeature scheitert.

Parameters

volume The new volume.

Rückgaben: Ein GCKRequest-Objekt zum Verfolgen der Anfrage.

Seit: 3.4. In früheren Framework-Versionen gab diese Methode void zurück.

- (GCKRequest *) setDeviceMuted: (BOOL) muted

Legt die Stummschaltung des Geräts fest.

Dies ist ein asynchroner Vorgang. Die Standardimplementierung ist ein No-Op, bei dem die Anfrage mit dem Fehler GCKErrorCodeSupportedFeature scheitert.

Parameters

muted The new mute state.

Rückgaben: Ein GCKRequest-Objekt zum Verfolgen der Anfrage.

Seit: 3.4. In früheren Framework-Versionen gab diese Methode void zurück.

- (void) start

Startet die Sitzung.

Dies ist ein asynchroner Vorgang. Muss von Unterklassen überschrieben werden.

Bereitgestellt von der Kategorie „GCKSession(Protected)“.

- (void) endAndStopCasting: (BOOL) stopCasting

Beendet die Sitzung.

Dies ist ein asynchroner Vorgang. Muss von Unterklassen überschrieben werden.

Parameters

stopCasting Whether to stop casting content to the receiver.

Bereitgestellt von der Kategorie „GCKSession(Protected)“.

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

Unterbricht die Sitzung aus dem angegebenen Grund.

Dies ist ein asynchroner Vorgang. Muss von Unterklassen überschrieben werden.

Bereitgestellt von der Kategorie „GCKSession(Protected)“.

- (void) resume

Setzt die Sitzung fort.

Dies ist ein asynchroner Vorgang. Muss von Unterklassen überschrieben werden.

Bereitgestellt von der Kategorie „GCKSession(Protected)“.

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

Wird von Unterklassen aufgerufen, um das Framework zu benachrichtigen, 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 wurde.

Parameters

error The 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 darüber zu informieren, dass die Sitzung ausgesetzt wurde.

Parameters

reason The reason for the suspension.

Bereitgestellt von der Kategorie „GCKSession(Protected)“.

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

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

Parameters

error The 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 die Gerätelautstärke und der Stummschaltungsstatus vom Gerät aktualisiert 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: (NSString *__nullable) 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)“.

Objektdetails

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

Der aktuelle Status des Geräts als „aktive Eingabe“.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

Der aktuelle Stand-by-Status des Geräts.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Die Metadaten für die Empfangsanwendung, die aktuell auf dem Empfängergerät ausgeführt wird, falls vorhanden; andernfalls nil.

- (GCKDevice*) device

readnonatomicstronginherited

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

- (NSString*) sessionID

readnonatomiccopyinherited

Die aktuelle Sitzungs-ID, falls vorhanden.

- (GCKConnectionState) connectionState

readnonatomicassigninherited

Der aktuelle Verbindungsstatus der Sitzung.

- (BOOL) suspended

readnonatomicassigninherited

Eine Markierung, die angibt, ob die Sitzung derzeit ausgesetzt ist.

- (NSString*) deviceStatusText

readnonatomiccopyinherited

Text für den aktuellen Gerätestatus

- (GCKSessionTraits*) traits

readnonatomiccopyinherited

Die Sitzungseigenschaften.

- (float) currentDeviceVolume

readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted

readnonatomicassigninherited

Der aktuelle Stummschaltungsstatus des Geräts.

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstronginherited

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

Es ist nil, bevor die Sitzung gestartet wurde oder wenn die Sitzung die GCKRemoteMediaClient API nicht unterstützt. Abgeleitete Klassen, die eine GCKRemoteMediaClient-Schnittstelle bereitstellen, müssen die Getter-Methode überschreiben.

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstronginherited

Die aktuellen Medienmetadaten, falls vorhanden.

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

GCKCastSession-Klasse

Überblick

Übersicht über Instanzmethoden

Property-Zusammenfassung

Methodendetail

Objektdetails