Clase GCKUIMediaController

Referencia de la clase GCKUIMediaController

Descripción general

Un controlador para vistas de IU que se usa para controlar o mostrar el estado de la reproducción de contenido multimedia en un receptor de transmisión.

La aplicación emisora registra los controles de la IU relacionados con los medios con el controlador configurando las propiedades apropiadas. Luego, el controlador responde a los eventos táctiles en los controles mediante la emisión de comandos multimedia apropiados al receptor y actualiza los controles según la información de estado y los metadatos de medios recibidos del receptor. El control habilita e inhabilita automáticamente los controles de la IU según corresponda para la sesión actual y el estado del reproductor multimedia. Además, inhabilita todos los controles mientras haya una solicitud en curso.

Consulta GCKUIMediaControllerDelegate para ver el protocolo de delegado.

Since
3.0

Hereda NSObject.

Resumen del método de instancia

(instancetype) - init
 Inicializa una instancia. Más...
 
(void) - bindLabel:toMetadataKey:
 Vincula una UILabel a una clave de metadatos. Más...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Vincula una UILabel a una clave de metadatos. Más...
 
(void) - bindTextView:toMetadataKey:
 Vincula un elemento UITextView a una clave de metadatos. Más...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Vincula un elemento UITextView a una clave de metadatos. Más...
 
(void) - bindImageView:toImageHints:
 Vincula una UIImageView a una instancia GCKUIImageHints. Más...
 
(void) - unbindView:
 Desvincula la vista especificada. Más...
 
(void) - unbindAllViews
 Desvincula todas las vistas vinculadas. Más...
 
(GCKMediaRepeatMode- cycleRepeatMode
 Cambia el modo de repetición para la cola al siguiente modo del ciclo: Más...
 
(void) - selectTracks
 Un método conveniente para mostrar la IU de selección de la pista de contenido multimedia Más...
 

Resumen de la propiedad

id< GCKUIMediaControllerDelegatedelegate
 El delegado para recibir notificaciones de GCKUIMediaController. Más...
 
GCKSessionsession
 La sesión asociada con este control. Más...
 
BOOL mediaLoaded
 Si hay algún contenido multimedia cargado actualmente (o cargando) en el receptor. Más...
 
BOOL hasCurrentQueueItem
 Indica si hay un elemento actual en la cola. Más...
 
BOOL hasLoadingQueueItem
 Indica si hay un elemento precargado en la cola. Más...
 
GCKMediaPlayerState lastKnownPlayerState
 El último estado conocido del reproductor multimedia. Más...
 
NSTimeInterval lastKnownStreamPosition
 La última posición conocida de transmisión de contenido multimedia. Más...
 
UIButton * playButton
 Un botón para "reproducir" Más...
 
UIButton * pauseButton
 Un botón de "pausa". Más...
 
GCKUIButtonplayPauseToggleButton
 Un botón de activación para reproducir y pausar. Más...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Un control deslizante para reproducir y pausar. Más...
 
UIButton * stopButton
 Un botón de "detener". Más...
 
GCKUIButtonforward30SecondsButton
 Un botón para adelantar 30 segundos del elemento multimedia que se está reproduciendo Más...
 
GCKUIButtonrewind30SecondsButton
 Un botón para buscar 30 segundos en el elemento multimedia que se está reproduciendo Más...
 
UIButton * pauseQueueButton
 Botón para pausar la reproducción de las colas una vez que termina de reproducirse el elemento actual. Más...
 
UIButton * nextButton
 Un botón "Siguiente" Más...
 
UIButton * previousButton
 Un botón "anterior". Más...
 
GCKUIButtonrepeatModeButton
 Botón para recorrer los modos de repetición de la cola disponibles. Más...
 
UISlider * streamPositionSlider
 Un control deslizante para mostrar y cambiar la posición actual de la transmisión Más...
 
UIProgressView * streamProgressView
 Una vista para mostrar el progreso actual de la transmisión. Más...
 
UILabel * streamPositionLabel
 Una etiqueta para mostrar la posición actual de la transmisión en minutos y segundos. Más...
 
UILabel * streamDurationLabel
 Una etiqueta para mostrar la duración de la transmisión actual en minutos y segundos. Más...
 
UILabel * streamTimeRemainingLabel
 Una etiqueta para mostrar el tiempo de transmisión restante (la duración menos la posición), en minutos y segundos. Más...
 
GCKUIStreamPositionControllerstreamPositionController
 Un controlador de posición de transmisión. Más...
 
BOOL displayTimeRemainingAsNegativeValue
 Si el tiempo de transmisión restante se mostrará como un valor negativo, por ejemplo, "-1:23:45". Más...
 
UIButton * tracksButton
 Un botón para seleccionar pistas de audio o subtítulos. Más...
 
UILabel * smartSubtitleLabel
 Una etiqueta para mostrar un subtítulo para el contenido multimedia cargado actualmente. Más...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Una vista del indicador de actividad para indicar que el medio está en estado de carga. Más...
 

Detalle del método

- (instancetype) init

Inicializa una instancia.

- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key 

Vincula una UILabel a una clave de metadatos.

La vista mostrará el valor actual del campo de metadatos correspondiente.

Consulta GCKMediaMetadata para ver una lista de claves de metadatos predefinidas.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Vincula una UILabel a una clave de metadatos.

La vista mostrará el valor actual del campo de metadatos correspondiente.

Consulta GCKMediaMetadata para ver una lista de claves de metadatos predefinidas.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key 

Vincula un elemento UITextView a una clave de metadatos.

La vista mostrará el valor actual del campo de metadatos correspondiente.

Consulta GCKMediaMetadata para ver una lista de claves de metadatos predefinidas.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Vincula un elemento UITextView a una clave de metadatos.

La vista mostrará el valor actual del campo de metadatos correspondiente.

Consulta GCKMediaMetadata para ver una lista de claves de metadatos predefinidas.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindImageView: (UIImageView *)  imageView
toImageHints: (GCKUIImageHints *)  imageHints 

Vincula una UIImageView a una instancia GCKUIImageHints.

Se usará el UIImagePicker actualmente instalado a fin de seleccionar una imagen de los metadatos para la vista.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) unbindView: (UIView *)  view

