Übersicht
Eine Klasse, die Sitzungen verwaltet.
Mit der Methode startSessionWithDevice: (GCKSessionManager) wird eine neue Sitzung mit einer bestimmten GCKDevice erstellt. Der Sitzungsmanager verwendet die GCKDeviceProvider für diesen Gerätetyp, um ein neues GCKSession-Objekt zu erstellen, an das er dann alle Sitzungsanfragen weiterleitet.
GCKSessionManager übernimmt die automatische Wiederaufnahme angehaltener Sitzungen. Das bedeutet, dass Sitzungen fortgesetzt werden, die beendet wurden, als die Anwendung in den Hintergrund verschoben wurde, oder wenn die Anwendung abgestürzt oder vom Nutzer zwangsweise beendet wurde. Wenn die Anwendung fortgesetzt oder neu gestartet wird, wartet der Sitzungsmanager kurz darauf, dass der Geräteanbieter des Geräts der angehaltenen Sitzung dieses Gerät wieder erkennt. Wenn dies der Fall ist, wird automatisch versucht, die Verbindung zu diesem Gerät wiederherzustellen und die Sitzung neu zu starten.
Wenn in der Anwendung ein GCKUICastButton ohne Angabe eines Ziels und einer Auswahl erstellt wurde, wird durch Tippen auf die Schaltfläche das Standarddialogfeld für die Übertragung angezeigt. Sitzungen werden automatisch basierend auf der Auswahl des Nutzers oder der Trennung eines Geräts gestartet und beendet. Wenn die Anwendung jedoch eine eigene Benutzeroberfläche für die Geräteauswahl und ‑steuerung bereitstellt, sollte sie das GCKSessionManager direkt verwenden, um Sitzungen zu erstellen und zu steuern.
Unabhängig davon, ob die Anwendung GCKSessionManager zum Steuern von Sitzungen verwendet, kann sie ein GCKSessionManagerListener anhängen, um über Sitzungsereignisse benachrichtigt zu werden. Außerdem kann sie KVO verwenden, um die connectionState-Property zu überwachen und den aktuellen Sitzungslebenszyklusstatus zu verfolgen.
- Seit
- 3.0
Erbt von NSObject.
Zusammenfassung der Instanzmethoden | |
| (instancetype) | - init |
| Der Standard-Initializer ist nicht verfügbar. Weitere Informationen | |
| (BOOL) | - startSessionWithDevice: |
| Startet eine neue Sitzung mit dem angegebenen Gerät. Weitere Informationen | |
| (BOOL) | - suspendSessionWithReason: |
| Die aktuelle Sitzung wird unterbrochen. Weitere Informationen | |
| (BOOL) | - endSession |
| Beendet die aktuelle Sitzung. Weitere Informationen | |
| (BOOL) | - endSessionAndStopCasting: |
| Beendet die aktuelle Sitzung und stoppt optional das Streaming. Weitere Informationen | |
| (BOOL) | - hasConnectedSession |
| Testet, ob eine Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. Weitere Informationen | |
| (BOOL) | - hasConnectedCastSession |
| Testet, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist. Weitere Informationen | |
| (void) | - addListener: |
| Fügt einen Listener zum Empfangen von Benachrichtigungen hinzu. Weitere Informationen | |
| (void) | - removeListener: |
| Entfernt einen Listener, der zuvor mit addListener: hinzugefügt wurde. Weitere Informationen | |
Zusammenfassung der Property | |
| GCKSession * | currentSession |
| Die aktuelle Sitzung, falls vorhanden. Weitere Informationen | |
| GCKCastSession * | currentCastSession |
| Die aktuelle Cast-Sitzung, falls vorhanden. Weitere Informationen | |
| GCKConnectionState | connectionState |
| Der aktuelle Verbindungsstatus der Sitzung. Weitere Informationen | |
Methodendetail
| - (instancetype) init |
Der Standard-Initializer 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.
- Ausgabe
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 |
Die aktuelle Sitzung wird unterbrochen.
Dies ist ein asynchroner Vorgang.
- Parameters
-
reason The reason for the suspension.
- Ausgabe
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.
- Ausgabe
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 stoppt optional das Streaming.
Dies ist ein asynchroner Vorgang.
- Parameters
-
stopCasting Whether casting of content on the receiver should be stopped when the session is ended.
- Ausgabe
YES, wenn der Vorgang 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.
Dieser Wert ist YES, wenn der Sitzungsstatus GCKConnectionStateConnected ist.
| - (BOOL) hasConnectedCastSession |
Testet, ob eine Cast-Sitzung derzeit von diesem Sitzungsmanager verwaltet wird und derzeit verbunden ist.
Dieser Wert ist YES, wenn der Sitzungsstatus GCKConnectionStateConnected ist und es sich um eine Cast-Sitzung handelt.
| - (void) addListener: | (id< GCKSessionManagerListener >) | listener |
Fügt einen Listener zum Empfangen 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 Cast-Sitzung, falls vorhanden.
|
readnonatomicassign |
Der aktuelle Verbindungsstatus der Sitzung.