Ü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 endWithAction: (GCKSession(Protected)) nicht direkt aufrufen.
- Seit
- 3,0
Übernimmt GCKSession.
Übersicht über Instanzmethoden | |
| (instancetype) | - initWithDevice:sessionID:sessionOptions:castOptions: |
| Erstellt eine neue Streamingsitzung mit den angegebenen Streamingoptionen. 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 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 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) | - notifyDidEndWithError:willTryToResume: |
| 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... | |
| (void) | - notifyDidSuspendWithReason: |
| Eingestellt, nicht verwenden – als No-Op implementiert. Mehr... | |
| (void) | - notifyDidResume |
| Eingestellt, nicht verwenden – als No-Op implementiert. 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... | |
| GCKSessionOptions * | sessionOptions |
| Die Sitzungsoptionen, 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: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
| castOptions: | (GCKCastOptions *) | castOptions | |
Erstellt eine neue Streamingsitzung mit den angegebenen Streamingoptionen.
- Parameters
-
device The receiver device. sessionID The session ID, if resuming; otherwise nil.sessionOptions The session options, if any; otherwise nil.castOptions The Cast options.
- Seit
- 4,0
| - (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, andernfallsNO.
| - (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, andernfallsNO.
| - (void) addDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
Fügt der Listener-Liste dieses Objekts ein GCKCastDeviceStatusListener hinzu.
Der hinzugefügte Listener ist schwach gehalten und sollte beibehalten werden, um eine unerwartete Zuordnung zu vermeiden.
- 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: | (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 nilif 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 nilif it will be used to start a new session.sessionOptions The session options, if any; otherwise nil.
- Seit
- 4,0
| - (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
voidzurü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
voidzurück.
| - (void) start |
Startet die Sitzung.
Dies ist ein asynchroner Vorgang. Muss von Unterklassen ü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 Unterklassen ü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 zu benachrichtigen, dass die Sitzung gestartet wurde.
- Parameters
-
sessionID The session's unique ID.
Bereitgestellt von der Kategorie „GCKSession(Protected)“.
| - (void) notifyDidFailToStartWithError: | (GCKError *) | 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) notifyDidEndWithError: | (nullable NSError *) | error | |
| willTryToResume: | (BOOL) | willTryToResume | |
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 nilif 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 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: | (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 |
Veraltet, nicht verwenden – als No-Op implementiert.
- Deprecated:
- Nicht anrufen.
Bereitgestellt von der Kategorie „GCKSession(Protected)“.
| - (void) notifyDidResume |
Veraltet, nicht verwenden – als No-Op implementiert.
- Deprecated:
- Nicht anrufen.
Bereitgestellt von der Kategorie „GCKSession(Protected)“.
Objektdetails
|
readnonatomicassign |
Der aktuelle Status des Geräts als „aktive Eingabe“.
|
readnonatomicassign |
Der aktuelle Stand-by-Status des Geräts.
|
readnonatomiccopy |
Die Metadaten für die Empfangsanwendung, die aktuell auf dem Empfängergerät ausgeführt wird, falls vorhanden; andernfalls nil.
|
readnonatomicstronginherited |
Das Gerät, mit dem diese Sitzung verknüpft ist.
|
readnonatomiccopyinherited |
Die aktuelle Sitzungs-ID, falls vorhanden.
|
readnonatomicstronginherited |
Die Sitzungsoptionen, falls vorhanden.
- Seit
- 4,0
|
readnonatomicassigninherited |
Der aktuelle Verbindungsstatus der Sitzung.
|
readnonatomicassigninherited |
Eine Markierung, die angibt, ob die Sitzung derzeit ausgesetzt ist.
- Deprecated:
- GCKSession unterstützt den Status "Gesperrt" nicht mehr. Verschieben Sie diese Funktionalität bei Bedarf in eine Unterklasse.
|
readnonatomiccopyinherited |
Text für den aktuellen Gerätestatus
|
readnonatomiccopyinherited |
Die Sitzungseigenschaften.
|
readnonatomicassigninherited |
Die aktuelle Gerätelautstärke im Bereich [0, 0 bis 1, 0].
|
readnonatomicassigninherited |
Der aktuelle Stummschaltungsstatus des Geräts.
|
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.
|
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.