Clase GCKMediaControlChannel

Referencia de la clase GCKMediaControlChannel

Descripción general

Es una subclase de GCKCastChannel para las operaciones de control de medios.

Todas las operaciones que se aplican a una transmisión activa (reproducir, pausar, buscar, detener, etcétera) requieren un estado de medios válido (es decir, no nulo), o bien devolverán kGCKInvalidRequestID y no enviarán la solicitud. El estado de los medios se solicita automáticamente cuando se conecta el canal, se incluye con una respuesta de carga completada correcta y también se puede actualizar en cualquier momento. El estado de contenido multimedia también puede ser nulo en cualquier momento. Esto ocurrirá si el canal se desconecta temporalmente, por ejemplo. Cuando se usa este canal, los cambios de estado de los medios se deben supervisar a través de la devolución de llamada mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p), y los métodos que actúan sobre las transmisiones solo se deben llamar mientras el estado de los medios no sea nulo.

Si una solicitud se inicia correctamente, el método correspondiente devuelve el ID de solicitud que se le asignó. Si la solicitud no se inicia, el método devuelve kGCKInvalidRequestID y establece la propiedad lastError para indicar el motivo del error. Si una solicitud se inicia correctamente, pero 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 de métodos de instancia

(instancetype) - init
 Es el 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
 Comienza (o reanuda) la reproducción del elemento multimedia actual. Más…
 
(NSInteger) - playWithCustomData:
 Comienza (o reanuda) la reproducción del elemento multimedia actual. Más…
 
(NSInteger) - seekToTimeInterval:
 Busca una nueva posición dentro del elemento multimedia actual. Más…
 
(NSInteger) - seekToTimeInterval:resumeState:
 Busca una nueva posición dentro del elemento multimedia actual. Más…
 
(NSInteger) - seekToTimeInterval:resumeState:customData:
 Busca una nueva posición dentro del elemento multimedia actual. Más…
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:
 Carga y, de forma opcional, inicia la reproducción de una nueva fila de elementos multimedia. Más…
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:customData:
 Carga y, de forma opcional, inicia la reproducción de una nueva fila de elementos multimedia. Más…
 
(NSInteger) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 Carga y, de forma opcional, inicia la reproducción de una nueva fila de elementos multimedia. Más…
 
(NSInteger) - queueInsertItems:beforeItemWithID:
 Inserta una lista de elementos multimedia nuevos en la fila. Más…
 
(NSInteger) - queueInsertItems:beforeItemWithID:customData:
 Inserta una lista de elementos multimedia nuevos en la fila. Más…
 
(NSInteger) - queueInsertItem:beforeItemWithID:
 Es un método de conveniencia que inserta un solo elemento en la cola. Más…
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:
 Es 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:
 Es 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 fila. Más…
 
(NSInteger) - queueUpdateItems:customData:
 Actualiza la fila. 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:
 Es un método de conveniencia que quita un solo elemento de la fila. 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:
 Es un método de conveniencia que mueve un solo elemento en la fila. 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 de la fila. Más…
 
(NSInteger) - queuePreviousItem
 Se mueve al elemento anterior de la fila. Más…
 
(NSInteger) - queueSetRepeatMode:
 Establece el modo de repetición de la 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 la transmisión está silenciada. Más…
 
(NSInteger) - setStreamMuted:customData:
 Establece si la transmisión está silenciada. Más…
 
(NSInteger) - requestStatus
 Solicita información actualizada sobre el estado de los medios del receptor. Más…
 
(NSTimeInterval) - approximateStreamPosition
 Devuelve la posición aproximada de la transmisión, calculada a partir de la última información de la transmisión recibida y el tiempo transcurrido desde esa actualización. Más…
 
(BOOL) - cancelRequestWithID:
 Cancela una solicitud en curso. Más…
 
(instancetype) - initWithNamespace:
 Es el 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 en este canal. Más…
 
