Classe GCKUIMediaController

Referência de classe GCKUIMediaController

Informações gerais

Um controlador para visualizações de interface que são usados para controlar ou exibir o status da reprodução de mídia em um receptor do Cast.

O aplicativo de chamada registra os controles de IU relacionados à mídia com o controlador definindo as propriedades adequadas. Em seguida, o controlador responde a eventos de toque nos controles emitindo os comandos de mídia adequados ao receptor e atualiza os controles com base nas informações de status e nos metadados de mídia recebidos do receptor. O controlador ativa e desativa automaticamente os controles de interface de usuário conforme apropriado para a sessão atual e o estado do player de mídia. Além disso, ele desativa todos os controles enquanto uma solicitação está em andamento.

Consulte GCKUIMediaControllerDelegate para ver o protocolo delegado.

Como
3,0

Herda o NSObject.

Resumo do método de instância

(instancetype) - init
 Inicializa uma instância. Mais...
 
(void) - bindLabel:toMetadataKey:
 Vincula um UILabel a uma chave de metadados. Mais...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Vincula um UILabel a uma chave de metadados. Mais...
 
(void) - bindTextView:toMetadataKey:
 Vincula uma UITextView a uma chave de metadados. Mais...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Vincula uma UITextView a uma chave de metadados. Mais...
 
(void) - bindImageView:toImageHints:
 Vincula uma UIImageView a uma instância GCKUIImageHints. Mais...
 
(void) - bindControlView:toRewindForTime:
 Vincula um UIControl para retroceder a reprodução do item atual pelo valor transmitido como segundos. Mais...
 
(void) - bindControlView:toForwardForTime:
 Vincula um UIControl para encaminhar a reprodução do item atual pelo valor transmitido como segundos. Mais...
 
(void) - unbindView:
 Desvincula a visualização especificada. Mais...
 
(void) - unbindAllViews
 Desvincula todas as visualizações vinculadas. Mais...
 
