Indicador de progresso de mídia

O componente indicador de progresso de mídia é exclusivo para apps de mídia.

O indicador de progresso é uma representação visual da duração e do tempo decorrido de reprodução de uma fonte de mídia. Ele aparece em apps de mídia durante a reprodução.


Anatomia

O indicador de progresso de mídia consiste em uma faixa inativa (exibida em cinza) que representa a duração da fonte de mídia e uma faixa ativa (com uma cor de destaque) que se sobrepõe à faixa inativa para indicar o tempo de reprodução decorrido.

Anatomia do indicador de progresso da mídia
1. Faixa ativa
2. Faixa inativa

O indicador de progresso da mídia pode ser linear ou circular.

Indicador de progresso de mídia linear

O indicador de progresso linear exibe a duração e o tempo decorrido em um eixo horizontal. A parte visível da faixa é centralizada em uma área de alvo de toque de 76 dp. Tocar ou arrastar o tempo decorrido permite que o usuário se mova para diferentes locais na fonte de mídia. O indicador de progresso de mídia linear é destinado a telas de 800 dp ou mais altas.

Anatomia do indicador de progressos circulares

O indicador de progresso circular mostra a duração e o tempo decorrido como um círculo. Não é possível tocar ou arrastar o tempo decorrido para ir a locais diferentes. O indicador de progresso de mídia circular foi feito para telas com menos de 800 dp de altura e para uso quando os controles de mídia estão minimizados.

Estados do indicador de progresso da mídia

Durante a reprodução, o indicador de progresso fica em um destes quatro estados:

  • Em reprodução:a mídia está sendo tocada, e a faixa ativa avança pela faixa inativa para indicar o tempo decorrido.
  • Pausada:o usuário pausou a reprodução. A faixa ativa ficará parada no ponto em que a reprodução for pausada.
  • Buffer:o app de música está carregando conteúdo para ser reproduzido. O indicador mostra uma linha branca que avança repetidamente na faixa inativa enquanto o conteúdo é carregado.
  • Erro:não é possível reproduzir a mídia. Não há faixas ativas, e a faixa inativa está desativada.
A faixa ativa avança pela faixa inativa conforme a mídia é tocada
Estado de reprodução: a faixa ativa avança pela faixa inativa conforme a mídia é tocada.
A faixa ativa fica parada enquanto o playbsck de mídia está pausado
Estado "Pausado": a faixa ativa fica parada enquanto a reprodução de mídia é pausada.
Uma linha branca avança repetidamente na faixa inativa enquanto o conteúdo é carregado.
Estado de armazenamento em buffer: uma linha branca avança repetidamente na faixa inativa enquanto o conteúdo é carregado.
A faixa inativa é desativada quando há um erro de reprodução do áudio de mídia Estado de erro: quando ocorre um erro de mídia, nenhuma faixa ativa é mostrada, e a inativa é desativada.

Especificações

Indicador de progresso de mídia linear

Linha vermelha do indicador de progresso de mídia linear

Indicador circular de progresso de mídia

Linha vermelha do indicador de progresso de mídia circular

Personalização

Durante a reprodução da mídia, a faixa ativa do indicador de progresso da mídia aparece usando uma cor de destaque. A cor de destaque padrão é um tom de azul. Em vez disso, os desenvolvedores de apps podem fornecer uma cor de destaque que reflita a marca da mídia. Da mesma forma, os OEMs podem fornecer uma cor de destaque que reflita a marca do carro. Se fornecida, uma cor de destaque do OEM tem precedência em relação à cor de destaque de um app.

Barra de progresso de mídia linear mostrando uma faixa ativa com cores de destaque padrão, de terceiros e do OEM.
O estilo padrão do indicador de progresso é um tom de azul. Os desenvolvedores de apps podem substituir o estilo padrão do app pela cor de destaque da própria marca (verde neste exemplo). Os OEMs também podem substituir o estilo padrão e o estilo do app pela cor de destaque da própria marca (laranja neste exemplo).
Barra de progresso de mídia circular mostrando uma faixa ativa usando cores de destaque padrão, de terceiros e de OEM
Exemplos de estilo de cor de destaque padrão, de apps e de OEM aplicados a um indicador de progresso circular

O guia de integração da biblioteca Car UI orienta o OEM sobre como personalizar componentes.

Para conferir orientações específicas sobre o uso de cores para personalizar componentes, acesse Cor.


Exemplos

Indicador de progresso de mídia linear em ação
Indicador de progresso de mídia linear na visualização de reprodução de app de música
Indicador circular de progresso de mídia em ação
Aqui, o indicador circular de progresso de mídia aparece no controle de reprodução minimizado. Ele se sobrepõe à tela da playlist.