转换

在格式之间进行转码

构建 Transformer 时，您可以指定要生成的输出音频和视频格式。例如，以下代码展示了如何配置 Transformer 以输出 H.264/AVC 视频和 AAC 音频：

Kotlin

Transformer.Builder(context)
    .setVideoMimeType(MimeTypes.VIDEO_H264)
    .setAudioMimeType(MimeTypes.AUDIO_AAC)
    .build()

Java

new Transformer.Builder(context)
    .setVideoMimeType(MimeTypes.VIDEO_H264)
    .setAudioMimeType(MimeTypes.AUDIO_AAC)
    .build();

如果输入媒体格式已与音频或视频的配置相匹配，Transformer 会自动切换到“转封装”模式，即直接将压缩后的样本从输入容器复制到输出容器，而不进行任何修改。这样可以避免以相同格式进行解码和重新编码所产生的计算成本和潜在的质量损失。 ## 移除音频或视频 {: #remove-audio-video} 使用 `EditedMediaItem.Builder` 移除音频或视频，例如：

Kotlin

EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build()

Java

new EditedMediaItem.Builder(inputMediaItem).setRemoveAudio(true).build();

## 剪辑片段 {: #trim } 您可以通过在输入媒体项上设置剪辑配置，移除指定开始和结束时间戳之外的所有媒体内容。例如，如需生成仅包含 10 秒到 20 秒之间的媒体内容的剪辑，请执行以下操作：

Kotlin

val inputMediaItem = MediaItem.Builder()
    .setUri(uri)
    .setClippingConfiguration(
        MediaItem.ClippingConfiguration.Builder()
            .setStartPositionMs(10_000)
            .setEndPositionMs(20_000)
            .build())
    .build()

Java

MediaItem inputMediaItem =
    new MediaItem.Builder()
        .setUri(uri)
        .setClippingConfiguration(
            new MediaItem.ClippingConfiguration.Builder()
                .setStartPositionMs(10_000)
                .setEndPositionMs(20_000)
                .build())
        .build();

## MP4 编辑列表 {: #mp4-edit-lists } 为了更快地剪辑视频，Transformer 支持 MP4 编辑列表，从而实现更高效的“仅剪辑”编辑，而无需重新转码整个视频。此方法利用现有的编码样本和编辑列表中的“预先播放”功能，指示播放器从特定点开始播放，从而有效地跳过不需要的初始片段。 如需显著加快仅限剪辑的编辑速度，请调用 `experimentalSetMp4EditListTrimEnabled(true)`。

Kotlin

Transformer.Builder(context)
    .experimentalSetMp4EditListTrimEnabled(true)
    .build()

Java

new Transformer.Builder(context)
    .experimentalSetMp4EditListTrimEnabled(true)
    .build();

请务必注意，并非所有媒体播放器都支持“前贴片广告”位置。 这意味着，当使用此类播放器时，无论编辑列表信息是否指定了其他起始点，文件都将从编码样本的绝对开头开始播放。 注意：剪辑视频通常意味着永久移除不需要的部分。不过，使用编辑列表会带来隐私风险：用户可能会在不知不觉中分享“前贴片广告”位置“隐藏”的敏感“已删除”信息。 ## 优化剪辑 {: #trim-optimization } 如需缩短剪辑视频开头的延迟时间，请启用剪辑优化功能。

Kotlin

Transformer.Builder(context)
    .experimentalSetTrimOptimizationEnabled(true)
    .build()

Java

new Transformer.Builder(context)
    .experimentalSetTrimOptimizationEnabled(true)
    .build();

这样可以尽可能少地解码和重新编码视频，然后将重新编码的数据与原始视频的其余部分拼接起来，从而加快导出速度。此优化依赖于将输入文件的部分内容与新编码的输出内容拼接在一起，这意味着编码器的输出格式和输入格式必须兼容。因此，举例来说，如果文件最初是在具有不同编码器实现的设备上生成的，那么很可能无法应用优化。 为了使优化成功，通过 `EncoderFactory` 提供给 Transformer 的编码器必须具有与输入格式兼容的级别和配置文件。 此优化仅适用于以下情况：单个素材资源的 MP4 输入，没有效果，但视频效果和旋转角度可被 90 度整除的情况除外。如果优化失败，Transformer 会自动回退到正常导出，并在 `ExportResult.OptimizationResult` 中报告优化结果。 我们正在验证此功能，预计在后续版本中会将其设为非实验性功能。 ## 视频编辑 {: #video-edits } `EditedMediaItems` 包含按顺序应用的一系列音频处理器和视频效果。该库包含适用于常见用例的视频效果实现，您也可以编写自定义效果，并在构建编辑后的媒体项时传入这些效果。 您可以重新缩放媒体，这在处理 4K 或 8K 视频等超高分辨率输入时，有助于节省处理资源或带宽。 例如，按比例缩放到 480 像素高：

