GCKMediaControlChannel-Klasse

GCKMediaControlChannel-Klassenreferenz

Ü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

GCKMediaStatusmediaStatus
 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
 
GCKErrorlastError
 Die Fehlerdetails der letzten Anfrage (falls vorhanden) oder nil, wenn die letzte Anfrage erfolgreich war. Weitere Informationen
 
id< GCKMediaControlChannelDelegatedelegate
 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
 
GCKDeviceManagerdeviceManager
 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
mediaInfoAn 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
mediaInfoAn object describing the media item to load.
autoplayWhether 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
customDataCustom 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil.
customDataCustom 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
activeTrackIDsAn 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
textTrackStyleThe 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
customDataCustom 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
customDataCustom 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
customDataCustom 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
positionThe 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
positionThe new position interval from the beginning of the stream.
resumeStateThe 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
positionThe new position from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe 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
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
playPositionThe 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.
repeatModeThe repeat mode for playing the queue.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDThe 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
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDID 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.
customDataCustom 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
itemThe item to insert.
beforeItemIDThe 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
itemThe item to insert.
beforeItemIDThe 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
itemThe item to insert.
beforeItemIDThe 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.
playPositionThe 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.
customDataCustom 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
queueItemsThe 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
queueItemsThe list of updated items.
customDataCustom 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
itemIDsAn 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
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
customDataCustom 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
itemIDThe 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
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDID 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
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDThe 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.
customDataCustom 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
itemIDThe ID of the item to move.
beforeItemIDThe 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
itemIDThe 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
itemIDThe ID of the item to jump to.
customDataCustom 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
itemIDThe ID of the item to jump to.
playPositionThe 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.
customDataCustom 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
repeatModeThe 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
volumeThe 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
volumeThe new volume, in the range [0.0 - 1.0].
customDataCustom 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
mutedWhether 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
mutedWhether the stream should be muted or unmuted.
customDataCustom 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
requestIDThe ID of the request to cancel.
Ausgabe
YES, wenn die Anfrage abgebrochen wurde, oder NO, 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
protocolNamespaceThe 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
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

Sendet eine SMS über diesen Kanal.

Parameters
messageThe message.
Ausgabe
YES bei Erfolg oder NO, 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
messageThe message.
errorA pointer at which to store the error result. May be nil.
Ausgabe
YES bei Erfolg oder NO, 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

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

Der Medienstatus für die aktuell geladenen Medien, falls vorhanden. Andernfalls nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

Die Zeit, die seit dem letzten Update des Media-Status vergangen ist.

Wenn gerade eine Statusanfrage läuft, ist dieser Wert 0.

- (GCKError*) lastError
readnonatomiccopy

Die Fehlerdetails der letzten Anfrage (falls vorhanden) oder nil, wenn die letzte Anfrage erfolgreich war.

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

Der Delegat für den Empfang von Benachrichtigungen über Änderungen am Status des Kanals.

- (NSString*) protocolNamespace
readnonatomiccopyinherited

Der Namespace des Channels.

- (BOOL) isConnected
readnonatomicassigninherited

Ein Flag, das angibt, ob dieser Channel derzeit verbunden ist.

- (GCKDeviceManager*) deviceManager
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.