Clase GCKMediaControlChannel

Referencia de la clase GCKMediaControlChannel

Descripción general

Una subclase GCKCastChannel para operaciones de control de medios.

Cualquier operación que se aplique a una transmisión actualmente activa (reproducir, pausar, buscar, detener, etc.) requiere un estado multimedia válido (es decir, que no sea nulo), o bien devolverá kGCKInvalidRequestID y no enviará la solicitud. El estado del contenido multimedia se solicita automáticamente cuando se conecta el canal, se incluye una carga exitosa que se completó y también se puede actualizar en cualquier momento. El estado del contenido multimedia también puede ser nulo en cualquier momento. Esto sucede, por ejemplo, si el canal se desconecta temporalmente. Cuando se usa este canal, se deben supervisar los cambios de estado del contenido multimedia a través de la devolución de llamada mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p), y se debe llamar a los métodos que actúan en las transmisiones solo si el estado del contenido multimedia no es nulo.

Si una solicitud se inicia correctamente, el método correspondiente muestra el ID de solicitud asignado a esa solicitud. Si no se inicia la solicitud, el método muestra kGCKInvalidRequestID y establece la propiedad lastError para indicar el motivo del error. Si una solicitud se inicia correctamente, pero en última instancia falla, se invocará la devolución de llamada mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) para indicar la falla.

Consulta GCKMediaControlChannelDelegate para ver el protocolo de delegado.

Deprecated:
Usa la propiedad GCKRemoteMediaClient de GCKCastSession para controlar la reproducción de contenido multimedia.

Hereda GCKCastChannel.

Resumen del método de instancia

(instancetype) - init
 Inicializador designado. Más...
 
(NSInteger) - loadMedia:
 Carga y comienza la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - loadMedia:autoplay:
 Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - loadMedia:autoplay:playPosition:
 Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - loadMedia:autoplay:playPosition:customData:
 Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:
 Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:customData:
 Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia. Más...
 
(NSInteger) - setActiveTrackIDs:
 Establece los segmentos activos. Más...
 
(NSInteger) - setTextTrackStyle:
 Establece el estilo de la pista de texto. Más...
 
(NSInteger) - pause
 Pausa la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - pauseWithCustomData:
 Pausa la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - stop
 Detiene la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - stopWithCustomData:
 Detiene la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - play
 Inicia (o reanuda) la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - playWithCustomData:
 Inicia (o reanuda) la reproducción del elemento multimedia actual. Más...
 
(NSInteger) - seekToTimeInterval:
 Busca una posición nueva dentro del elemento multimedia actual. Más...
 
(NSInteger) - seekToTimeInterval:resumeState:
 Busca una posición nueva dentro del elemento multimedia actual. Más...
 
(NSInteger) - seekToTimeInterval:resumeState:customData:
 Busca una posición nueva dentro del elemento multimedia actual. Más...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:
 Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia. Más...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:customData:
 Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia. Más...
 
(NSInteger) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia. Más...
 
(NSInteger) - queueInsertItems:beforeItemWithID:
 Inserta una lista de nuevos elementos multimedia en la fila. Más...
 
(NSInteger) - queueInsertItems:beforeItemWithID:customData:
 Inserta una lista de nuevos elementos multimedia en la fila. Más...
 
(NSInteger) - queueInsertItem:beforeItemWithID:
 Un método de conveniencia que inserta un solo elemento en la cola. Más...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:
 Un método de conveniencia que inserta un solo elemento en la cola y lo convierte en el elemento actual. Más...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
 Un método de conveniencia que inserta un solo elemento en la cola y lo convierte en el elemento actual. Más...
 
(NSInteger) - queueUpdateItems:
 Actualiza la cola. Más...
 
(NSInteger) - queueUpdateItems:customData:
 Actualiza la cola. Más...
 
(NSInteger) - queueRemoveItemsWithIDs:
 Quita una lista de elementos multimedia de la fila. Más...
 
(NSInteger) - queueRemoveItemsWithIDs:customData:
 Quita una lista de elementos multimedia de la fila. Más...
 
