Visão geral
Um controlador para visualizações de IU usadas para controlar ou exibir o status da reprodução de mídia em um receptor do Cast.
O aplicativo que faz a chamada registra os controles de IU relacionados à mídia com o controlador definindo as propriedades apropriadas. Em seguida, o controlador responde a eventos de toque nos controles emitindo os comandos de mídia apropriados para o 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 da IU conforme apropriado para a sessão atual e o estado do player de mídia. Ele também desativa todos os controles enquanto uma solicitação está em andamento.
Consulte GCKUIMediaControllerDelegate para ver o protocolo de delegação.
- Since
- 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) | - 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 no ciclo: Mais... | |
| (void) | - selectTracks |
| Um método prático para exibir a IU de seleção da faixa de mídia. Mais... | |
Resumo da propriedade | |
| id< GCKUIMediaControllerDelegate > | delegate |
| O delegado para recebimento de notificações de GCKUIMediaController. Mais... | |
| GCKSession * | session |
| A sessão associada a esse controlador. Mais... | |
| BOOL | mediaLoaded |
| Se há mídia atualmente carregada (ou carregando) no receptor. Mais... | |
| BOOL | hasCurrentQueueItem |
| Indica se há um item na fila. Mais... | |
| BOOL | hasLoadingQueueItem |
| Indica se há um item sendo pré-carregado na fila. Mais... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| O estado mais recente do player de mídia conhecido. Mais... | |
| NSTimeInterval | lastKnownStreamPosition |
| A posição mais recente do fluxo de mídia conhecida. Mais... | |
| UIButton * | playButton |
| Um botão "Reproduzir". Mais... | |
| UIButton * | pauseButton |
| Um botão "pausar". Mais... | |
| GCKUIButton * | playPauseToggleButton |
| Um botão "Reproduzir/pausar". Mais... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Um controle "alternar/pausar". Mais... | |
| UIButton * | stopButton |
| Um botão "Parar". Mais... | |
| GCKUIButton * | forward30SecondsButton |
| Um botão para avançar 30 segundos no item de mídia em reprodução. Mais... | |
| GCKUIButton * | rewind30SecondsButton |
| Um botão para buscar 30 segundos no item de mídia em reprodução. Mais... | |
| UIButton * | pauseQueueButton |
| Um botão para pausar a reprodução da fila quando o item atual for reproduzido. Mais... | |
| UIButton * | nextButton |
| Um botão "Próxima". Mais... | |
| UIButton * | previousButton |
| Um botão "anterior". Mais... | |
| GCKUIButton * | repeatModeButton |
| Um botão para navegar pelos modos de repetição de fila disponíveis. Mais... | |
| UISlider * | streamPositionSlider |
| Um controle deslizante para exibir e alterar a posição atual do stream. Mais... | |
| UIProgressView * | streamProgressView |
| Uma visualização para exibir o progresso atual do stream. 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 da transmissão (a duração menos a posição), em minutos e segundos. Mais... | |
| GCKUIStreamPositionController * | streamPositionController |
| Um controlador de posição de stream. Mais... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Se o tempo restante da transmissão aparece como um valor negativo, por exemplo, "-1:23:45". Mais... | |
| UIButton * | tracksButton |
| Um botão para selecionar faixas de áudio e/ou legendas ou closed captions. Mais... | |
| UILabel * | smartSubtitleLabel |
| Um rótulo para exibir um subtítulo da mídia carregada no momento. Mais... | |
| UIActivityIndicatorView * | mediaLoadingIndicator |
| Visualização do indicador de atividade que indica o estado de carregamento da mídia. 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
-
label The UILabel that will display the value. key The 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
-
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 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
-
textView The UITextView that will display the value. key The 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
-
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 uma UIImageView a uma instância GCKUIImageHints.
O UIImagePicker instalado atualmente será usado para selecionar uma imagem dos metadados para a visualização.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) unbindView: | (UIView *) | view |
Desvincula a visualização especificada.
- Parameters
-
view The 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 no ciclo:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Retorna
- O novo modo de repetição.
| - (void) selectTracks |
Um método prático para exibir a IU de seleção da faixa de mídia.
Detalhes da propriedade
|
readwritenonatomicweak |
O delegado para recebimento de notificações de GCKUIMediaController.
|
readnonatomicstrong |
A sessão associada a esse controlador.
|
readnonatomicassign |
Se há mídia atualmente carregada (ou carregando) no receptor.
Se nenhuma sessão de transmissão estiver ativa, o valor será NO.
|
readnonatomicassign |
Indica se há um item na fila.
|
readnonatomicassign |
Indica se há um item sendo pré-carregado na fila.
|
readnonatomicassign |
O estado mais recente do player de mídia conhecido.
Se nenhuma sessão de transmissão estiver ativa, esse será o estado do player um pouco antes do fim da última sessão. Se não houver sessão anterior, será GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
A posição mais recente do fluxo de mídia conhecida.
Se nenhuma sessão de transmissão estiver ativa, essa será a posição de stream da mídia antes do término da última sessão. Se não houver sessão anterior, será kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Um botão "Reproduzir".
Quando o botão é tocado, 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 nenhuma mídia carregada no momento ou se não houver sessão do Google Cast ativa no momento.
|
readwritenonatomicweak |
Um botão "pausar".
Quando o usuário toca no botão, a mídia carregada no momento é pausada no receptor. O botão será desativado se a mídia carregada no momento não oferecer suporte à pausa, se a reprodução não estiver em andamento, se nenhuma mídia estiver carregada ou se não houver uma sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão "Reproduzir/pausar".
O autor da chamada precisa definir ícones adequados para os estados GCKUIControlStatePlay e GCKUIControlStatePause do botão, ou seja, um ícone "pausar" para o estado de reprodução e um ícone "reproduzir" para o estado de pausa. O estado do botão é atualizado automaticamente para refletir o estado de reprodução atual no receptor. Quando o usuário toca no botão, a mídia carregada atualmente é pausada ou retomada no receptor. O botão será desativado se a mídia carregada no momento não for compatível com a pausa, se a reprodução não estiver em andamento ou pausada, se nenhuma mídia estiver carregada ou se não houver uma sessão de transmissão ativa.
|
readwritenonatomicstrong |
Um controle "alternar/pausar".
Usado como substituto para uma IU personalizada de reprodução/pausa fornecida pelo aplicativo. Consulte GCKUIPlayPauseToggleController para ver detalhes.
- Since
- 3,4
|
readwritenonatomicweak |
Um botão "Parar".
Quando o usuário toca no botão, a mídia carregada atualmente é interrompida no receptor. O botão será desativado se não houver nenhuma mídia carregada no momento ou se não houver sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão para avançar 30 segundos no item de mídia em reprodução.
O botão será desativado se não houver nenhuma mídia carregada no momento ou se não houver sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão para buscar 30 segundos no item de mídia em reprodução.
O botão será desativado se não houver nenhuma mídia carregada no momento ou se não houver sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão para pausar a reprodução da fila quando o item atual for reproduzido.
|
readwritenonatomicweak |
Um botão "Próxima".
Quando o usuário toca no botão, a reprodução vai 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 nenhuma mídia for carregada ou se não houver uma sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão "anterior".
Quando o usuário toca 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 nenhuma mídia for carregada ou se não houver uma sessão de transmissão ativa.
|
readwritenonatomicweak |
Um botão para navegar pelos modos de repetição de fila disponíveis.
Consulte GCKMediaRepeatMode. O estado do botão é atualizado automaticamente para refletir o modo de repetição de fila atual no receptor. Ao tocar no botão, você passa para o próximo modo de repetição, na ordem:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
O botão será desativado se não houver sessão de transmissão ativa.
|
readwritenonatomicweak |
Um controle deslizante para exibir e alterar a posição atual do stream.
Quando o valor do controle deslizante é alterado pelo usuário, a posição do stream da mídia carregada no momento é atualizada no receptor. Enquanto a reprodução de 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 oferecer suporte à busca, se nenhuma mídia estiver carregada ou se não houver uma sessão de transmissão ativa no momento.
|
readwritenonatomicweak |
Uma visualização para exibir o progresso atual do stream.
Enquanto a reprodução da 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 nenhuma mídia estiver carregada ou se não houver uma sessão de transmissão ativa.
|
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 uma sessão do Google Cast ativa, o rótulo exibirá um formulário localizado de "--:--".
|
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 nenhuma mídia estiver carregada no momento ou se não houver sessão de transmissão ativa no momento, o rótulo exibirá um formulário localizado de "--:--".
|
readwritenonatomicweak |
Um rótulo para exibir o tempo restante da 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 nenhuma mídia estiver carregada no momento ou se não houver sessão de transmissão ativa no momento, o rótulo exibirá um formulário localizado de "--:--".
|
readwritenonatomicstrong |
Um controlador de posição de stream.
Usado como substituto para uma posição de stream personalizada e fornecida pelo aplicativo e/ou para IU de busca. Consulte GCKUIStreamPositionController para ver detalhes.
- Since
- 3,4
|
readwritenonatomicassign |
Se o tempo restante da transmissão aparece como um valor negativo, por exemplo, "-1:23:45".
Por padrão, essa propriedade é definida como YES.
|
readwritenonatomicweak |
Um botão para selecionar faixas de áudio e/ou legendas ou closed captions.
Quando o usuário toca no botão, a mídia rastreia a IU de seleção. O botão será desativado se a mídia carregada no momento não tiver faixas de mídia selecionáveis, se não houver nenhuma mídia carregada no momento ou se não houver uma sessão do Google Cast ativa no momento.
|
readwritenonatomicweak |
Um rótulo para exibir um subtítulo da 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 apropriado com base no tipo de mídia, por exemplo, o nome do estúdio para um filme ou o nome do artista para uma faixa de música.
|
readwritenonatomicweak |
Visualização do indicador de atividade que indica o estado de carregamento da mídia.