(GCKMediaRepeatMode- cycleRepeatMode
 Altera o modo de repetição da fila para o próximo modo do ciclo: Mais...
 
(void) - selectTracks
 Um método de conveniência para exibir a interface de seleção de faixa de mídia. Mais...
 
(void) - skipAd
 Envia e monitora a solicitação de pular anúncio. Mais...
 

Resumo da propriedade

id< GCKUIMediaControllerDelegatedelegate
 O delegado para receber notificações do GCKUIMediaController. Mais...
 
GCKSessionsession
 A sessão associada a este controlador. Mais...
 
BOOL mediaLoaded
 Se há mídia carregada no momento (ou carregando) no receptor. Mais...
 
BOOL hasCurrentQueueItem
 Se há um item atual na fila. Mais...
 
BOOL hasLoadingQueueItem
 Se há um item sendo pré-carregado na fila. Mais...
 
GCKMediaPlayerState lastKnownPlayerState
 O estado mais recente conhecido do player de mídia. Mais...
 
NSTimeInterval lastKnownStreamPosition
 A posição mais recente conhecida do stream de mídia. Mais...
 
UIButton * playButton
 Um botão "reproduzir". Mais...
 
UIButton * pauseButton
 Um botão "pausar". Mais...
 
GCKUIMultistateButtonplayPauseToggleButton
 Um botão de alternância "reproduzir/pausar". Mais...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Um controlador de alternância "reproduzir/pausar". Mais...
 
UIButton * stopButton
 Um botão "parar". Mais...
 
UIButton * forward30SecondsButton
 Um botão para buscar 30 segundos à frente no item de mídia em reprodução. Mais...
 
UIButton * rewind30SecondsButton
 Um botão para buscar 30 segundos de volta no item de mídia em reprodução no momento. Mais...
 
UIButton * pauseQueueButton
 Um botão para pausar a reprodução da fila quando a reprodução do item atual terminar. Mais...
 
UIButton * nextButton
 Um botão "Próxima". Mais...
 
UIButton * previousButton
 Um botão "anterior". Mais...
 
GCKUIMultistateButtonrepeatModeButton
 Um botão para alternar entre os modos de repetição da fila disponíveis. Mais...
 
UISlider * streamPositionSlider
 Um controle deslizante para exibir e mudar a posição atual do stream. Mais...
 
UIProgressView * streamProgressView
 Uma visualização para exibir o progresso do stream atual. Mais...
 
UILabel * streamPositionLabel
 É um rótulo para exibir a posição atual do stream, em minutos e segundos. Mais...
 
UILabel * streamDurationLabel
 É um rótulo para exibir a duração atual do stream, em minutos e segundos. Mais...
 
UILabel * streamTimeRemainingLabel
 Um rótulo para exibir o tempo restante de transmissão (a duração menos a posição), em minutos e segundos. Mais...
 
GCKUIStreamPositionControllerstreamPositionController
 Um controlador de posição de stream. Mais...
 
GCKUIPlaybackRateControllerplaybackRateController
 Um controlador da taxa de reprodução de streaming. Mais...
 
BOOL displayTimeRemainingAsNegativeValue
 Se o tempo de transmissão restante será exibido como um valor negativo (por exemplo, "-1:23:45"). Mais...
 
BOOL hideStreamPositionControlsForLiveContent
 Define se os controles de posição do stream (incluindo o controle deslizante de posição, o rótulo de posição, o rótulo de duração e a visualização de progresso do stream) precisam ficar ocultos para o conteúdo ao vivo. Mais...
 
UIButton * tracksButton
 Um botão para selecionar faixas de áudio e/ou closed captions ou legendas. Mais...
 
UILabel * smartSubtitleLabel
 Um rótulo para exibir um subtítulo para a mídia carregada no momento. Mais...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Uma visualização indicadora de atividade para indicar que a mídia está em um estado de carregamento. Mais...
 
UILabel * skipAdLabel
 Um rótulo para exibir o tempo restante até que o anúncio possa ser ignorado. Mais...
 
UIButton * skipAdButton
 Um botão para pular o anúncio atual. Mais...
 

Detalhes dos métodos

- (instancetype) init

Inicializa uma instância.

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

Vincula um UILabel a uma chave de metadados.

A visualização mostra o valor atual do campo de metadados correspondente.

Consulte GCKMediaMetadata para ver uma lista de chaves de metadados predefinidas.

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

Vincula um UILabel a uma chave de metadados.

A visualização mostra o valor atual do campo de metadados correspondente.

Consulte GCKMediaMetadata para ver uma lista de chaves de metadados 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 uma UITextView a uma chave de metadados.

A visualização mostra o valor atual do campo de metadados correspondente.

Consulte GCKMediaMetadata para ver uma lista de chaves de metadados predefinidas.

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

Vincula uma UITextView a uma chave de metadados.

A visualização mostra o valor atual do campo de metadados correspondente.

Consulte GCKMediaMetadata para ver uma lista de chaves de metadados 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 uma UIImageView a uma instância GCKUIImageHints.

O GCKUIImagePicker instalado será usado para selecionar uma imagem dos metadados para a visualização.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) bindControlView: (UIControl *)  control
toRewindForTime: (NSTimeInterval)  rewindSeconds 

Vincula um UIControl para retroceder a reprodução do item atual pelo valor transmitido como segundos.

A visualização vai ser atualizada com base no estado GCKCastSession, da reprodução remota e se é uma transmissão ao vivo. Um destino também é adicionado ao UIControl para capturar o evento UIControlEventTouchUpInside. Não adicione um destino desse tipo ao UIControl. Para capturar o evento, use os métodos GCKUIMediaControllerDelegate.

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
rewindSecondsThe number of seconds to rewind the media.
- (void) bindControlView: (UIControl *)  control
toForwardForTime: (NSTimeInterval)  forwardSeconds 

Vincula um UIControl para encaminhar a reprodução do item atual pelo valor transmitido como segundos.

A visualização vai ser atualizada com base no estado GCKCastSession, da reprodução remota e se é uma transmissão ao vivo. Um destino também é adicionado ao UIControl para capturar o evento UIControlEventTouchUpInside. Não adicione um destino desse tipo ao UIControl. Para capturar o evento, use os métodos GCKUIMediaControllerDelegate.

