Übersicht

Ein Kurs, über den Sitzungen verwaltet werden

Mit der Methode startSessionWithDevice: (GCKSessionManager) wird eine neue Sitzung mit einem bestimmten GCKDevice erstellt. Der Sitzungsmanager verwendet GCKDeviceProvider für diesen Gerätetyp, um ein neues GCKSession-Objekt zu erstellen, an das anschließend alle Sitzungsanfragen delegiert werden.

GCKSessionManager übernimmt die automatische Wiederaufnahme unterbrochener Sitzungen, also das Fortsetzen von Sitzungen, die beendet wurden, als die Anwendung in den Hintergrund ging, oder wenn die Anwendung abgestürzt ist oder vom Nutzer erzwungen wurde. Wenn die Anwendung fortgesetzt oder neu gestartet wird, wartet der Sitzungsmanager für eine kurze Zeit, bis der Geräteanbieter des Geräts der gesperrten Sitzung das Gerät wiederfindet. Ist dies der Fall, wird versucht, die Verbindung zum Gerät wiederherzustellen und automatisch neu zu starten.

Wenn die Anwendung eine GCKUICastButton ohne Ziel und Auswahl erstellt hat, wird beim Tippen auf die Schaltfläche das Standard-Dialogfeld angezeigt. Sitzungen werden je nach Nutzerauswahl oder Verbindung zu einem Gerät automatisch gestartet und beendet. Wenn die Anwendung jedoch eine eigene Benutzeroberfläche für die Geräteauswahl/-steuerung bereitstellt, sollte sie GCKSessionManager direkt verwenden, um Sitzungen zu erstellen und zu steuern.

Unabhängig davon, ob die Anwendung GCKSessionManager zum Steuern von Sitzungen verwendet oder nicht, kann ein GCKSessionManagerListener angehängt werden, um über Sitzungsereignisse benachrichtigt zu werden. Außerdem kann sie mit KVO das connectionState-Attribut beobachten, um den aktuellen Lebenszyklusstatus der Sitzung zu verfolgen.

Seit: 3,0

Übernimmt NSObject.

Zusammenfassung der Instanzmethoden
(instancetype)	- init
	Der Standard-Initialisierer ist nicht verfügbar. Mehr...

(BOOL)	- startSessionWithDevice:
	Startet eine neue Sitzung mit dem angegebenen Gerät. Dabei werden die Standardsitzungsoptionen verwendet, die gegebenenfalls für die Gerätekategorie registriert wurden. Mehr...

(BOOL)	- startSessionWithDevice:sessionOptions:
	Startet eine neue Sitzung mit dem angegebenen Gerät und den angegebenen Optionen. Mehr...

(BOOL)	- startSessionWithOpenURLOptions:sessionOptions:
	Versuche, eine Sitzung mit Optionen zu starten oder zu starten, die an die Methode UIApplicationDelegate::application:openURL:options: übergeben wurden. Mehr...

(BOOL)	- suspendSessionWithReason:
	Sperre die aktuelle Sitzung. Mehr...

(BOOL)	- endSession
	Beendet die aktuelle Sitzung. Mehr...

(BOOL)	- endSessionAndStopCasting:
	Beendet die aktuelle Sitzung und beendet das Streamen, wenn ein Gerät verbunden ist. Ist dies nicht der Fall, wird das Streaming beendet, sofern mehrere Geräte verbunden sind. Mehr...

(BOOL)	- hasConnectedSession
	Testet, ob eine Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. Mehr...

(BOOL)	- hasConnectedCastSession
	Testet, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. Mehr...

(void)	- setDefaultSessionOptions:forDeviceCategory:
	Legt die standardmäßigen Sitzungsoptionen für die angegebene Gerätekategorie fest.Die Sitzungsoptionen werden an die Methode createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) übergeben, wenn der Nutzer ein Gerät aus dem Streaming-Dialogfeld auswählt. Mehr...

(nullable GCKSessionOptions *)	- defaultSessionOptionsForDeviceCategory:
	Ruft die Standardsitzungsoptionen für eine bestimmte Gerätekategorie ab. Mehr...

(void)	- addListener:
	Fügt einen Listener für den Empfang von Benachrichtigungen hinzu. Mehr...

(void)	- removeListener:
	Entfernt einen Listener, der zuvor mit addListener: hinzugefügt wurde. Mehr...

Property-Übersicht
GCKSession *	currentSession
	Die aktuelle Sitzung, falls vorhanden. Mehr...

GCKCastSession *	currentCastSession
	Die aktuelle Streamingsitzung, falls vorhanden. Mehr...

GCKConnectionState	connectionState
	Der aktuelle Verbindungsstatus der Sitzung. Mehr...

Methodendetail

- (instancetype) init

Der Standard-Initialisierer ist nicht verfügbar.

- (BOOL) startSessionWithDevice: (GCKDevice *) device

Startet eine neue Sitzung mit dem angegebenen Gerät. Dabei werden die Standardsitzungsoptionen verwendet, die gegebenenfalls für die Gerätekategorie registriert wurden.

Dies ist ein asynchroner Vorgang.

Parameters

device The device to use for this session.

Rückgaben: YES, wenn der Vorgang erfolgreich gestartet wurde, NO, wenn derzeit eine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.

- (BOOL) startSessionWithDevice:	(GCKDevice *)	device
sessionOptions:	(nullable GCKSessionOptions *)	options

Startet eine neue Sitzung mit dem angegebenen Gerät und den angegebenen Optionen.

Dies ist ein asynchroner Vorgang.