(BOOL) - sendTextMessage:error:
 Envía un mensaje de texto en este canal. Más…
 
(NSInteger) - generateRequestID
 Genera un ID de solicitud para un mensaje nuevo. Más…
 
(NSNumber *__nullable) - generateRequestNumber
 Es un método de conveniencia que encapsula el resultado de generateRequestID en un NSNumber. Más…
 
(void) - didConnect
 Se llama a este método cuando se conecta este canal, lo que indica que ahora se pueden intercambiar mensajes con el dispositivo Cast a través de este canal. Más…
 
(void) - didDisconnect
 Se llama cuando se desconecta este canal, lo que indica que ya no se pueden intercambiar mensajes con el dispositivo Cast a través de este canal. Más…
 

Resumen de la propiedad

GCKMediaStatusmediaStatus
 Es el estado de los medios del contenido multimedia cargado actualmente, si hay alguno; de lo contrario, es nil. Más…
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 Cantidad de tiempo que transcurrió desde la última actualización del estado de los medios. Más…
 
GCKErrorlastError
 Detalles del error de la última solicitud, si hubo alguno, o nil si la última solicitud se realizó correctamente. Más…
 
id< GCKMediaControlChannelDelegatedelegate
 Es el delegado para recibir notificaciones sobre los cambios en el estado del canal. Más…
 
NSString * protocolNamespace
 Es el espacio de nombres del canal. Más…
 
BOOL isConnected
 Es una marca que indica si este canal está conectado actualmente. Más…
 
GCKDeviceManagerdeviceManager
 Es el administrador de dispositivos con el que se registró este canal, si corresponde. Más…
 

Detalle del método

- (instancetype) init

Es el 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.
Muestra
ID de la 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.
Muestra
ID de la 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.
Muestra
ID de la 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.
Muestra
ID de la 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.
Muestra
ID de la 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.
Muestra
ID de la 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 de medios actual.

Parameters
activeTrackIDsAn array of integers specifying the active tracks.
Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje. Puede ser nil o un array vacío para establecer 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 de medios actual.

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
Muestra
ID de la 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 de medios actual.

Muestra
ID de la 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 de medios 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.
Muestra
ID de la 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 de medios actual. Si hay una fila cargada actualmente, se quitará.

Muestra
ID de la 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 de medios actual. Si hay una fila cargada actualmente, se quitará.

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

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

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

Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) playWithCustomData: (id __nullable)  customData

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

La reproducción siempre comienza al principio de la transmisión. La solicitud fallará si no hay un estado de medios 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.
Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position

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

La solicitud fallará si no hay un estado de medios actual.

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

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

La solicitud fallará si no hay un estado de medios actual.

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

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

La solicitud fallará si no hay un estado de medios 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.
Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode 

Carga y, de forma opcional, inicia la reproducción de una nueva fila 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.
Muestra
Es el ID de la solicitud, o bien 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 forma opcional, inicia la reproducción de una nueva fila 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.
Muestra
Es el ID de la solicitud, o bien 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 forma opcional, inicia la reproducción de una nueva fila 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.
Muestra
Es el ID de la solicitud, o bien 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 elementos multimedia nuevos 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.
Muestra
Es el ID de la solicitud, o bien 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 elementos multimedia nuevos 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.
Muestra
Es el ID de la solicitud, o bien 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 

Es 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.
Muestra
Es el ID de la solicitud, o bien 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 

Es 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.
Muestra
Es el ID de la solicitud, o bien 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 

Es 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.
Muestra
Es el ID de la solicitud, o bien 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 fila.

Parameters
queueItemsThe list of updated items.
Muestra
Es el ID de la solicitud, o bien 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 fila.

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.
Muestra
Es el ID de la solicitud, o bien 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 fila queda vacía como resultado, se finalizará la sesión de medios actual.

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
Muestra
Es el ID de la solicitud, o bien 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 fila queda vacía como resultado, se finalizará la sesión de medios 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.
Muestra
Es el ID de la solicitud, o bien kGCKInvalidRequestID si no se pudo enviar el mensaje o si alguno de los parámetros no es válido.
- (NSInteger) queueRemoveItemWithID: (NSUInteger)  itemID