Desvincula la vista especificada.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Desvincula todas las vistas vinculadas.

- (GCKMediaRepeatMode) cycleRepeatMode

Cambia el modo de repetición de la cola al siguiente modo del ciclo:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Resultado que se muestra
El nuevo modo de repetición.
- (void) selectTracks

Un método conveniente para mostrar la IU de selección de la pista de contenido multimedia

Detalles de la propiedad

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

El delegado para recibir notificaciones de GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

La sesión asociada con este control.

- (BOOL) mediaLoaded
readnonatomicassign

Si hay algún contenido multimedia cargado actualmente (o cargando) en el receptor.

Si no hay ninguna sesión de Cast activa, este será NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Indica si hay un elemento actual en la cola.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Indica si hay un elemento precargado en la cola.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

El último estado conocido del reproductor multimedia.

Si no hay ninguna sesión de transmisión activa, este será el estado del reproductor justo antes de que finalice la última sesión. Si no había una sesión anterior, esta será GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

La última posición conocida de transmisión de contenido multimedia.

Si no hay ninguna sesión de transmisión activa, esta será la posición de transmisión del contenido multimedia justo antes de que finalice la última sesión. Si no había una sesión anterior, esta será kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Un botón para "reproducir"

Cuando se presiona el botón, se inicia o reanuda la reproducción del contenido multimedia cargado actualmente en el receptor. El botón estará inhabilitado si la reproducción ya está en curso, si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (UIButton*) pauseButton
readwritenonatomicweak

Un botón de "pausa".

Cuando se presiona el botón, se pausa la reproducción del contenido multimedia cargado actualmente en el receptor. El botón estará inhabilitado si el medio cargado actualmente no admite la pausa, si la reproducción no está en curso, si no hay ningún contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa actualmente.

- (GCKUIButton*) playPauseToggleButton
readwritenonatomicweak

Un botón de activación para reproducir y pausar.

El emisor debe establecer los íconos adecuados para los estados GCKUIControlStatePlay y GCKUIControlStatePause del botón, es decir, un ícono de "pausa" para el estado de reproducción y un ícono para "reproducir" para el estado de pausa. El estado del botón se actualiza automáticamente para reflejar el estado de reproducción actual del receptor. Cuando se presiona el botón, se pausa o reanuda la reproducción del contenido multimedia cargado actualmente en el receptor. El botón estará inhabilitado si el medio cargado actualmente no admite la pausa, si la reproducción no está en curso o en pausa, si no hay ningún contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa actualmente.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Un control deslizante para reproducir y pausar.

Se usa como suplemento para una IU personalizada para alternar entre reproducción y pausa. Para obtener más información, consulta GCKUIPlayPauseToggleController.

Since
3.4
- (UIButton*) stopButton
readwritenonatomicweak

Un botón de "detener".

Cuando se presiona el botón, se detiene la reproducción del contenido multimedia cargado actualmente en el receptor. El botón estará inhabilitado si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (GCKUIButton*) forward30SecondsButton
readwritenonatomicweak