Parameters
controlThe UI element that the user interacts with. Typically this would be an instance of UIButton.
forwardSecondsThe number of seconds to skip the media.
- (void) unbindView: (UIView *)  view

Desvincula a visualização especificada.

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Desvincula todas as visualizações vinculadas.

- (GCKMediaRepeatMode) cycleRepeatMode

Altera o modo de repetição da fila para o próximo modo do ciclo:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Retorna
O novo modo de repetição.
- (void) selectTracks

Um método de conveniência para exibir a interface de seleção de faixa de mídia.

- (void) skipAd

Envia e monitora a solicitação de pular anúncio.

Como
4,3

Detalhe da propriedade

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

O delegado para receber notificações do GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

A sessão associada a este controlador.

- (BOOL) mediaLoaded
readnonatomicassign

Se há mídia carregada no momento (ou carregando) no receptor.

Se nenhuma sessão de transmissão estiver ativa, o valor será NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Se há um item atual na fila.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Se há um item sendo pré-carregado na fila.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

O estado mais recente conhecido do player de mídia.

Se nenhuma sessão de transmissão estiver ativa, este será o estado do player pouco antes do fim da última sessão. Se não houver uma sessão anterior, o valor será GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

A posição mais recente conhecida do stream de mídia.

Se nenhuma sessão de transmissão estiver ativa, esta será a posição de streaming da mídia pouco antes do fim da última sessão. Se não houver uma sessão anterior, o valor será kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Um botão "reproduzir".

Ao tocar no botão, a reprodução da mídia carregada no momento é iniciada ou retomada no receptor. O botão será desativado se a reprodução já estiver em andamento, se não houver mídia carregada no momento ou se não houver nenhuma sessão de transmissão ativa no momento.

- (UIButton*) pauseButton
readwritenonatomicweak

Um botão "pausar".

Quando o usuário toca no botão, a reprodução da mídia carregada no momento é pausada no receptor. O botão será desativado se a mídia carregada no momento não for compatível com pausa, se a reprodução não estiver em andamento, se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (GCKUIMultistateButton*) playPauseToggleButton
readwritenonatomicweak

Um botão de alternância "reproduzir/pausar".

O autor da chamada precisa definir os ícones adequados para os estados do botão GCKUIButtonStatePlay, GCKUIButtonStatePlayLive e GCKUIButtonStatePause, ou seja, um ícone "pausar" para o estado de reprodução, um ícone "parar" para o estado de reprodução ao vivo e um ícone "reproduzir" para o estado de pausa. O estado do botão é atualizado automaticamente para refletir o estado atual da reprodução no receptor. Quando o usuário toca no botão, a reprodução da mídia carregada no momento é pausada ou retomada no receptor. O botão será desativado se a mídia carregada no momento não for compatível com pausa, se a reprodução não estiver em andamento ou pausada, se não houver mídia carregada no momento ou se não houver nenhuma sessão de transmissão ativa no momento.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Um controlador de alternância "reproduzir/pausar".

Usado como substituto para uma interface de alternância personalizada para reproduzir/pausar fornecida pelo aplicativo. Consulte GCKUIPlayPauseToggleController para ver detalhes.

Como
3,4
- (UIButton*) stopButton
readwritenonatomicweak

Um botão "parar".

Quando o usuário toca no botão, a reprodução da mídia carregada no momento é interrompida no receptor. O botão será desativado se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UIButton*) forward30SecondsButton
readwritenonatomicweak

Um botão para buscar 30 segundos à frente no item de mídia em reprodução.

O botão será desativado se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UIButton*) rewind30SecondsButton
readwritenonatomicweak

Um botão para buscar 30 segundos de volta no item de mídia em reprodução no momento.

O botão será desativado se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Um botão para pausar a reprodução da fila quando a reprodução do item atual terminar.

- (UIButton*) nextButton
readwritenonatomicweak

Um botão "Próxima".

Ao tocar no botão, a reprodução passa para o próximo item de mídia na fila. O botão será desativado se a operação não for compatível, se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UIButton*) previousButton
readwritenonatomicweak

Um botão "anterior".

Ao tocar no botão, a reprodução vai para o item de mídia anterior na fila. O botão será desativado se a operação não for compatível, se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (GCKUIMultistateButton*) repeatModeButton
readwritenonatomicweak