(NSInteger) - queueRemoveItemWithID:
 Un método de conveniencia que quita un solo elemento de la cola. Más...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:
 Reordena una lista de elementos multimedia en la fila. Más...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
 Reordena una lista de elementos multimedia en la fila. Más...
 
(NSInteger) - queueMoveItemWithID:beforeItemWithID:
 Un método de conveniencia que mueve un solo elemento en la cola. Más...
 
(NSInteger) - queueJumpToItemWithID:
 Salta al elemento con el ID especificado en la cola. Más...
 
(NSInteger) - queueJumpToItemWithID:customData:
 Salta al elemento con el ID especificado en la cola. Más...
 
(NSInteger) - queueJumpToItemWithID:playPosition:customData:
 Salta al elemento con el ID especificado en la cola. Más...
 
(NSInteger) - queueNextItem
 Pasa al siguiente elemento en la cola. Más...
 
(NSInteger) - queuePreviousItem
 Se desplaza al elemento anterior en la cola. Más...
 
(NSInteger) - queueSetRepeatMode:
 Establece el modo de repetición en cola. Más...
 
(NSInteger) - setStreamVolume:
 Establece el volumen de la transmisión. Más...
 
(NSInteger) - setStreamVolume:customData:
 Establece el volumen de la transmisión. Más...
 
(NSInteger) - setStreamMuted:
 Establece si se silencia la transmisión. Más...
 
(NSInteger) - setStreamMuted:customData:
 Establece si se silencia la transmisión. Más...
 
(NSInteger) - requestStatus
 Solicita información actualizada sobre el estado del contenido multimedia al receptor. Más...
 
(NSTimeInterval) - approximateStreamPosition
 Muestra la posición aproximada de la transmisión según se calcula a partir de la información de la última transmisión recibida y el tiempo transcurrido desde esa actualización. Más...
 
(BOOL) - cancelRequestWithID:
 Cancela una solicitud en curso. Más...
 
(instancetype) - initWithNamespace:
 Inicializador designado. Más...
 
(void) - didReceiveTextMessage:
 Se llama cuando se recibe un mensaje de texto en este canal. Más...
 
(BOOL) - sendTextMessage:
 Envía un mensaje de texto a este canal. Más...
 
(BOOL) - sendTextMessage:error:
 Envía un mensaje de texto a este canal. Más...
 
(NSInteger) - generateRequestID
 Genera un ID de solicitud para un mensaje nuevo. Más...
 
(NSNumber *__nullable) - generateRequestNumber
 Un método de conveniencia que une el resultado de generateRequestID en un NSNumber. Más...
 
(void) - didConnect
 Se llama cuando este canal se conecta, lo que indica que los mensajes ahora se pueden intercambiar con el dispositivo de transmisión a través de este canal. Más...
 
(void) - didDisconnect
 Se llama cuando este canal se desconecta, lo que indica que los mensajes ya no se pueden intercambiar con el dispositivo de transmisión a través de este canal. Más...
 

Resumen de la propiedad

GCKMediaStatusmediaStatus
 El estado del contenido multimedia cargado actualmente, si lo hubiera; de lo contrario, nil. Más...
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 Tiempo transcurrido desde que se recibió la última actualización del estado del contenido multimedia. Más...
 
GCKErrorlastError
 Es el detalle del error de la última solicitud, si existe, o nil, si la última solicitud se realizó correctamente. Más...
 
id< GCKMediaControlChannelDelegatedelegate
 El delegado que recibirá las notificaciones sobre los cambios en el estado del canal. Más...
 
NSString * protocolNamespace
 El espacio de nombres del canal. Más...
 
BOOL isConnected
 Marca que indica si el canal está conectado actualmente Más...
 
GCKDeviceManagerdeviceManager
 El administrador de dispositivos con el que se registró este canal, si corresponde. Más...
 

Detalle del método

- (instancetype) init

Inicializador designado.

Implementa GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo

Carga y comienza la reproducción de un nuevo elemento multimedia.

Parameters
mediaInfoAn object describing the media item to load.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay 

Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia.

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition 

Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia.

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs 

Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  customData 

Carga y, de manera opcional, inicia la reproducción de un nuevo elemento multimedia.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs

Establece los segmentos activos.

La solicitud fallará si no hay un estado multimedia actual.

Parameters
activeTrackIDsAn array of integers specifying the active tracks.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje. Puede ser nil o un array vacío para configurar las pistas activas en la lista vacía.
- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable)  textTrackStyle

Establece el estilo de la pista de texto.

La solicitud fallará si no hay un estado multimedia actual.

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) pause

Pausa la reproducción del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual.

Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) pauseWithCustomData: (id __nullable)  customData

Pausa la reproducción del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) stop

Detiene la reproducción del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual. Si una cola está cargada actualmente, se quita.

Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) stopWithCustomData: (id __nullable)  customData

Detiene la reproducción del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual. Si una cola está cargada actualmente, se quita.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) play

Inicia (o reanuda) la reproducción del elemento multimedia actual.

La reproducción siempre comienza al inicio de la transmisión. La solicitud fallará si no hay un estado multimedia actual.

Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) playWithCustomData: (id __nullable)  customData

Inicia (o reanuda) la reproducción del elemento multimedia actual.

La reproducción siempre comienza al inicio de la transmisión. La solicitud fallará si no hay un estado multimedia actual.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position

Busca una posición nueva dentro del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual.

Parameters
positionThe new position from the beginning of the stream.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState 

Busca una posición nueva dentro del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual.

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState
customData: (id __nullable)  customData 

Busca una posición nueva dentro del elemento multimedia actual.

La solicitud fallará si no hay un estado multimedia actual.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode 

Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
playPosition: (NSTimeInterval)  playPosition
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

Carga y, de manera opcional, inicia la reproducción de una nueva cola de elementos multimedia.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID 

Inserta una lista de nuevos elementos multimedia en la fila.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

Inserta una lista de nuevos elementos multimedia en la fila.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueInsertItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

Un método de conveniencia que inserta un solo elemento en la cola.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

Un método de conveniencia que inserta un solo elemento en la cola y lo convierte en el elemento actual.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

Un método de conveniencia que inserta un solo elemento en la cola y lo convierte en el elemento actual.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems

Actualiza la cola.

Parameters
queueItemsThe list of updated items.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (id __nullable)  customData 

Actualiza la cola.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

Quita una lista de elementos multimedia de la fila.

Si la cola queda vacía como resultado, se finalizará la sesión multimedia actual.

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs
customData: (id __nullable)  customData 

Quita una lista de elementos multimedia de la fila.

Si la cola queda vacía como resultado, se finalizará la sesión multimedia actual.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueRemoveItemWithID: (NSUInteger)  itemID

Un método de conveniencia que quita un solo elemento de la cola.

Parameters
itemIDThe ID of the item to remove.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID 

Reordena una lista de elementos multimedia en la fila.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

Reordena una lista de elementos multimedia en la fila.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueMoveItemWithID: (NSUInteger)  itemID
beforeItemWithID: (NSUInteger)  beforeItemID 

Un método de conveniencia que mueve un solo elemento en la cola.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID

Salta al elemento con el ID especificado en la cola.

Parameters
itemIDThe ID of the item to jump to.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (id __nullable)  customData 

Salta al elemento con el ID especificado en la cola.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

Salta al elemento con el ID especificado en la cola.

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.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueNextItem

Pasa al siguiente elemento en la cola.

Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queuePreviousItem

Se desplaza al elemento anterior en la cola.

Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

Establece el modo de repetición en cola.

Parameters
repeatModeThe new repeat mode.
Resultado que se muestra
El ID de solicitud de esta solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) setStreamVolume: (float)  volume

Establece el volumen de la transmisión.

La solicitud fallará si no hay una sesión multimedia actual.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) setStreamVolume: (float)  volume
customData: (id __nullable)  customData 

