Übersicht
Ein Kurs zur Verwaltung von Sitzungen.
Mit der Methode startSessionWithDevice: (GCKSessionManager) wird eine neue Sitzung mit einem bestimmten GCKDevice erstellt. Der Sitzungsmanager verwendet den GCKDeviceProvider für diesen Gerätetyp, um ein neues GCKSession-Objekt zu erstellen, an das er anschließend alle Sitzungsanfragen delegiert.
GCKSessionManager übernimmt die automatische Wiederaufnahme angehaltener Sitzungen, d. h. die Fortsetzung von Sitzungen, die beendet wurden, als die Anwendung in den Hintergrund geleitet wurde, oder für den Fall, dass die Anwendung abgestürzt ist oder vom Nutzer zwangsweise beendet wurde. Wenn die App fortgesetzt oder neu gestartet wird, wartet der Sitzungsmanager für kurze Zeit, bis der Geräteanbieter des Geräts der gesperrten Sitzung das Gerät wieder erkennt. Wenn dies der Fall ist, wird versucht, die Verbindung zu diesem Gerät wiederherzustellen und die Sitzung automatisch neu zu erstellen.
Wenn die App ein GCKUICastButton ohne Ziel und Selektor erstellt hat, wird beim Tippen auf die Schaltfläche das Standard-Dialogfeld für das Streaming angezeigt und je nach Nutzerauswahl oder -verbindung eines Geräts automatisch Sitzungen gestartet und beendet. Wenn die Anwendung jedoch eine eigene Benutzeroberfläche zur Geräteauswahl/-steuerung bereitstellt, sollte sie GCKSessionManager direkt zum Erstellen und Steuern von Sitzungen verwenden.
Unabhängig davon, ob die Anwendung GCKSessionManager zum Steuern von Sitzungen verwendet oder nicht, kann sie einen GCKSessionManagerListener anhängen, der über Sitzungsereignisse benachrichtigt wird. Außerdem kann sie mit KVO das Attribut connectionState überwachen, um den aktuellen Lebenszyklusstatus der Sitzung zu verfolgen.
- Sincé
- 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. Mehr... | |
| (BOOL) | - suspendSessionWithReason: |
| Sperrt die aktuelle Sitzung. Mehr... | |
| (BOOL) | - endSession |
| Beendet die aktuelle Sitzung. Mehr... | |
| (BOOL) | - endSessionAndStopCasting: |
| Beendet die aktuelle Sitzung. Optional wird das Streamen beendet. Mehr... | |
| (BOOL) | - hasConnectedSession |
| Prüft, ob eine Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. Mehr... | |
| (BOOL) | - hasConnectedCastSession |
| Prüft, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. 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-Zusammenfassung | |
| 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.
Dies ist ein asynchroner Vorgang.
- Parameters
-
device The device to use for this session.
- Gibt Folgendes zurück:
YES, wenn der Vorgang erfolgreich gestartet wurde,NO, wenn derzeit eine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.
| - (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
Sperrt die aktuelle Sitzung.
Dies ist ein asynchroner Vorgang.
- Parameters
-
reason The reason for the suspension.
- Gibt Folgendes zurück:
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.
- Gibt Folgendes zurück:
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. Optional wird das Streamen beendet.
Dies ist ein asynchroner Vorgang.
- Parameters
-
stopCasting Whether casting of content on the receiver should be stopped when the session is ended.
- Gibt Folgendes zurück:
YES, wenn der Vorgang erfolgreich gestartet wurde,NO, wenn derzeit keine Sitzung eingerichtet ist oder der Vorgang nicht gestartet werden konnte.
| - (BOOL) hasConnectedSession |
Prüft, ob eine Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist.
Der Wert lautet YES, wenn der Sitzungsstatus GCKConnectionStateConnected ist.
| - (BOOL) hasConnectedCastSession |
Prüft, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist.
Der Wert lautet YES, wenn der Sitzungsstatus GCKConnectionStateConnected und die Sitzung eine Streamingsitzung ist.
| - (void) addListener: | (id< GCKSessionManagerListener >) | listener |
Fügt einen Listener für den Empfang von Benachrichtigungen hinzu.
- 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
|
readnonatomicstrong |
Die aktuelle Sitzung, falls vorhanden.
|
readnonatomicstrong |
Die aktuelle Streamingsitzung, falls vorhanden.
|
readnonatomicassign |
Der aktuelle Verbindungsstatus der Sitzung.