Parameters

device	The device to use for this session.
options	The options for this session, if any. May be `nil`.

Rückgaben: YES, wenn der Vorgang erfolgreich gestartet wurde, NO, wenn derzeit eine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.

Seit: 4,0

- (BOOL) startSessionWithOpenURLOptions:	(GCKOpenURLOptions *)	openURLOptions
sessionOptions:	(nullable GCKSessionOptions *)	sessionOptions

Versuche, eine Sitzung mit Optionen zu starten oder zu starten, die an die Methode UIApplicationDelegate::application:openURL:options: übergeben wurden.

Normalerweise ist das eine Anfrage zur Teilnahme an einer bestehenden Cast-Sitzung auf einem bestimmten Gerät, das von einer anderen App initiiert wurde.

Parameters

openURLOptions	The options that were extracted from the URL.
sessionOptions	The options for this session, if any. May be `nil`.

Rückgaben: YES, wenn der Vorgang erfolgreich gestartet wurde, NO, wenn bereits eine Sitzung eingerichtet ist oder die OpenURL-Optionen nicht die erforderlichen Streaming-Optionen enthalten.

Seit: 4,0

- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason) reason

Sperre die aktuelle Sitzung.

Dies ist ein asynchroner Vorgang.

Parameters

reason The reason for the suspension.

Rückgaben: YES, wenn der Vorgang erfolgreich gestartet wurde, NO, wenn derzeit keine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.

- (BOOL) endSession

Beendet die aktuelle Sitzung.

Dies ist ein asynchroner Vorgang.

Rückgaben: YES, wenn der Vorgang erfolgreich gestartet wurde, NO, wenn derzeit keine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.

- (BOOL) endSessionAndStopCasting: (BOOL) stopCasting

Beendet die aktuelle Sitzung und beendet das Streamen, wenn ein Gerät verbunden ist. Ist dies nicht der Fall, wird das Streaming beendet, sofern mehrere Geräte verbunden sind.

Geben Sie mit dem Parameter stopCasting an, ob das Streamen auf dem Empfänger beendet werden soll, wenn die Sitzung endet. Dieser Parameter gilt nur, wenn mehrere Absendergeräte verbunden sind. Dieselbe App ist beispielsweise auf mehreren Absendergeräten geöffnet und jedes Übertragungsgerät hat eine aktive Streamingsitzung mit demselben Empfängergerät.

Wenn du stopCasting auf YES setzt, beendet die Empfänger-App das Streamen, wenn mehrere Geräte verbunden sind.
Wenn stopCasting den Wert NO hat und andere Geräte eine aktive Sitzung haben, wird der Empfänger weiter abgespielt.
Wenn nur ein Absendergerät verbunden ist, stoppt die Empfänger-App das Streamen von Medien und ignoriert den Wert von stopCasting, selbst wenn dieser auf NO gesetzt ist.

Parameters

stopCasting Whether casting on the receiver should stop when the session ends. Only used when multiple sender devices are connected.

Rückgaben: YES, wenn der Vorgang zum Beenden der Sitzung erfolgreich gestartet wurde, NO, wenn derzeit keine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.

- (BOOL) hasConnectedSession

Testet, ob eine Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist.

Der Status lautet YES, wenn der Sitzungsstatus GCKConnectionStateConnected lautet.

- (BOOL) hasConnectedCastSession

Testet, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist.

Der Status lautet YES, wenn der Sitzungsstatus „GCKConnectionStateConnected“ ist und es sich um eine Streamingsitzung handelt.

- (void) setDefaultSessionOptions:	(nullable GCKSessionOptions *)	sessionOptions
forDeviceCategory:	(NSString *)	category

Legt die standardmäßigen Sitzungsoptionen für die angegebene Gerätekategorie fest.Die Sitzungsoptionen werden an die Methode createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) übergeben, wenn der Nutzer ein Gerät aus dem Streaming-Dialogfeld auswählt.

Bei Streamingsitzungen können Sie mit den Sitzungsoptionen festlegen, welche Empfängeranwendung gestartet werden soll.

Parameters

sessionOptions	The session options. May be `nil` to remove any previously set options.
category	The device category.

Seit: 4,0

- (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: (NSString *) category

Ruft die Standardsitzungsoptionen für eine bestimmte Gerätekategorie ab.

Parameters

category The device category.

Rückgaben: Die Standardsitzungsoptionen oder nil, wenn es keine gibt.

Seit: 4,0

- (void) addListener: (id< GCKSessionManagerListener >) listener

Fügt einen Listener für den Empfang von Benachrichtigungen hinzu.

Der hinzugefügte Listener wird nur schwach gehalten und sollte aufbewahrt werden, um eine unerwartete Dealzuweisung zu vermeiden.

Parameters

listener The listener to add.

- (void) removeListener: (id< GCKSessionManagerListener >) listener

Entfernt einen Listener, der zuvor mit addListener: hinzugefügt wurde.

Parameters

listener The listener to remove.

Property-Details

- (GCKSession*) currentSession

readnonatomicstrong

Die aktuelle Sitzung, falls vorhanden.

- (GCKCastSession*) currentCastSession

readnonatomicstrong

Die aktuelle Streamingsitzung, falls vorhanden.

- (GCKConnectionState) connectionState

readnonatomicassign

Der aktuelle Verbindungsstatus der Sitzung.

GCKSessionManager-Klasse

Übersicht

Zusammenfassung der Instanzmethoden

Property-Übersicht

Methodendetail

Property-Details