Übersicht
Eine GCKCastChannel-Unterklasse für Vorgänge zur Mediensteuerung.
Für alle Vorgänge, die sich auf einen aktuell aktiven Stream beziehen (Wiedergabe, Pause, Suche, Stopp usw.), ist ein gültiger (d. h. nicht leerer) Media-Status erforderlich. Andernfalls wird kGCKInvalidRequestID zurückgegeben und die Anfrage wird nicht gesendet. Ein Media-Status wird automatisch angefordert, wenn der Channel verbunden wird. Er ist in einer Antwort enthalten, die nach einem erfolgreichen Ladevorgang zurückgegeben wird, und kann jederzeit aktualisiert werden. Der Media-Status kann auch jederzeit „nil“ werden, z. B. wenn der Channel vorübergehend getrennt wird. Bei Verwendung dieses Kanals sollten Änderungen des Media-Status über den mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p)-Callback überwacht werden. Methoden, die auf Streams wirken, sollten nur aufgerufen werden, wenn der Media-Status nicht „nil“ ist.
Wenn eine Anfrage erfolgreich gestartet wurde, gibt die entsprechende Methode die Anfrage-ID zurück, die dieser Anfrage zugewiesen wurde. Wenn die Anfrage nicht gestartet werden kann, gibt die Methode kGCKInvalidRequestID zurück und legt die lastError-Eigenschaft fest, um den Grund für den Fehler anzugeben. Wenn eine Anfrage erfolgreich gestartet wird, aber letztendlich fehlschlägt, wird der mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p)-Callback aufgerufen, um den Fehler anzugeben.
Das Delegatenprotokoll finden Sie unter GCKMediaControlChannelDelegate.
- Deprecated:
- Verwenden Sie die GCKRemoteMediaClient-Property von GCKCastSession, um die Medienwiedergabe zu steuern.
Übernimmt GCKCastChannel.
Zusammenfassung der Instanzmethoden | |
(instancetype) | - init |
Designated Initializer Weitere Informationen | |
(NSInteger) | - loadMedia: |
Lädt und startet die Wiedergabe eines neuen Media-Elements. Weitere Informationen | |
(NSInteger) | - loadMedia:autoplay: |
Lädt ein neues Media-Element und startet optional die Wiedergabe. Weitere Informationen | |
(NSInteger) | - loadMedia:autoplay:playPosition: |
Lädt ein neues Media-Element und startet optional die Wiedergabe. Weitere Informationen | |
(NSInteger) | - loadMedia:autoplay:playPosition:customData: |
Lädt ein neues Media-Element und startet optional die Wiedergabe. Weitere Informationen | |
(NSInteger) | - loadMedia:autoplay:playPosition:activeTrackIDs: |
Lädt ein neues Media-Element und startet optional die Wiedergabe. Weitere Informationen | |
(NSInteger) | - loadMedia:autoplay:playPosition:activeTrackIDs:customData: |
Lädt ein neues Media-Element und startet optional die Wiedergabe. Weitere Informationen | |
(NSInteger) | - setActiveTrackIDs: |
Legt die aktiven Tracks fest. Weitere Informationen | |
(NSInteger) | - setTextTrackStyle: |
Legt den Stil des Text-Tracks fest. Weitere Informationen | |
(NSInteger) | - pause |
Pausiert die Wiedergabe des aktuellen Medienelements. Weitere Informationen | |
(NSInteger) | - pauseWithCustomData: |
Pausiert die Wiedergabe des aktuellen Medienelements. Weitere Informationen | |
(NSInteger) | - stop |
Die Wiedergabe des aktuellen Medienelements wird beendet. Weitere Informationen | |
(NSInteger) | - stopWithCustomData: |
Die Wiedergabe des aktuellen Medienelements wird beendet. Weitere Informationen | |
(NSInteger) | - play |
Startet (oder setzt fort) die Wiedergabe des aktuellen Medienelements. Weitere Informationen | |
(NSInteger) | - playWithCustomData: |
Startet (oder setzt fort) die Wiedergabe des aktuellen Medienelements. Weitere Informationen | |
(NSInteger) | - seekToTimeInterval: |
Sucht eine neue Position innerhalb des aktuellen Media-Elements. Weitere Informationen | |
(NSInteger) | - seekToTimeInterval:resumeState: |
Sucht eine neue Position innerhalb des aktuellen Media-Elements. Weitere Informationen | |
(NSInteger) | - seekToTimeInterval:resumeState:customData: |
Sucht eine neue Position innerhalb des aktuellen Media-Elements. Weitere Informationen | |
(NSInteger) | - queueLoadItems:startIndex:repeatMode: |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen. Weitere Informationen | |
(NSInteger) | - queueLoadItems:startIndex:repeatMode:customData: |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen. Weitere Informationen | |
(NSInteger) | - queueLoadItems:startIndex:playPosition:repeatMode:customData: |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen. Weitere Informationen | |
(NSInteger) | - queueInsertItems:beforeItemWithID: |
Fügt eine Liste neuer Medienelemente in die Warteschlange ein. Weitere Informationen | |
(NSInteger) | - queueInsertItems:beforeItemWithID:customData: |
Fügt eine Liste neuer Medienelemente in die Warteschlange ein. Weitere Informationen | |
(NSInteger) | - queueInsertItem:beforeItemWithID: |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt wird. Weitere Informationen | |
(NSInteger) | - queueInsertAndPlayItem:beforeItemWithID: |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt und zum aktuellen Element gemacht wird. Weitere Informationen | |
(NSInteger) | - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData: |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt und zum aktuellen Element gemacht wird. Weitere Informationen | |
(NSInteger) | - queueUpdateItems: |
Aktualisiert die Warteschlange. Weitere Informationen | |
(NSInteger) | - queueUpdateItems:customData: |
Aktualisiert die Warteschlange. Weitere Informationen | |
(NSInteger) | - queueRemoveItemsWithIDs: |
Entfernt eine Liste von Medienelementen aus der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueRemoveItemsWithIDs:customData: |
Entfernt eine Liste von Medienelementen aus der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueRemoveItemWithID: |
Eine unkomplizierte Methode zum Entfernen eines einzelnen Elements aus der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueReorderItemsWithIDs:insertBeforeItemWithID: |
Ordnet eine Liste von Medienelementen in der Warteschlange neu an. Weitere Informationen | |
(NSInteger) | - queueReorderItemsWithIDs:insertBeforeItemWithID:customData: |
Eine Liste von Medienelementen in der Warteschlange neu anordnen Weitere Informationen | |
(NSInteger) | - queueMoveItemWithID:beforeItemWithID: |
Eine praktische Methode zum Verschieben eines einzelnen Elements in der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueJumpToItemWithID: |
Springt zum Element mit der angegebenen ID in der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueJumpToItemWithID:customData: |
Springt zum Element mit der angegebenen ID in der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueJumpToItemWithID:playPosition:customData: |
Springt zum Element mit der angegebenen ID in der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueNextItem |
Zum nächsten Element in der Warteschlange wechseln Weitere Informationen | |
(NSInteger) | - queuePreviousItem |
Wechselt zum vorherigen Element in der Warteschlange. Weitere Informationen | |
(NSInteger) | - queueSetRepeatMode: |
Legt den Wiederholungsmodus der Warteschlange fest. Weitere Informationen | |
(NSInteger) | - setStreamVolume: |
Legt die Lautstärke des Streams fest. Weitere Informationen | |
(NSInteger) | - setStreamVolume:customData: |
Legt die Lautstärke des Streams fest. Weitere Informationen | |
(NSInteger) | - setStreamMuted: |
Legt fest, ob der Stream stummgeschaltet ist. Weitere Informationen | |
(NSInteger) | - setStreamMuted:customData: |
Legt fest, ob der Stream stummgeschaltet ist. Weitere Informationen | |
(NSInteger) | - requestStatus |
Fordert aktualisierte Informationen zum Media-Status vom Empfänger an. Weitere Informationen | |
(NSTimeInterval) | - approximateStreamPosition |
Gibt die ungefähre Streamposition zurück, die aus den zuletzt empfangenen Streaminformationen und der seit diesem Update verstrichenen Wanduhrzeit berechnet wurde. Weitere Informationen | |
(BOOL) | - cancelRequestWithID: |
Bricht eine laufende Anfrage ab. Weitere Informationen | |
(instancetype) | - initWithNamespace: |
Designated Initializer Weitere Informationen | |
(void) | - didReceiveTextMessage: |
Wird aufgerufen, wenn auf diesem Kanal eine SMS empfangen wurde. Weitere Informationen | |
(BOOL) | - sendTextMessage: |
Sendet eine SMS über diesen Kanal. Weitere Informationen | |
(BOOL) | - sendTextMessage:error: |
Sendet eine SMS über diesen Kanal. Weitere Informationen | |
(NSInteger) | - generateRequestID |
Generiert eine Anforderungs-ID für eine neue Nachricht. Weitere Informationen | |
(NSNumber *__nullable) | - generateRequestNumber |
Eine praktische Methode, die das Ergebnis von generateRequestID in einem NSNumber umschließt. Weitere Informationen | |
(void) | - didConnect |
Wird aufgerufen, wenn dieser Channel verbunden wurde. Das bedeutet, dass jetzt Nachrichten über diesen Channel mit dem Cast-Gerät ausgetauscht werden können. Weitere Informationen | |
(void) | - didDisconnect |
Wird aufgerufen, wenn die Verbindung zu diesem Kanal getrennt wurde. Das bedeutet, dass über diesen Kanal keine Nachrichten mehr mit dem Cast-Gerät ausgetauscht werden können. Weitere Informationen | |
Zusammenfassung der Property | |
GCKMediaStatus * | mediaStatus |
Der Medienstatus für die aktuell geladenen Medien, falls vorhanden. Andernfalls nil . Weitere Informationen | |
NSTimeInterval | timeSinceLastMediaStatusUpdate |
Die Zeit, die seit dem letzten Update des Media-Status vergangen ist. Weitere Informationen | |
GCKError * | lastError |
Die Fehlerdetails der letzten Anfrage (falls vorhanden) oder nil , wenn die letzte Anfrage erfolgreich war. Weitere Informationen | |
id< GCKMediaControlChannelDelegate > | delegate |
Der Delegat für den Empfang von Benachrichtigungen über Änderungen am Status des Kanals. Weitere Informationen | |
NSString * | protocolNamespace |
Der Namespace des Channels. Weitere Informationen | |
BOOL | isConnected |
Ein Flag, das angibt, ob dieser Channel derzeit verbunden ist. Weitere Informationen | |
GCKDeviceManager * | deviceManager |
Der Gerätemanager, mit dem dieser Kanal registriert ist, falls vorhanden. Weitere Informationen | |
Methodendetail
- (instancetype) init |
Designated Initializer
Implementiert GCKCastChannel.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo |
Lädt und startet die Wiedergabe eines neuen Media-Elements.
- Parameters
-
mediaInfo An object describing the media item to load.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
Lädt ein neues Media-Element und startet optional die Wiedergabe.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
Lädt ein neues Media-Element und startet optional die Wiedergabe.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
customData: | (id __nullable) | customData | |
Lädt ein neues Media-Element und startet optional die Wiedergabe.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
activeTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs | |
Lädt ein neues Media-Element und startet optional die Wiedergabe.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. activeTrackIDs An array of integers specifying the active tracks. May be nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) loadMedia: | (GCKMediaInformation *) | mediaInfo | |
autoplay: | (BOOL) | autoplay | |
playPosition: | (NSTimeInterval) | playPosition | |
activeTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs | |
customData: | (id __nullable) | customData | |
Lädt ein neues Media-Element und startet optional die Wiedergabe.
- Parameters
-
mediaInfo An object describing the media item to load. autoplay Whether playback should start immediately. playPosition The initial playback position. activeTrackIDs An array of integers specifying the active tracks. May be nil
.customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) setActiveTrackIDs: | (NSArray< NSNumber * > *__nullable) | activeTrackIDs |
Legt die aktiven Tracks fest.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
activeTrackIDs An array of integers specifying the active tracks.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte. Kann
nil
oder ein leeres Array sein, um die aktiven Tracks auf die leere Liste zu setzen.
- (NSInteger) setTextTrackStyle: | (GCKMediaTextTrackStyle *__nullable) | textTrackStyle |
Legt den Stil des Text-Tracks fest.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
textTrackStyle The text track style. The style will not be changed if this is nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) pause |
Pausiert die Wiedergabe des aktuellen Medienelements.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) pauseWithCustomData: | (id __nullable) | customData |
Pausiert die Wiedergabe des aktuellen Medienelements.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) stop |
Die Wiedergabe des aktuellen Medienelements wird beendet.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist. Wenn derzeit eine Warteschlange geladen ist, wird sie entfernt.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) stopWithCustomData: | (id __nullable) | customData |
Die Wiedergabe des aktuellen Medienelements wird beendet.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist. Wenn derzeit eine Warteschlange geladen ist, wird sie entfernt.
- Parameters
-
customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) play |
Startet (oder setzt fort) die Wiedergabe des aktuellen Medienelements.
Die Wiedergabe beginnt immer am Anfang des Streams. Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) playWithCustomData: | (id __nullable) | customData |
Startet (oder setzt fort) die Wiedergabe des aktuellen Medienelements.
Die Wiedergabe beginnt immer am Anfang des Streams. Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) seekToTimeInterval: | (NSTimeInterval) | position |
Sucht eine neue Position innerhalb des aktuellen Media-Elements.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
position The new position from the beginning of the stream.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) seekToTimeInterval: | (NSTimeInterval) | position | |
resumeState: | (GCKMediaControlChannelResumeState) | resumeState | |
Sucht eine neue Position innerhalb des aktuellen Media-Elements.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
position The new position interval from the beginning of the stream. resumeState The action to take after the seek operation has finished.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) seekToTimeInterval: | (NSTimeInterval) | position | |
resumeState: | (GCKMediaControlChannelResumeState) | resumeState | |
customData: | (id __nullable) | customData | |
Sucht eine neue Position innerhalb des aktuellen Media-Elements.
Die Anfrage schlägt fehl, wenn kein aktueller Media-Status vorhanden ist.
- Parameters
-
position The new position from the beginning of the stream. resumeState The action to take after the seek operation has finished. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. repeatMode The repeat mode for playing the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
customData: | (id __nullable) | customData | |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. repeatMode The repeat mode for playing the queue. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueLoadItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
startIndex: | (NSUInteger) | startIndex | |
playPosition: | (NSTimeInterval) | playPosition | |
repeatMode: | (GCKMediaRepeatMode) | repeatMode | |
customData: | (id __nullable) | customData | |
Lädt und startet optional die Wiedergabe einer neuen Warteschlange mit Media-Elementen.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to load. Must not be nil
or empty.startIndex The index of the item in the items array that should be played first. playPosition The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used. repeatMode The repeat mode for playing the queue. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueInsertItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
Fügt eine Liste neuer Medienelemente in die Warteschlange ein.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to insert. Must not be nil
or empty.beforeItemID The ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueInsertItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
customData: | (id __nullable) | customData | |
Fügt eine Liste neuer Medienelemente in die Warteschlange ein.
- Parameters
-
queueItems An array of GCKMediaQueueItem instances to insert. Must not be nil
or empty.beforeItemID ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueInsertItem: | (GCKMediaQueueItem *) | item | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt wird.
- Parameters
-
item The item to insert. beforeItemID The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueInsertAndPlayItem: | (GCKMediaQueueItem *) | item | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt und zum aktuellen Element gemacht wird.
- Parameters
-
item The item to insert. beforeItemID The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueInsertAndPlayItem: | (GCKMediaQueueItem *) | item | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
playPosition: | (NSTimeInterval) | playPosition | |
customData: | (id __nullable) | customData | |
Eine praktische Methode, mit der ein einzelnes Element in die Warteschlange eingefügt und zum aktuellen Element gemacht wird.
- Parameters
-
item The item to insert. beforeItemID The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue. playPosition The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueUpdateItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems |
Aktualisiert die Warteschlange.
- Parameters
-
queueItems The list of updated items.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueUpdateItems: | (NSArray< GCKMediaQueueItem * > *) | queueItems | |
customData: | (id __nullable) | customData | |
Aktualisiert die Warteschlange.
- Parameters
-
queueItems The list of updated items. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueRemoveItemsWithIDs: | (NSArray< NSNumber * > *) | itemIDs |
Entfernt eine Liste von Medienelementen aus der Warteschlange.
Wenn die Warteschlange dadurch leer wird, wird die aktuelle Mediensitzung beendet.
- Parameters
-
itemIDs An array of media item IDs identifying the items to remove. Must not be nil
or empty.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueRemoveItemsWithIDs: | (NSArray< NSNumber * > *) | itemIDs | |
customData: | (id __nullable) | customData | |
Entfernt eine Liste von Medienelementen aus der Warteschlange.
Wenn die Warteschlange dadurch leer wird, wird die aktuelle Mediensitzung beendet.
- Parameters
-
itemIDs An array of media item IDs identifying the items to remove. Must not be nil
or empty.customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueRemoveItemWithID: | (NSUInteger) | itemID |
Eine unkomplizierte Methode zum Entfernen eines einzelnen Elements aus der Warteschlange.
- Parameters
-
itemID The ID of the item to remove.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueReorderItemsWithIDs: | (NSArray< NSNumber * > *) | queueItemIDs | |
insertBeforeItemWithID: | (NSUInteger) | beforeItemID | |
Ordnet eine Liste von Medienelementen in der Warteschlange neu an.
- Parameters
-
queueItemIDs An array of media item IDs identifying the items to reorder. Must not be nil
or empty.beforeItemID ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be appended at the end of the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueReorderItemsWithIDs: | (NSArray< NSNumber * > *) | queueItemIDs | |
insertBeforeItemWithID: | (NSUInteger) | beforeItemID | |
customData: | (id __nullable) | customData | |
Eine Liste von Medienelementen in der Warteschlange neu anordnen
- Parameters
-
queueItemIDs An array of media item IDs identifying the items to reorder. Must not be nil
or empty.beforeItemID The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be moved to the end of the queue. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueMoveItemWithID: | (NSUInteger) | itemID | |
beforeItemWithID: | (NSUInteger) | beforeItemID | |
Eine praktische Methode zum Verschieben eines einzelnen Elements in der Warteschlange.
- Parameters
-
itemID The ID of the item to move. beforeItemID The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the item will be moved to the end of the queue.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) queueJumpToItemWithID: | (NSUInteger) | itemID |
Springt zum Element mit der angegebenen ID in der Warteschlange.
- Parameters
-
itemID The ID of the item to jump to.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queueJumpToItemWithID: | (NSUInteger) | itemID | |
customData: | (id __nullable) | customData | |
Springt zum Element mit der angegebenen ID in der Warteschlange.
- Parameters
-
itemID The ID of the item to jump to. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queueJumpToItemWithID: | (NSUInteger) | itemID | |
playPosition: | (NSTimeInterval) | playPosition | |
customData: | (id __nullable) | customData | |
Springt zum Element mit der angegebenen ID in der Warteschlange.
- Parameters
-
itemID The ID of the item to jump to. playPosition The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queueNextItem |
Zum nächsten Element in der Warteschlange wechseln
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queuePreviousItem |
Wechselt zum vorherigen Element in der Warteschlange.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) queueSetRepeatMode: | (GCKMediaRepeatMode) | repeatMode |
Legt den Wiederholungsmodus der Warteschlange fest.
- Parameters
-
repeatMode The new repeat mode.
- Ausgabe
- Die Anfrage-ID für diese Anfrage oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte oder einer der Parameter ungültig ist.
- (NSInteger) setStreamVolume: | (float) | volume |
Legt die Lautstärke des Streams fest.
Die Anfrage schlägt fehl, wenn keine aktuelle Mediensitzung vorhanden ist.
- Parameters
-
volume The new volume, in the range [0.0 - 1.0].
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) setStreamVolume: | (float) | volume | |
customData: | (id __nullable) | customData | |
Legt die Lautstärke des Streams fest.
Die Anfrage schlägt fehl, wenn keine aktuelle Mediensitzung vorhanden ist.
- Parameters
-
volume The new volume, in the range [0.0 - 1.0]. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) setStreamMuted: | (BOOL) | muted |
Legt fest, ob der Stream stummgeschaltet ist.
Die Anfrage schlägt fehl, wenn keine aktuelle Mediensitzung vorhanden ist.
- Parameters
-
muted Whether the stream should be muted or unmuted.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) setStreamMuted: | (BOOL) | muted | |
customData: | (id __nullable) | customData | |
Legt fest, ob der Stream stummgeschaltet ist.
Die Anfrage schlägt fehl, wenn keine aktuelle Mediensitzung vorhanden ist.
- Parameters
-
muted Whether the stream should be muted or unmuted. customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil
.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) requestStatus |
Fordert aktualisierte Informationen zum Media-Status vom Empfänger an.
- Ausgabe
- Die Anfrage-ID oder kGCKInvalidRequestID, wenn die Nachricht nicht gesendet werden konnte.
- (NSTimeInterval) approximateStreamPosition |
Gibt die ungefähre Streamposition zurück, die aus den zuletzt empfangenen Streaminformationen und der seit diesem Update verstrichenen Wanduhrzeit berechnet wurde.
Gibt 0 zurück, wenn der Channel nicht verbunden ist oder derzeit keine Media geladen sind.
- (BOOL) cancelRequestWithID: | (NSInteger) | requestID |
Bricht eine laufende Anfrage ab.
Wenn Sie eine Anfrage abbrechen, wird sie trotzdem ausgeführt. Es wird lediglich angegeben, dass die aufrufende Anwendung nicht mehr an den Ergebnissen der Anfrage interessiert ist. Daher wird jeder Status, der mit der Nachverfolgung der Anfrage verknüpft ist, gelöscht.
- Parameters
-
requestID The ID of the request to cancel.
- Ausgabe
YES
, wenn die Anfrage abgebrochen wurde, oderNO
, wenn keine Anfrage mit der angegebenen ID verfolgt wird.
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
Designated Initializer
Erstellt ein neues GCKCastChannel-Objekt mit dem angegebenen Namespace.
- Parameters
-
protocolNamespace The namespace.
Implementiert in GCKGenericChannel.
- (void) didReceiveTextMessage: | (NSString *) | message |
Wird aufgerufen, wenn auf diesem Kanal eine SMS empfangen wurde.
Die Standardimplementierung ist ein No-Op.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Sendet eine SMS über diesen Kanal.
- Parameters
-
message The message.
- Ausgabe
YES
bei Erfolg oderNO
, wenn die Nachricht nicht gesendet werden konnte (weil der Kanal nicht verbunden ist oder der Sendepuffer derzeit zu voll ist).
- Deprecated:
- Verwenden Sie sendTextMessage:error:, um detaillierte Fehlerinformationen zu erhalten.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | (GCKError *__nullable *__nullable) | error | |
Sendet eine SMS über diesen Kanal.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- Ausgabe
YES
bei Erfolg oderNO
, wenn die Nachricht nicht gesendet werden konnte.
- (NSInteger) generateRequestID |
Generiert eine Anforderungs-ID für eine neue Nachricht.
- Ausgabe
- Die generierte ID oder kGCKInvalidRequestID, wenn der Kanal derzeit nicht verbunden ist.
- (NSNumber * __nullable) generateRequestNumber |
Eine praktische Methode, die das Ergebnis von generateRequestID in einem NSNumber umschließt.
- Ausgabe
- Die generierte ID oder
nil
, wenn der Kanal derzeit nicht verbunden ist.
- (void) didConnect |
Wird aufgerufen, wenn dieser Channel verbunden wurde. Das bedeutet, dass jetzt Nachrichten über diesen Channel mit dem Cast-Gerät ausgetauscht werden können.
Die Standardimplementierung ist ein No-Op.
- (void) didDisconnect |
Wird aufgerufen, wenn die Verbindung zu diesem Kanal getrennt wurde. Das bedeutet, dass über diesen Kanal keine Nachrichten mehr mit dem Cast-Gerät ausgetauscht werden können.
Die Standardimplementierung ist ein No-Op.
Property-Details
|
readnonatomicstrong |
Der Medienstatus für die aktuell geladenen Medien, falls vorhanden. Andernfalls nil
.
|
readnonatomicassign |
Die Zeit, die seit dem letzten Update des Media-Status vergangen ist.
Wenn gerade eine Statusanfrage läuft, ist dieser Wert 0.
|
readnonatomiccopy |
Die Fehlerdetails der letzten Anfrage (falls vorhanden) oder nil
, wenn die letzte Anfrage erfolgreich war.
|
readwritenonatomicweak |
Der Delegat für den Empfang von Benachrichtigungen über Änderungen am Status des Kanals.
|
readnonatomiccopyinherited |
Der Namespace des Channels.
|
readnonatomicassigninherited |
Ein Flag, das angibt, ob dieser Channel derzeit verbunden ist.
|
readnonatomicweakinherited |
Der Gerätemanager, mit dem dieser Kanal registriert ist, falls vorhanden.
- Deprecated:
- Wenn dieser Kanal nicht mit der eingestellten Klasse GCKDeviceManager registriert wurde, ist dies
nil
.