借助 Transformer 演示应用,您可以试用 API 的功能并转换自己的媒体,包括在不同格式之间转换媒体、剪辑和应用视频特效。
本页介绍了如何获取、编译和运行演示版应用。本指南还介绍了如何使用演示版应用转换您自己的媒体。
获取代码
主演示版应用的源代码位于 GitHub 项目的 demos/transformer
文件夹中。如果尚未将项目克隆到本地目录,请执行此操作:
git clone https://github.com/androidx/media.git
接下来,在 Android Studio 中打开项目。您应该会在 Android Project 视图(演示版应用的相关文件夹已展开)中看到以下内容:
![Android Studio 中的项目](https://developer.android.google.cn/static/guide/topics/media/transformer/images/demo-project.png?authuser=6&hl=nl)
编译并运行演示
如需编译和运行演示版应用,请在 Android Studio 中选择并运行 demo-transformer
配置。演示版应用将在已连接的 Android 设备上安装并运行。如果可能,我们建议您使用实体设备,因为通常情况下,与真实设备相比,模拟器的 Android 媒体堆栈实现具有不同的功能和 bug。
![演示版应用配置 activity](https://developer.android.google.cn/static/guide/topics/media/transformer/images/configuration-activity.png?authuser=6&hl=nl)
该演示版应用以 ConfigurationActivity
开头,这是一个 activity,您可以在其中设置输入媒体项和要执行的转换。通过屏幕顶部的两个按钮,您可以从预设媒体文件列表中进行选择,也可以选择本地文件。接下来,您可以在可滚动的选项列表中配置输出格式和转换,还可以选择要应用于媒体的效果。点按最后一个按钮将过渡到 TransformerActivity
,这是一个 activity,用于在帧通过 Transformer 时显示当前进度和预览。转换完成后,输入和输出视频会一起显示在两个 ExoPlayer PlayerView
实例中。
转换您自己的内容
该演示版应用支持使用配置屏幕顶部的按钮选择要转换的媒体。您也可以直接在命令行中传递网址:
adb shell am start -a androidx.media3.demo.transformer.action.VIEW \ -d https://yourdomain.com/sample.mp4
MediaPipe 集成
该演示版应用包含与 MediaPipe 集成的示例。您需要手动构建依赖项,然后选择 withMediaPipe
build 变体,以便能够使用媒体管道框架处理器构建应用。如需查看完整说明,请参阅自述文件。配置 activity 中的效果选择器包含基于 MediaPipe 的示例效果,以供您试用。