Descripción general
Un controlador para vistas de IU que se usa a fin de controlar o mostrar el estado de la reproducción de contenido multimedia en un receptor de transmisión.
La aplicación que hace la llamada registra sus controles de IU relacionados con los medios con el controlador configurando las propiedades adecuadas. Luego, el controlador responde a los eventos táctiles de los controles mediante la emisión de los comandos multimedia adecuados al receptor y actualiza los controles según la información de estado y los metadatos multimedia 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 una solicitud está en curso.
Consulta GCKUIMediaControllerDelegate para conocer el protocolo de delegado.
- Desde
- 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 UITextView a una clave de metadatos. Más... | |
| (void) | - bindTextView:toMetadataKey:withFormatter: |
| Vincula un UITextView a una clave de metadatos. Más... | |
| (void) | - bindImageView:toImageHints: |
| Vincula una UIImageView a una instancia de GCKUIImageHints. Más... | |
| (void) | - bindControlView:toRewindForTime: |
Vincula un UIControl para retroceder la reproducción del elemento actual por el valor que se pasó como segundos. Más... | |
| (void) | - bindControlView:toForwardForTime: |
Vincula un UIControl para reenviar la reproducción del elemento actual por el valor pasado como segundos. 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 de la cola al siguiente en el ciclo: Más... | |
| (void) | - selectTracks |
| Un método útil para mostrar la IU de selección de pistas multimedia Más... | |
| (void) | - skipAd |
| Envía y supervisa la solicitud de omisión de anuncios. Más... | |
Resumen de la propiedad | |
| id< GCKUIMediaControllerDelegate > | delegate |
| Es el delegado para recibir notificaciones del GCKUIMediaController. Más... | |
| GCKSession * | session |
| La sesión asociada con este control. Más... | |
| BOOL | mediaLoaded |
| Si hay contenido multimedia cargado (o cargando) en el receptor Más... | |
| BOOL | hasCurrentQueueItem |
| Si hay un elemento actual en cola Más... | |
| BOOL | hasLoadingQueueItem |
| Si hay un elemento precargado en la cola Más... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| El estado más reciente del reproductor multimedia. Más... | |
| NSTimeInterval | lastKnownStreamPosition |
| La posición más reciente de transmisión de contenido multimedia conocida. Más... | |
| UIButton * | playButton |
| Un botón para "reproducir" Más... | |
| UIButton * | pauseButton |
| Un botón de pausa Más... | |
| GCKUIMultistateButton * | playPauseToggleButton |
| Un botón para activar o desactivar la reproducción/pausa. Más... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Un control para activar o desactivar la opción "reproducir/pausar". Más... | |
| UIButton * | stopButton |
| Un botón para detener Más... | |
| UIButton * | forward30SecondsButton |
| Un botón para avanzar 30 segundos en el elemento multimedia que se está reproduciendo. Más... | |
| UIButton * | rewind30SecondsButton |
| Un botón para buscar 30 segundos en el elemento multimedia que se está reproduciendo Más... | |
| UIButton * | pauseQueueButton |
| Un botón para pausar la reproducción de 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... | |
| GCKUIMultistateButton * | repeatModeButton |
| Un botón para alternar entre los modos de repetición de 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 |
| Es una vista para mostrar el progreso de la transmisión actual. 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 actual de la transmisión, en minutos y segundos. Más... | |
| UILabel * | streamTimeRemainingLabel |
| Es una etiqueta para mostrar el tiempo de transmisión restante (la duración menos la posición), en minutos y segundos. Más... | |
| GCKUIStreamPositionController * | streamPositionController |
| Un controlador de posición de transmisión. Más... | |
| GCKUIPlaybackRateController * | playbackRateController |
| Un controlador de frecuencia de reproducción de transmisión Más... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Indica si el tiempo de transmisión restante se mostrará como un valor negativo, por ejemplo, "-1:23:45". Más... | |
| BOOL | hideStreamPositionControlsForLiveContent |
| Si los controles de posición de la transmisión (incluidos el control deslizante de la posición de la transmisión, la etiqueta de posición de la transmisión, la etiqueta de duración de la transmisión y la vista de progreso de la transmisión) deben ocultarse para el contenido en vivo. 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 de indicador de actividad para indicar que el contenido multimedia se encuentra en estado de carga Más... | |
| UILabel * | skipAdLabel |
| Una etiqueta para mostrar el tiempo restante hasta que se pueda omitir el anuncio. Más... | |
| UIButton * | skipAdButton |
| Un botón para omitir el anuncio actual. 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 obtener una lista de las claves de metadatos predefinidas.
- Parameters
-
label The UILabel that will display the value. key The 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 obtener una lista de las claves de metadatos predefinidas.
- Parameters
-
label The UILabel that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
Vincula un UITextView a una clave de metadatos.
La vista mostrará el valor actual del campo de metadatos correspondiente.
Consulta GCKMediaMetadata para obtener una lista de las claves de metadatos predefinidas.
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
Vincula un UITextView a una clave de metadatos.
La vista mostrará el valor actual del campo de metadatos correspondiente.
Consulta GCKMediaMetadata para obtener una lista de las claves de metadatos predefinidas.
- Parameters
-
textView The UITextView that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindImageView: | (UIImageView *) | imageView | |
| toImageHints: | (GCKUIImageHints *) | imageHints | |
Vincula una UIImageView a una instancia de GCKUIImageHints.
Se usará el GCKUIImagePicker instalado actualmente para seleccionar una imagen de los metadatos de la vista.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) bindControlView: | (UIControl *) | control | |
| toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
Vincula un UIControl para retroceder la reproducción del elemento actual por el valor que se pasó como segundos.
La vista se actualizará según el estado GCKCastSession, el estado de reproducción remota y si se trata de una transmisión en vivo. También se agrega un destino a UIControl para capturar el evento UIControlEventTouchUpInside. No agregues objetivos de este tipo en UIControl. Para capturar el evento, usa los métodos GCKUIMediaControllerDelegate.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.rewindSeconds The number of seconds to rewind the media.
| - (void) bindControlView: | (UIControl *) | control | |
| toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
Vincula un UIControl para reenviar la reproducción del elemento actual por el valor pasado como segundos.
La vista se actualizará según el estado GCKCastSession, el estado de reproducción remota y si se trata de una transmisión en vivo. También se agrega un destino a UIControl para capturar el evento UIControlEventTouchUpInside. No agregues objetivos de este tipo en UIControl. Para capturar el evento, usa los métodos GCKUIMediaControllerDelegate.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.forwardSeconds The number of seconds to skip the media.
| - (void) unbindView: | (UIView *) | view |
Desvincula la vista especificada.
- Parameters
-
view The 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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Muestra
- El nuevo modo de repetición
| - (void) selectTracks |
Un método útil para mostrar la IU de selección de pistas multimedia
| - (void) skipAd |
Envía y supervisa la solicitud de omisión de anuncios.
- Desde
- 4.3
Detalles de la propiedad
|
readwritenonatomicweak |
Es el delegado para recibir notificaciones del GCKUIMediaController.
|
readnonatomicstrong |
La sesión asociada con este control.
|
readnonatomicassign |
Si hay contenido multimedia cargado (o cargando) en el receptor
Si no hay ninguna sesión de transmisión activa, este será NO.
|
readnonatomicassign |
Si hay un elemento actual en cola
|
readnonatomicassign |
Si hay un elemento precargado en la cola
|
readnonatomicassign |
El estado más reciente del reproductor multimedia.
Si no hay ninguna sesión de transmisión activa, este será el estado del jugador justo antes de que finalice la última sesión. Si no hubo una sesión anterior, será GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
La posición más reciente de transmisión de contenido multimedia conocida.
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 hubo sesión anterior, será kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Un botón para "reproducir"
Cuando se presiona el botón, se inicia o reanuda la reproducción del contenido multimedia que se está cargando en el receptor. El botón se inhabilitará si la reproducción ya está en curso, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón de pausa
Cuando se presiona el botón, se pausa la reproducción del contenido multimedia que se está cargando en el receptor. El botón se inhabilitará si el contenido multimedia cargado actualmente no admite la pausa, la reproducción no está en curso, el contenido no está cargado o la sesión de transmisión está activa.
|
readwritenonatomicweak |
Un botón para activar o desactivar la reproducción/pausa.
El llamador debe establecer los íconos apropiados para los estados del botón GCKUIButtonStatePlay, GCKUIButtonStatePlayLive y GCKUIButtonStatePause, es decir, un ícono de "pausa" para el estado de reproducción, un ícono de "parar" para el estado de reproducción en vivo y un ícono de "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 que se está cargando en el receptor. El botón se inhabilitará si el contenido multimedia cargado actualmente no admite la pausa, la reproducción no está en curso o detenida, o si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicstrong |
Un control para activar o desactivar la opción "reproducir/pausar".
Se usa como soporte para una IU de activación y pausa personalizada que proporciona la aplicación. Para obtener más información, consulta GCKUIPlayPauseToggleController.
- Desde
- 3.4
|
readwritenonatomicweak |
Un botón para detener
Cuando se presiona el botón, se detiene la reproducción del contenido multimedia que se está cargando en el receptor. El botón se inhabilitará si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón para avanzar 30 segundos en el elemento multimedia que se está reproduciendo.
El botón se inhabilitará si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón para buscar 30 segundos en el elemento multimedia que se está reproduciendo
El botón se inhabilitará si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón para pausar la reproducción de colas una vez que termina de reproducirse el elemento actual.
|
readwritenonatomicweak |
Un botón "Siguiente"
Cuando se presiona el botón, la reproducción se mueve al siguiente elemento multimedia en la cola. El botón se inhabilitará si la operación no es compatible, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón "Anterior"
Cuando se presiona el botón, la reproducción se mueve al elemento multimedia anterior de la cola. El botón se inhabilitará si la operación no es compatible, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
readwritenonatomicweak |
Un botón para alternar entre los modos de repetición de cola disponibles.
(Consulta GCKMediaRepeatMode). El emisor debe establecer los íconos adecuados para los estados de los botones GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll y GCKUIButtonStateShuffle. El estado del botón se actualiza automáticamente para reflejar el modo de repetición de cola actual en el receptor. Cuando se presiona el botón, se cambia al siguiente modo de repetición, en el orden siguiente:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Si no hay ninguna sesión de transmisión activa en este momento, se inhabilitará el botón.
|
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 el receptor, 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.
|
readwritenonatomicweak |
Es una vista para mostrar el progreso de la transmisión actual.
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.
|
readwritenonatomicweak |
Una etiqueta para mostrar la posición actual de la transmisión, en minutos y segundos.
Si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa actualmente, la etiqueta muestra una forma localizada de "--:--".
|
readwritenonatomicweak |
Una etiqueta para mostrar la duración actual de la transmisión, en minutos y segundos.
Si los medios cargados actualmente no tienen una duración (por ejemplo, si se trata de una transmisión en vivo), si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa en ese momento, la etiqueta mostrará el formato "--:--".
|
readwritenonatomicweak |
Es una etiqueta para mostrar el tiempo de transmisión restante (la duración menos la posición), en minutos y segundos.
Si los medios cargados actualmente no tienen una duración (por ejemplo, si se trata de una transmisión en vivo), si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa en ese momento, la etiqueta mostrará el formato "--:--".
|
readwritenonatomicstrong |
Un controlador de posición de transmisión.
Se usa como soporte para una posición de transmisión personalizada o una IU de búsqueda. Para obtener más información, consulta GCKUIStreamPositionController.
- Desde
- 3.4
|
readwritenonatomicstrong |
Un controlador de frecuencia de reproducción de transmisión
Para obtener más información, consulta GCKUIPlaybackRateController.
- Desde
- 4.0
|
readwritenonatomicassign |
Indica si el tiempo de transmisión restante se mostrará como un valor negativo, por ejemplo, "-1:23:45".
De forma predeterminada, esta propiedad se establece en YES.
|
readwritenonatomicassign |
Si los controles de posición de la transmisión (incluidos el control deslizante de la posición de la transmisión, la etiqueta de posición de la transmisión, la etiqueta de duración de la transmisión y la vista de progreso de la transmisión) deben ocultarse para el contenido en vivo.
El valor predeterminado es NO.
- Desde
- 4.0
|
readwritenonatomicweak |
Un botón para seleccionar pistas de audio o subtítulos.
Cuando se presiona el botón, se muestra al usuario la IU de selección de pistas multimedia. El botón se inhabilitará si el contenido multimedia cargado actualmente no tiene pistas multimedia seleccionables, si no hay contenido multimedia cargado actualmente o si no hay una sesión de transmisión activa.
|
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 de una película o el nombre del artista de una pista musical.
|
readwritenonatomicweak |
Una vista de indicador de actividad para indicar que el contenido multimedia se encuentra en estado de carga
|
readwritenonatomicweak |
Una etiqueta para mostrar el tiempo restante hasta que se pueda omitir el anuncio.
- Desde
- 4.3
|
readwritenonatomicweak |
Un botón para omitir el anuncio actual.
- Desde
- 4.3