Kotlin

EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(Effects(
        /* audioProcessors= */ listOf(),
        /* videoEffects= */ listOf(Presentation.createForHeight(480))
    )).build()

Java

new EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(new Effects(
        /* audioProcessors= */ ImmutableList.of(),
        /* videoEffects= */ ImmutableList.of(Presentation.createForHeight(480))))
    .build();

或者，您也可以按给定的系数进行缩放，例如将大小减半：

Kotlin

val editedMediaItem = EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(Effects(
        /* audioProcessors= */ listOf(),
        /* videoEffects= */ listOf(
            ScaleAndRotateTransformation.Builder().setScale(.5f, .5f).build())
    )).build()

Java

new EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(new Effects(
        /* audioProcessors= */ ImmutableList.of(),
        /* videoEffects= */ ImmutableList.of(
            new ScaleAndRotateTransformation.Builder().setScale(.5f, .5f).build())))
    .build();

您可以按相同的方式配置旋转：

Kotlin

EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(Effects(
        /* audioProcessors= */ listOf(),
        /* videoEffects= */ listOf(
            ScaleAndRotateTransformation.Builder()
                .setRotationDegrees(90f)
                .build())
    )).build()

Java

new EditedMediaItem.Builder(MediaItem.fromUri(uri))
    .setEffects(new Effects(
        /* audioProcessors= */ ImmutableList.of(),
        /* videoEffects= */ ImmutableList.of(
            new ScaleAndRotateTransformation.Builder().setRotationDegrees(90f).build())))
    .build();

### 自定义视频效果 {: #custom-video } `Effects` 构造函数接受要应用的一系列音频和视频效果。 在内部，Transformer 的效果框架会将视频效果列表转换为按顺序应用的 GL 着色器程序序列。在某些情况下，效果框架能够通过一个着色器程序应用多种效果。例如，一个着色器程序可以应用多个连续的矩阵转换，从而提高效率和质量。 ExoPlayer 还支持使用 `ExoPlayer.setVideoEffects` 预览视频效果。如需了解如何使用此 API 的示例，请查看 [效果演示版应用][effect-demo-app]。 [演示应用](demo-application)包含自定义视频效果的示例。 ## 图片输入 {: #image-input } Transformer 支持将图片输入视为静态视频片段。如需将图片配置为输入源，请按以下步骤操作： * 使用 `MediaItem.Builder` 创建 `MediaItem`。通过调用 `setImageDurationMs` 指定输出视频中图片的显示时长。 * 构建封装 `MediaItem` 的 `EditedMediaItem`。使用 `EditedMediaItem.Builder#setFrameRate` 指定生成的视频流的目标帧速率。 以下示例演示了如何配置图片输入，以生成 5 秒的视频（每秒 30 帧）：

Kotlin

val imageMediaItem = MediaItem.Builder()
    .setUri(imageUri)
    .setImageDurationMs(5000) // 5 seconds
    .build()

val editedImageItem = EditedMediaItem.Builder(imageMediaItem)
    .setFrameRate(30) // 30 frames per second
    .build()

Java

MediaItem imageMediaItem = new MediaItem.Builder()
    .setUri(imageUri)
    .setImageDurationMs(5000) // 5 seconds
    .build();

EditedMediaItem editedImageItem = new EditedMediaItem.Builder(imageMediaItem)
    .setFrameRate(30) // 30 frames per second
    .build();

音频编辑

音频效果是通过将一系列 AudioProcessor 实例应用于原始 (PCM) 音频来实现的。ExoPlayer 支持将音频处理器传递给 DefaultAudioSink.Builder，从而可以预览音频编辑效果。