Establece el volumen de la transmisión.

La solicitud fallará si no hay una sesión multimedia actual.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) setStreamMuted: (BOOL)  muted

Establece si se silencia la transmisión.

La solicitud fallará si no hay una sesión multimedia actual.

Parameters
mutedWhether the stream should be muted or unmuted.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) setStreamMuted: (BOOL)  muted
customData: (id __nullable)  customData 

Establece si se silencia la transmisión.

La solicitud fallará si no hay una sesión multimedia actual.

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.
Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) requestStatus

Solicita información actualizada sobre el estado del contenido multimedia al receptor.

Resultado que se muestra
El ID de solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSTimeInterval) approximateStreamPosition

Muestra la posición aproximada de la transmisión según se calcula a partir de la información de la última transmisión recibida y el tiempo transcurrido desde esa actualización.

Muestra 0 si el canal no está conectado o si no hay ningún contenido multimedia cargado actualmente.

- (BOOL) cancelRequestWithID: (NSInteger)  requestID

Cancela una solicitud en curso.

Cancelar una solicitud no impide que se ejecute; simplemente indica que la aplicación que llama ya no está interesada en los resultados de la solicitud, por lo que cualquier estado asociado con el seguimiento de la solicitud se borrará.

Parameters
requestIDThe ID of the request to cancel.
Resultado que se muestra
YES si se canceló la solicitud o NO si no hay ninguna solicitud de seguimiento con el ID proporcionado.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

Inicializador designado.

Construye un GCKCastChannel nuevo con el espacio de nombres dado.

Parameters
protocolNamespaceThe namespace.

Se implementó en GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *)  message

Se llama cuando se recibe un mensaje de texto en este canal.

La implementación predeterminada es no-op.

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

Envía un mensaje de texto a este canal.

Parameters
messageThe message.
Resultado que se muestra
YES tiene éxito o NO si no se pudo enviar el mensaje (porque el canal no está conectado o porque el búfer de envío está demasiado lleno en este momento).
Deprecated:
Usa sendTextMessage:error:, que proporciona información detallada sobre los errores.
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

Envía un mensaje de texto a este canal.

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
Resultado que se muestra
YES en caso de éxito o NO si no se pudo enviar el mensaje.
- (NSInteger) generateRequestID

Genera un ID de solicitud para un mensaje nuevo.

Resultado que se muestra
El ID generado o kGCKInvalidRequestID si el canal no está conectado actualmente.
- (NSNumber * __nullable) generateRequestNumber

Un método de conveniencia que une el resultado de generateRequestID en un NSNumber.

Resultado que se muestra
El ID generado o nil si el canal no está conectado actualmente.
- (void) didConnect

Se llama cuando este canal se conecta, lo que indica que los mensajes ahora se pueden intercambiar con el dispositivo de transmisión a través de este canal.

La implementación predeterminada es no-op.

- (void) didDisconnect

Se llama cuando este canal se desconecta, lo que indica que los mensajes ya no se pueden intercambiar con el dispositivo de transmisión a través de este canal.

La implementación predeterminada es no-op.

Detalles de la propiedad

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

El estado del contenido multimedia cargado actualmente, si lo hubiera; de lo contrario, nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

Tiempo transcurrido desde que se recibió la última actualización del estado del contenido multimedia.

Si hay una solicitud de estado en curso, este será 0.

- (GCKError*) lastError
readnonatomiccopy

Es el detalle del error de la última solicitud, si existe, o nil, si la última solicitud se realizó correctamente.

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

El delegado que recibirá las notificaciones sobre los cambios en el estado del canal.

- (NSString*) protocolNamespace
readnonatomiccopyinherited

El espacio de nombres del canal.

- (BOOL) isConnected
readnonatomicassigninherited

Marca que indica si el canal está conectado actualmente

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

El administrador de dispositivos con el que se registró este canal, si corresponde.

Deprecated:
Si este canal no se registró con la clase obsoleta GCKDeviceManager, será nil.