Um botão para alternar entre os modos de repetição da fila disponíveis.

Consulte GCKMediaRepeatMode. O autor da chamada precisa definir ícones adequados para os estados GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll e GCKUIButtonStateShuffle do botão. O estado do botão é atualizado automaticamente para refletir o modo de repetição da fila atual no receptor. Tocar no botão alterna para o próximo modo de repetição, na ordem:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

O botão será desativado se não houver uma sessão de transmissão ativa no momento.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

Um controle deslizante para exibir e mudar a posição atual do stream.

Quando o valor do controle deslizante é modificado pelo usuário, a posição do stream da mídia carregada no momento é atualizada no receptor. Enquanto a reprodução da mídia está em andamento no receptor, o valor do controle deslizante é atualizado em tempo real para refletir a posição atual do stream. O controle deslizante será desativado se a mídia carregada no momento não for compatível com a busca, se não houver nenhuma mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Uma visualização para exibir o progresso do stream atual.

Enquanto a reprodução de mídia está em andamento no receptor, o valor das visualizações é atualizado em tempo real para refletir a posição atual do stream. A visualização será desativada se a mídia carregada no momento for uma transmissão ao vivo, se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

É um rótulo para exibir a posição atual do stream, em minutos e segundos.

Se não houver mídia carregada no momento ou se não houver sessão de transmissão ativa no momento, o rótulo exibirá uma forma localizada de "--:--".

- (UILabel*) streamDurationLabel
readwritenonatomicweak

É um rótulo para exibir a duração atual do stream, em minutos e segundos.

Se a mídia carregada no momento não tiver uma duração (por exemplo, se for uma transmissão ao vivo), se não houver mídia carregada no momento ou se não houver uma sessão de transmissão ativa no momento, o rótulo vai exibir uma forma localizada de "--:--".

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Um rótulo para exibir o tempo restante de transmissão (a duração menos a posição), em minutos e segundos.

Se a mídia carregada no momento não tiver uma duração (por exemplo, se for uma transmissão ao vivo), se não houver mídia carregada no momento ou se não houver uma sessão de transmissão ativa no momento, o rótulo vai exibir uma forma localizada de "--:--".

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

Um controlador de posição de stream.

Usado como substituto para uma posição de stream e/ou interface de busca personalizada e fornecida pelo aplicativo. Consulte GCKUIStreamPositionController para ver detalhes.

Como
3,4
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

Um controlador da taxa de reprodução de streaming.

Consulte GCKUIPlaybackRateController para ver detalhes.

Como
4,0
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Se o tempo de transmissão restante será exibido como um valor negativo (por exemplo, "-1:23:45").

Por padrão, essa propriedade é definida como YES.

- (BOOL) hideStreamPositionControlsForLiveContent
readwritenonatomicassign

Define se os controles de posição do stream (incluindo o controle deslizante de posição, o rótulo de posição, o rótulo de duração e a visualização de progresso do stream) precisam ficar ocultos para o conteúdo ao vivo.

O valor padrão é NO.

Como
4,0
- (UIButton*) tracksButton
readwritenonatomicweak

Um botão para selecionar faixas de áudio e/ou closed captions ou legendas.

Quando o usuário toca no botão, a interface de seleção de faixas de mídia é mostrada ao usuário. O botão será desativado se a mídia carregada no momento não tiver faixas selecionáveis, se não houver mídia carregada no momento ou se não houver uma sessão de transmissão ativa no momento.

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

Um rótulo para exibir um subtítulo para a mídia carregada no momento.

Se não houver um campo de legenda definido explicitamente nos metadados, a gravadora exibirá o campo de metadados mais adequado com base no tipo de mídia, por exemplo, o nome do estúdio de um filme ou o nome do artista para uma música.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Uma visualização indicadora de atividade para indicar que a mídia está em um estado de carregamento.

- (UILabel*) skipAdLabel
readwritenonatomicweak

Um rótulo para exibir o tempo restante até que o anúncio possa ser ignorado.

Como
4,3
- (UIButton*) skipAdButton
readwritenonatomicweak

Um botão para pular o anúncio atual.

Como
4,3