演示应用

借助 Transformer 演示应用,您可以试用 API 的功能并转换自己的媒体,包括在不同格式之间转换媒体、剪辑和应用视频特效。

本页介绍了如何获取、编译和运行演示版应用。本指南还介绍了如何使用演示版应用转换您自己的媒体。

获取代码

主演示版应用的源代码位于 GitHub 项目demos/transformer 文件夹中。如果尚未将项目克隆到本地目录,请执行此操作:

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

接下来,在 Android Studio 中打开项目。您应该会在 Android Project 视图(演示版应用的相关文件夹已展开)中看到以下内容:

Android Studio 中的项目
Android Studio 中的项目

编译并运行演示

如需编译和运行演示版应用,请在 Android Studio 中选择并运行 demo-transformer 配置。演示版应用将在已连接的 Android 设备上安装并运行。如果可能,我们建议您使用实体设备,因为通常情况下,与真实设备相比,模拟器的 Android 媒体堆栈实现具有不同的功能和 bug。

演示版应用配置 activity
演示版应用配置 activity

该演示版应用以 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 的示例效果,以供您试用。