Es un método de conveniencia que quita un solo elemento de la fila.

Parameters
itemIDThe ID of the item to remove.
Muestra
Es el ID de la solicitud, o bien 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.
Muestra
Es el ID de la solicitud, o bien 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.
Muestra
Es el ID de la solicitud, o bien 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 

Es un método de conveniencia que mueve un solo elemento en la fila.

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.
Muestra
Es el ID de la solicitud, o bien 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.
Muestra
Es el ID de la 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.
Muestra
Es el ID de la 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.
Muestra
Es el ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueNextItem

Pasa al siguiente elemento de la fila.

Muestra
Es el ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queuePreviousItem

Se mueve al elemento anterior de la fila.

Muestra
Es el ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

Establece el modo de repetición de la cola.

Parameters
repeatModeThe new repeat mode.
Muestra
Es el ID de la solicitud, o bien 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].
Muestra
ID de la 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.
Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSInteger) setStreamMuted: (BOOL)  muted

Establece si la transmisión está silenciada.

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

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

Establece si la transmisión está silenciada.

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

Solicita información actualizada sobre el estado de los medios del receptor.

Muestra
ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar el mensaje.
- (NSTimeInterval) approximateStreamPosition

Devuelve la posición aproximada de la transmisión, calculada a partir de la última información de la transmisión recibida y el tiempo transcurrido desde esa actualización.

Devuelve 0 si el canal no está conectado o si no se cargó ningún contenido multimedia.

- (BOOL) cancelRequestWithID: (NSInteger)  requestID

Cancela una solicitud en curso.

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

Parameters
requestIDThe ID of the request to cancel.
Muestra
YES si se canceló la solicitud o NO si no se está haciendo un seguimiento de la solicitud con el ID determinado.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

Es el inicializador designado.

Crea un nuevo GCKCastChannel con el espacio de nombres determinado.

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 no es operativa.

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

Envía un mensaje de texto en este canal.

Parameters
messageThe message.
Muestra
YES si se realizó correctamente 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 el error.
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

Envía un mensaje de texto en este canal.

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
Muestra
YES si se envió correctamente o NO si no se pudo enviar el mensaje.
- (NSInteger) generateRequestID

Genera un ID de solicitud para un mensaje nuevo.

Muestra
Es el ID generado o kGCKInvalidRequestID si el canal no está conectado en este momento.
- (NSNumber * __nullable) generateRequestNumber

Es un método de conveniencia que encapsula el resultado de generateRequestID en un NSNumber.

Muestra
Es el ID generado o nil si el canal no está conectado en este momento.
- (void) didConnect

Se llama a este método cuando se conecta este canal, lo que indica que ahora se pueden intercambiar mensajes con el dispositivo Cast a través de este canal.

La implementación predeterminada no es operativa.

- (void) didDisconnect

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

La implementación predeterminada no es operativa.

Detalles de la propiedad

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

Es el estado de los medios del contenido multimedia cargado actualmente, si hay alguno; de lo contrario, es nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

Cantidad de tiempo que transcurrió desde la última actualización del estado de los medios.

Si una solicitud de estado se encuentra en curso actualmente, este valor será 0.

- (GCKError*) lastError
readnonatomiccopy

Detalles del error de la última solicitud, si hubo alguno, o nil si la última solicitud se realizó correctamente.

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

Es el delegado para recibir notificaciones sobre los cambios en el estado del canal.

- (NSString*) protocolNamespace
readnonatomiccopyinherited

Es el espacio de nombres del canal.

- (BOOL) isConnected
readnonatomicassigninherited

Es una marca que indica si este canal está conectado actualmente.

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

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

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