Artigo de Nevin Mital, publicado originalmente pelo Android Developers Blog. A tradução foi feita pela Redação iMasters com autorização.

***

O aplicativo Media Controller Test (MCT) é uma ferramenta poderosa que permite testar as complexidades da reprodução de mídia no Android, e ele acabou de ficar ainda mais útil. As experiências de mídia, incluindo interações por voz por meio do Google Assistant em telefones Android, carros, TVs e fones de ouvido, são fornecidas por APIs do Android MediaSession. Esta ferramenta ajudará você a verificar suas integrações.

Adicionamos agora um novo framework de testes de verificação que pode ser usado para ajudar a automatizar seu teste de controle de qualidade.

O MCT deve ser usado em conjunto com um aplicativo que implemente APIs de mídia, como o Universal Android Music Player. O MCT exibe informações sobre o MediaController do aplicativo de mídia, como PlaybackState e Metadata, e pode ser usado para testar controles de mídia entre aplicativos.

O Ciclo de Vida da Ação de Mídia pode ser complexo de seguir; mesmo em uma simples solicitação Reproduzir a Partir da Pesquisa, há muitas etapas intermediárias (linha do tempo simplificada descritas abaixo) em que algo pode dar errado. O MCT pode ser usado para ajudar a destacar quaisquer inconsistências no modo como seu aplicativo de música lida com as solicitações do MediaController TransportControl.

Anteriormente, o uso do MCT exigia muita interação manual e monitoramento. A nova estrutura de testes de verificação oferece testes de um clique que você pode executar para garantir que seu aplicativo de mídia responda corretamente a uma solicitação de reprodução.

Executando um teste de verificação

Para acessar os novos testes de verificação no MCT, clique no botão “Test” ao lado do aplicativo de mídia desejado.

A próxima tela mostra informações detalhadas sobre o MediaController, por exemplo, PlaybackState, Metadata e Queue. Existem dois botões na barra de ferramentas no canto superior direito: o botão à esquerda alterna entre os registros analíticos e formatados, e o botão à direita atualiza essa exibição para exibir as informações mais atuais.

Ao deslizar para a esquerda, você chega à visualização de testes de verificação, onde é possível ver uma lista rolável de testes definidos, um campo de texto para inserir uma consulta para testes que requerem um e uma seção para exibir os resultados do teste.

Como exemplo, para executar o teste Reproduzir a Partir da Pesquisa, você pode inserir uma consulta de pesquisa no campo de texto e clicar no botão “Executar Teste“. Parece que o teste foi bem sucedido!

Abaixo estão exemplos do Teste de Pausa e Buscar Para testar.

Android TV

O MCT agora também funciona na Android TV! Para que seu aplicativo de mídia funcione com a versão da MCT para Android TV, seu aplicativo de mídia deve ter uma implementação de MediaBrowserService. Por favor, clique aqui para mais detalhes sobre como fazer isso.

Ao iniciar o MCT na Android TV, você verá uma lista de aplicativos de mídia instalados. Observe que um aplicativo só aparecerá nesta lista se implementar o MediaBrowserService.

Ao selecionar um aplicativo, você será levado à tela de testes, que exibirá uma lista de testes de verificação à direita.

A execução de um teste preencherá o lado esquerdo da tela com informações selecionadas do MediaController. Para mais detalhes, por favor, verifique os logs MCT no Logcat.

Testes que exigem uma consulta são marcados com um ícone de teclado. Clicar em um desses testes abrirá um campo de entrada para a consulta. Ao apertar “Enter“, o teste será executado.

Para facilitar a entrada de texto, você também pode usar o comando ADB:

adb shell input text [query]

Observe que ‘% s’ adicionará um espaço entre as palavras. Por exemplo, o comando adb shell input text hello%sworld adicionará o texto “hello world” ao campo de entrada.

O que vem por aí?

O MCT atualmente inclui testes simples de ação de mídia única para as seguintes solicitações:

• Reproduzir
• Reproduzir a Partir da Pesquisa
• Reproduzir a Partir do ID da Mídia
• Reproduzir a Partir da URI
• Pausar
• Parar
• Pular para o Próximo
• Pular para o Anterior
• Ir para o Item da Fila
• Procurar

Para um aprofundamento técnico sobre como os testes são estruturados e como adicionar mais testes, visite o Wiki do MCT GitHub. Gostaríamos que você enviasse solicitações de pull com mais testes que você acha que são úteis e para qualquer correção de bugs. Por favor, certifique-se de rever o processo de contribuições para mais informações.

Confira as últimas atualizações no GitHub!

***

Este artigo é do Android Developers Blog. Ele foi escrito por Nevin Mital. A tradução foi feita pela Redação iMasters com autorização. Você pode acessar o original em: https://android-developers.googleblog.com/2018/08/verifying-your-google-assistant-media.html