Transformer 使用入门包括以下步骤：
- 在项目中将 Media3 Transformer 添加为依赖项。
- 构建一个
EditedMediaItem，用于表示要处理的媒体以及要应用于该媒体的编辑。 - 构建
Transformer，描述所需的输出以及完成和错误事件的监听器。 - 开始导出操作，传入要修改的
EditedMediaItem和输出路径。导出过程中，您可以查询当前进度或取消操作。 - 导出完成后，根据需要处理输出。例如，您可以将输出共享给其他应用，或将其上传到服务器。
请继续阅读以详细了解这些步骤，并参阅转换器演示应用中的 TransformerActivity 以查看完整示例。
将 Media3 Transformer 添加为依赖项
如需开始使用 Transformer，最简单的方法是在应用模块的 build.gradle 文件中向该库添加 Gradle 依赖项：
Kotlin
implementation("androidx.media3:media3-transformer:1.4.1")
implementation("androidx.media3:media3-effect:1.4.1")
implementation("androidx.media3:media3-common:1.4.1")
Groovy
implementation "androidx.media3:media3-transformer:1.4.1" implementation "androidx.media3:media3-effect:1.4.1" implementation "androidx.media3:media3-common:1.4.1"
其中 1.4.1 是您的首选版本。如需查看最新版本，请参阅版本说明。
如需详细了解可用的库模块，请参阅 Google Maven AndroidX Media3 页面。
开启 Java 8 支持
如果尚未启用，您需要在依赖于 Transformer 的所有 build.gradle 文件中启用 Java 8 支持，方法是将以下代码添加到 android 部分：
compileOptions {
targetCompatibility JavaVersion.VERSION_1_8
}
开始转换
以下示例展示了如何创建 EditedMediaItem 来移除输入文件的音频，然后创建和配置 Transformer 实例以导出 H.265/HEVC 视频，并将结果输出到 outputPath。
Kotlin
val inputMediaItem = MediaItem.fromUri("path_to_input_file")
val editedMediaItem =
EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build()
val transformer = Transformer.Builder(context)
.setVideoMimeType(MimeTypes.VIDEO_H265)
.addListener(transformerListener)
.build()
transformer.start(editedMediaItem, outputPath)
Java
MediaItem inputMediaItem = MediaItem.fromUri("path_to_input_file");
EditedMediaItem editedMediaItem =
new EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build();
Transformer transformer =
new Transformer.Builder(context)
.setVideoMimeType(MimeTypes.VIDEO_H265)
.addListener(transformerListener)
.build();
transformer.start(editedMediaItem, outputPath);
如需详细了解媒体内容，请参阅 ExoPlayer 媒体内容页面。输入可以是渐进式串流或自适应串流，但输出始终是渐进式串流。对于自适应输入，系统始终会选择最高分辨率的轨道进行转换。输入可以是 ExoPlayer 支持的任何容器格式，但输出始终是 MP4 文件。
您可以在同一 Transformer 实例上顺序执行多项导出操作，但不支持使用同一实例进行并发导出。
线程处理说明
必须从单个应用线程访问转换器实例，并且在同一线程中调用监听器方法。在大多数情况下，应用线程可以只是应用的主线程。在内部，Transformer 会在后台执行其工作，并将对监听器方法的调用发布到应用线程上。
监听事件
start 方法是异步的。它会立即返回，并且系统会通过传递给 Transformer 构建器的监听器通知应用事件。
Kotlin
val transformerListener: Transformer.Listener =
object : Transformer.Listener {
override fun onCompleted(composition: Composition, result: ExportResult) {
playOutput()
}
override fun onError(composition: Composition, result: ExportResult,
exception: ExportException) {
displayError(exception)
}
}
Java
Transformer.Listener transformerListener =
new Transformer.Listener() {
@Override
public void onCompleted(Composition composition, ExportResult result) {
playOutput();
}
@Override
public void onError(Composition composition, ExportResult result,
ExportException exception) {
displayError(exception);
}
};
ExportResult 包含与输出文件相关的信息，包括文件大小以及音频和视频的平均比特率（如果适用）。
获取进度更新
调用 Transformer.getProgress 可查询转换的当前进度。返回的值表示进度状态。如果进度状态为 PROGRESS_STATE_AVAILABLE，则系统会使用当前进度百分比更新所提供的 ProgressHolder。以下示例展示了如何定期查询转换的进度，其中可以实现 updateProgressInUi 方法来更新进度条。
Kotlin
transformer.start(inputMediaItem, outputPath)
val progressHolder = ProgressHolder()
mainHandler.post(
object : Runnable {
override fun run() {
val progressState: @ProgressState Int = transformer.getProgress(progressHolder)
updateProgressInUi(progressState, progressHolder)
if (progressState != Transformer.PROGRESS_STATE_NOT_STARTED) {
mainHandler.postDelayed(/* r= */this, /* delayMillis= */500)
}
}
}
)
Java
transformer.start(inputMediaItem, outputPath);
ProgressHolder progressHolder = new ProgressHolder();
mainHandler.post(
new Runnable() {
@Override
public void run() {
@Transformer.ProgressState int progressState = transformer.getProgress(progressHolder);
updateProgressInUi(progressState, progressHolder);
if (progressState != PROGRESS_STATE_NOT_STARTED) {
mainHandler.postDelayed(/* r= */ this, /* delayMillis= */ 500);
}
}
});
取消转换
如果用户选择退出导出流程，请使用 Transformer.cancel 取消导出操作。硬件视频编解码器等资源有限，尤其是在低端设备上，因此请务必执行此操作，以便在不需要输出时释放资源。