Un botón para adelantar 30 segundos del elemento multimedia que se está reproduciendo

El botón estará inhabilitado si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (GCKUIButton*) rewind30SecondsButton
readwritenonatomicweak

Un botón para buscar 30 segundos en el elemento multimedia que se está reproduciendo

El botón estará inhabilitado si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Botón para pausar la reproducción de las colas una vez que termina de reproducirse el elemento actual.

- (UIButton*) nextButton
readwritenonatomicweak

Un botón "Siguiente"

Cuando se presiona el botón, la reproducción se mueve al siguiente elemento multimedia de la fila. El botón estará inhabilitado si la operación no es compatible, si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (UIButton*) previousButton
readwritenonatomicweak

Un botón "anterior".

Cuando se presiona el botón, la reproducción se mueve al elemento multimedia anterior en la cola. El botón estará inhabilitado si la operación no es compatible, si no hay contenido multimedia cargado actualmente o si no hay una sesión de Cast actualmente activa.

- (GCKUIButton*) repeatModeButton
readwritenonatomicweak

Botón para recorrer los modos de repetición de la cola disponibles.

(Consulta GCKMediaRepeatMode). El emisor debe establecer íconos adecuados para los estados UIControlStateNormal (repetir), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll y GCKUIControlStateShuffle del botón. El estado del botón se actualiza automáticamente para reflejar el modo de repetición de la cola actual en el receptor. Al presionar el botón, se cambia al siguiente modo de repetición, en el orden:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

El botón se inhabilitará si no hay una sesión de transmisión activa actualmente.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

Un control deslizante para mostrar y cambiar la posición actual de la transmisión

Cuando el usuario cambia el valor del control deslizante, se actualiza la posición de la transmisión del contenido multimedia cargado actualmente en el receptor. Mientras se reproduce el contenido multimedia en la app receptora, el valor del control deslizante se actualiza en tiempo real para reflejar la posición actual de la transmisión. El control deslizante se inhabilitará si el contenido multimedia cargado actualmente no admite la búsqueda, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa actualmente.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Una vista para mostrar el progreso actual de la transmisión.

Mientras se reproduce el contenido multimedia en la app receptora, el valor de las vistas se actualiza en tiempo real para reflejar la posición actual de la transmisión. La vista se inhabilitará si el contenido multimedia cargado actualmente es una transmisión en vivo, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa actualmente.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

Una etiqueta para mostrar la posición actual de la transmisión en minutos y segundos.

Si no hay ningún contenido multimedia cargado actualmente, o si no hay una sesión de transmisión activa actualmente, la etiqueta muestra una forma localizada de "--:--".

- (UILabel*) streamDurationLabel
readwritenonatomicweak

Una etiqueta para mostrar la duración de la transmisión actual en minutos y segundos.

Si el medio cargado actualmente no tiene duración (por ejemplo, si es una transmisión en vivo), o si no hay contenido multimedia cargado actualmente, o si no hay ninguna sesión de transmisión activa actualmente, la etiqueta muestra un formato localizado ("--:").

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Una etiqueta para mostrar el tiempo de transmisión restante (la duración menos la posición), en minutos y segundos.

Si el medio cargado actualmente no tiene duración (por ejemplo, si es una transmisión en vivo), o si no hay contenido multimedia cargado actualmente, o si no hay ninguna sesión de transmisión activa actualmente, la etiqueta muestra un formato localizado ("--:").

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

Un controlador de posición de transmisión.

Se usa como suplemento para una IU o una posición de transmisión personalizadas que proporciona la aplicación. Para obtener más información, consulta GCKUIStreamPositionController.

Since
3.4
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Si el tiempo de transmisión restante se mostrará como un valor negativo, por ejemplo, "-1:23:45".

De forma predeterminada, esta propiedad se configura como YES.

- (UIButton*) tracksButton
readwritenonatomicweak

Un botón para seleccionar pistas de audio o subtítulos.

Cuando se presiona el botón, se muestra la IU de selección de pistas multimedia al usuario. El botón estará inhabilitado si el contenido multimedia cargado actualmente no tiene pistas de contenido multimedia seleccionables, si no hay contenido multimedia cargado actualmente o si no hay sesiones de transmisión activas.

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

Una etiqueta para mostrar un subtítulo para el contenido multimedia cargado actualmente.

Si no hay un campo de subtítulos establecido explícitamente en los metadatos, la etiqueta mostrará el campo de metadatos más adecuado según el tipo de medio; por ejemplo, el nombre del estudio para una película o el nombre del artista para una pista de música.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Una vista del indicador de actividad para indicar que el medio está en estado de carga.