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](https://developer.android.com/static/guide/topics/media/transformer/images/demo-project.png?authuser=9&hl=pt)
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](https://developer.android.com/static/guide/topics/media/transformer/images/configuration-activity.png?authuser=9&hl=pt)
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.