Aplicativo de demonstração do Transformer

Com o app de demonstração Transformer, você pode testar os recursos da API e transformar sua própria mídia, incluindo a conversão de mídia entre formatos, o corte e a aplicação de efeitos de vídeo.

Esta página descreve como instalar, compilar e executar o app de demonstração. Ele também descreve como usar esse app para transformar sua própria mídia.

Acessar o código

O código-fonte do app de demonstração principal pode ser encontrado na pasta demos/transformer do projeto do GitHub. Se ainda não tiver feito isso, clone o projeto em um diretório local:

git clone https://github.com/androidx/media.git

Em seguida, abra o projeto no Android Studio. Você vai ver o seguinte na visualização Android Project. As pastas relevantes do app de demonstração foram expandidas:

O projeto no Android Studio
O projeto no Android Studio

Compile e execute a demonstração

Para compilar e executar o app de demonstração, selecione e execute a configuração demo-transformer no Android Studio. O app de demonstração será instalado e executado em um dispositivo Android conectado. Recomendamos usar um dispositivo físico, se possível, porque normalmente a implementação da pilha de mídia do Android por um emulador tem recursos e bugs diferentes em comparação com um dispositivo real.

Atividade de configuração do app de demonstração
Atividade de configuração do app de demonstração

O app de demonstração começa com ConfigurationActivity, uma atividade em que você pode configurar o item de mídia de entrada e a transformação que quer realizar. Os dois botões na parte superior da tela permitem escolher em uma lista de arquivos de mídia predefinidos ou selecionar um arquivo local. Em seguida, a lista rolável de opções permite configurar o formato de saída e as transformações, além de selecionar efeitos para aplicar à mídia. Tocar no último botão faz a transição para TransformerActivity, uma atividade que mostra o progresso atual e uma visualização dos frames à medida que eles passam pelo Transformer. Quando a transformação é concluída, os vídeos de entrada e saída são mostrados juntos em duas instâncias PlayerView do ExoPlayer.

Transforme seu conteúdo

O app de demonstração oferece suporte à seleção de mídia para transformação usando os botões na parte de cima da tela de configuração. Também é possível transmitir um URL diretamente na linha de comando:

adb shell am start -a androidx.media3.demo.transformer.action.VIEW \
    -d https://yourdomain.com/sample.mp4

Integração com o MediaPipe

O app de demonstração inclui um exemplo de integração com o MediaPipe. Você vai precisar criar a dependência manualmente e selecionar a variante de build withMediaPipe para permitir a criação do app com o processador de frames do pipe de mídia. Consulte o README para conferir as instruções completas. O seletor de efeitos na atividade de configuração inclui um exemplo de efeito baseado no MediaPipe para testar isso.