Mit der Transformer-Demo-App können Sie die Funktionen der API testen und Ihre eigenen Medien transformieren. Sie können unter anderem Medien in andere Formate konvertieren, zuschneiden und Videoeffekte anwenden.
Auf dieser Seite wird beschrieben, wie Sie die Demo-App abrufen, kompilieren und ausführen. Außerdem wird beschrieben, wie Sie mit der Demo-App Ihre eigenen Medien transformieren können.
Code abrufen
Den Quellcode für die Haupt-Demo-App finden Sie im Ordner demos/transformer
des GitHub-Projekts. Falls noch nicht geschehen, klonen Sie das Projekt in ein lokales Verzeichnis:
git clone https://github.com/androidx/media.git
Öffnen Sie dann das Projekt in Android Studio. In der Android-Projektansicht sollten Sie Folgendes sehen (die relevanten Ordner der Demo-App wurden maximiert):
![Das Projekt in Android Studio](https://developer.android.com/static/guide/topics/media/transformer/images/demo-project.png?authuser=9&hl=de)
Kompilieren Sie die Demo und führen Sie sie aus.
Wählen Sie die demo-transformer
-Konfiguration in Android Studio aus, um die Demo-App zu kompilieren und auszuführen. Die Demo-App wird auf einem verbundenen Android-Gerät installiert und ausgeführt. Wir empfehlen, nach Möglichkeit ein physisches Gerät zu verwenden, da die Implementierung des Android-Medienstacks in einem Emulator normalerweise andere Funktionen und Fehler aufweist als ein echtes Gerät.
![Demo-App-Konfigurationsaktivität](https://developer.android.com/static/guide/topics/media/transformer/images/configuration-activity.png?authuser=9&hl=de)
Die Demo-App beginnt mit ConfigurationActivity
. Dies ist eine Aktivität, in der Sie das Eingabemedienelement und die durchzuführende Transformation einrichten können. Mit den beiden Schaltflächen oben auf dem Bildschirm können Sie aus einer Liste voreingestellter Mediendateien oder einer lokalen Datei auswählen. In der scrollbaren Liste mit Optionen können Sie das Ausgabeformat und die Transformationen konfigurieren. Außerdem können Sie Effekte auswählen, die auf die Medien angewendet werden sollen. Durch Tippen auf die letzte Schaltfläche wechselt die Aktivität zu TransformerActivity
. Diese Aktivität zeigt den aktuellen Fortschritt und eine Vorschau der Frames an, während diese den Transformer durchlaufen. Nach Abschluss der Transformation werden die Eingabe- und Ausgabevideos gemeinsam in zwei ExoPlayer-PlayerView
-Instanzen angezeigt.
Eigene Inhalte transformieren
Die Demo-App unterstützt die Auswahl von Medien für die Transformation über die Schaltflächen oben auf dem Konfigurationsbildschirm. Sie können eine URL auch direkt in der Befehlszeile übergeben:
adb shell am start -a androidx.media3.demo.transformer.action.VIEW \ -d https://yourdomain.com/sample.mp4
MediaPipe-Integration
Die Demo-App enthält eine Beispielintegration mit MediaPipe. Sie müssen die Abhängigkeit manuell erstellen und dann die Build-Variante withMediaPipe
auswählen, um die Erstellung der App mit dem Media Pipe-Frame-Prozessor zu ermöglichen. Eine vollständige Anleitung finden Sie in der Readme-Datei. Die Effektauswahl in der Konfigurationsaktivität enthält ein Beispiel für einen MediaPipe-basierten Effekt, um dies auszuprobieren.