Übersicht
Eine abstrakte Basisklasse, die eine Sitzung mit einem Empfängergerät darstellt.
Abgeleitete Klassen müssen die Methoden start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) und resume (GCKSession(Protected)) implementieren und die entsprechenden Benachrichtigungsmethoden (z. B. notifyDidStartWithSessionID: (GCKSession(Protected))) aufrufen, um die entsprechenden Änderungen im Sitzungsstatus anzugeben. Abgeleitete Klassen können auch setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) und remoteMediaClient implementieren, wenn das Gerät solche Vorgänge unterstützt.
Eine Sitzung wird mithilfe der Sitzungsmethoden in GCKSessionManager erstellt und gesteuert. Dabei wird die entsprechende GCKDeviceProvider verwendet, um die Sitzung zu erstellen. Anschließend werden Sitzungsanfragen an dieses GCKSession-Objekt delegiert.
- Sincé
- 3,0
Übernimmt NSObject.
Von GCKCastSession übernommen.
Zusammenfassung der Instanzmethoden | |
(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: |
Sperrt die Sitzung aus dem angegebenen Grund. Mehr... | |
(void) | - resume |
Setzt die Sitzung fort. Mehr... | |
(void) | - notifyDidStartWithSessionID: |
Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung gestartet wurde. Mehr... | |
(void) | - notifyDidFailToStartWithError: |
Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung nicht gestartet werden konnte. 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 über die Sperrung der Sitzung zu informieren. Mehr... | |
(void) | - notifyDidEndWithError: |
Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass die Sitzung beendet wurde. Mehr... | |
(void) | - notifyDidReceiveDeviceVolume:muted: |
Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, dass das Gerätelautstärke und der Stummschaltungsstatus vom Gerät empfangen 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 | |
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 gerade gesperrt ist. Mehr... | |
NSString * | deviceStatusText |
Der aktuelle Text zum Gerätestatus. Mehr... | |
GCKSessionTraits * | traits |
Die Sitzung läuft. Mehr... | |
float | currentDeviceVolume |
Die aktuelle Gerätelautstärke im Bereich [0,0, 1,0]. Mehr... | |
BOOL | currentDeviceMuted |
Der aktuelle Status zum Stummschalten 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 | |
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 eine No-Op, die die Anfrage mit dem Fehler „GCKErrorCodeSupportedFeature“ nicht besteht.
- Parameters
-
volume The new volume.
- Gibt Folgendes zurück:
- Ein GCKRequest-Objekt zum Verfolgen der Anfrage.
- Sincé
- 3.4: In früheren Framework-Versionen hat diese Methode
void
zurückgegeben.
- (GCKRequest *) setDeviceMuted: | (BOOL) | muted |
Legt die Stummschaltung des Geräts fest.
Dies ist ein asynchroner Vorgang. Die Standardimplementierung ist eine No-Op, die die Anfrage mit dem Fehler „GCKErrorCodeSupportedFeature“ nicht besteht.
- Parameters
-
muted The new mute state.
- Gibt Folgendes zurück:
- Ein GCKRequest-Objekt zum Verfolgen der Anfrage.
- Sincé
- 3.4: In früheren Framework-Versionen hat diese Methode
void
zurückgegeben.
- (void) start |
Startet die Sitzung.
Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.
Bereitgestellt von der Kategorie GCKSession(Protected).
- (void) endAndStopCasting: | (BOOL) | stopCasting |
Beendet die Sitzung.
Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.
- Parameters
-
stopCasting Whether to stop casting content to the receiver.
Bereitgestellt von der Kategorie GCKSession(Protected).
- (void) suspendWithReason: | (GCKConnectionSuspendReason) | reason |
Sperrt die Sitzung aus dem angegebenen Grund.
Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.
Bereitgestellt von der Kategorie GCKSession(Protected).
- (void) resume |
Setzt die Sitzung fort.
Dies ist ein asynchroner Vorgang. Muss von abgeleiteten Klassen überschrieben werden.
Bereitgestellt von der Kategorie GCKSession(Protected).
- (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
Wird von Unterklassen aufgerufen, um das Framework darüber zu informieren, 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 werden konnte.
- 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 über die Sperrung der Sitzung zu informieren.
- 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 darüber zu informieren, dass die Sitzung beendet wurde.
- 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 das Gerätelautstärke und der Stummschaltungsstatus vom Gerät empfangen 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).
Property-Details
|
readnonatomicstrong |
Das Gerät, mit dem diese Sitzung verknüpft ist.
|
readnonatomiccopy |
Die aktuelle Sitzungs-ID, falls vorhanden.
|
readnonatomicassign |
Der aktuelle Verbindungsstatus der Sitzung.
|
readnonatomicassign |
Eine Markierung, die angibt, ob die Sitzung gerade gesperrt ist.
|
readnonatomiccopy |
Der aktuelle Text zum Gerätestatus.
|
readnonatomiccopy |
Die Sitzung läuft.
|
readnonatomicassign |
Die aktuelle Gerätelautstärke im Bereich [0,0, 1,0].
|
readnonatomicassign |
Der aktuelle Status zum Stummschalten des Geräts.
|
readnonatomicstrong |
Das GCKRemoteMediaClient-Objekt, mit dem die Medienwiedergabe in dieser Sitzung gesteuert werden kann.
Es ist nil
vor Beginn der Sitzung oder wenn die Sitzung die GCKRemoteMediaClient API nicht unterstützt. Unterklassen, die eine GCKRemoteMediaClient-Schnittstelle bereitstellen, müssen die Getter-Methode überschreiben.
|
readnonatomicstrong |
Die aktuellen Medienmetadaten, falls vorhanden.
Ist nil
, wenn die Sitzung den Media-Namespace nicht unterstützt oder wenn keine Medien derzeit auf dem Empfänger geladen sind.