L'application de démonstration Transformer vous permet de tester les fonctionnalités de l'API et de transformer vos propres contenus multimédias, y compris la conversion de contenus multimédias entre différents formats, le découpage et l'application d'effets vidéo.
Cette page explique comment obtenir, compiler et exécuter l'application de démonstration. Ce guide explique également comment utiliser l'application de démonstration pour transformer votre propre contenu multimédia.
Obtenir le code
Le code source de l'application de démonstration principale se trouve dans le dossier demos/transformer
du projet GitHub. Si vous ne l'avez pas déjà fait, clonez le projet dans un répertoire local:
git clone https://github.com/androidx/media.git
Ouvrez ensuite le projet dans Android Studio. Vous devriez voir ce qui suit dans la vue du projet Android (les dossiers correspondants de l'application de démonstration ont été développés):
![Le projet dans Android Studio](https://developer.android.google.cn/static/guide/topics/media/transformer/images/demo-project.png?authuser=6&hl=fr)
Compiler et exécuter la démonstration
Pour compiler et exécuter l'application de démonstration, sélectionnez et exécutez la configuration demo-transformer
dans Android Studio. L'application de démonstration sera installée et exécutée sur un appareil Android connecté. Nous vous recommandons d'utiliser un appareil physique si possible, car l'implémentation par un émulateur de la pile multimédia d'Android présente généralement des fonctionnalités et des bugs différents de ceux d'un appareil réel.
![Activité de configuration de l'application de démonstration](https://developer.android.google.cn/static/guide/topics/media/transformer/images/configuration-activity.png?authuser=6&hl=fr)
L'application de démonstration commence par ConfigurationActivity
, une activité dans laquelle vous pouvez configurer l'élément multimédia d'entrée et la transformation que vous souhaitez effectuer. Les deux boutons en haut de l'écran vous permettent de choisir parmi une liste de fichiers multimédias prédéfinis ou de choisir un fichier local. La liste déroulante d'options vous permet ensuite de configurer le format de sortie et les transformations, et de sélectionner les effets à appliquer au contenu multimédia. Lorsque l'utilisateur appuie sur le dernier bouton, il passe à TransformerActivity
, une activité qui affiche la progression actuelle et un aperçu des images lorsqu'elles passent par Transformer. Une fois la transformation terminée, les vidéos d'entrée et de sortie sont affichées ensemble dans deux instances ExoPlayer PlayerView
.
Transformer votre propre contenu
L'application de démonstration permet de sélectionner les contenus multimédias à transformer à l'aide des boutons situés en haut de l'écran de configuration. Vous pouvez également transmettre une URL directement via la ligne de commande:
adb shell am start -a androidx.media3.demo.transformer.action.VIEW \ -d https://yourdomain.com/sample.mp4
Intégration de MediaPipe
L'application de démonstration inclut un exemple d'intégration avec MediaPipe. Vous devez créer la dépendance manuellement, puis sélectionner la variante de compilation withMediaPipe
pour pouvoir compiler l'application avec le processeur de frames du pipeline multimédia. Consultez le fichier README pour obtenir des instructions complètes. Le sélecteur d'effets de l'activité de configuration inclut un exemple d'effet basé sur MediaPipe qui permet de tester cela.