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< GCKUIMediaControllerDelegate > | delegate |
| O delegado para receber notificações do GCKUIMediaController. Mais... | |
| GCKSession * | session |
| 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... | |
| GCKUIMultistateButton * | playPauseToggleButton |
| Um botão de alternância "reproduzir/pausar". Mais... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| 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... | |
| GCKUIMultistateButton * | repeatModeButton |
| 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... | |
| GCKUIStreamPositionController * | streamPositionController |
| Um controlador de posição de stream. Mais... | |
| GCKUIPlaybackRateController * | playbackRateController |
| 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
-
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 GCKUIImagePicker instalado 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) 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
-
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 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
-
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 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 do ciclo:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- 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
|
readwritenonatomicweak |
O delegado para receber notificações do GCKUIMediaController.
|
readnonatomicstrong |
A sessão associada a este controlador.
|
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.
|
readnonatomicassign |
Se há um item atual na fila.
|
readnonatomicassign |
Se há um item sendo pré-carregado na fila.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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
|
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.
|
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.
|
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.
|
readwritenonatomicweak |
Um botão para pausar a reprodução da fila quando a reprodução do item atual terminar.
|
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.
|
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.
|
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:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
O botão será desativado se não houver uma sessão de transmissão ativa no momento.
|
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.
|
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.
|
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 "--:--".
|
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 "--:--".
|
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 "--:--".
|
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
|
readwritenonatomicstrong |
Um controlador da taxa de reprodução de streaming.
Consulte GCKUIPlaybackRateController para ver detalhes.
- Como
- 4,0
|
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.
|
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
|
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.
|
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.
|
readwritenonatomicweak |
Uma visualização indicadora de atividade para indicar que a mídia está em um estado de carregamento.
|
readwritenonatomicweak |
Um rótulo para exibir o tempo restante até que o anúncio possa ser ignorado.
- Como
- 4,3
|
readwritenonatomicweak |
Um botão para pular o anúncio atual.
- Como
- 4,3