转换

在不同格式之间转码

您可以指定在构建 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();

如果输入媒体格式已经与音频或视频的配置匹配，则转换器会自动切换到转换，也就是将压缩的样本从输入容器复制到输出容器，不做任何修改。这样可以避免因采用同一格式解码和重新编码而导致的计算开销和潜在的质量损失。

移除音频或视频

使用 EditedMediaItem.Builder 移除音频或视频，例如：

Kotlin

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

Java

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

剪辑片段

您可以通过对输入媒体项设置剪辑配置，移除指定开始和结束时间戳以外的任何媒体。例如，如需生成仅包含 10 秒到 20 秒之间的媒体的剪辑，请使用以下代码：

Kotlin

val inputMediaItem = MediaItem.Builder()
    .setUri(uri)
    .setClippingConfiguration(
        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();

优化剪辑

如需缩短剪辑视频开头部分的延迟时间，请启用剪辑优化功能。

Kotlin

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

Java

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

这样可以尽可能减少视频解码和重新编码，然后将重新编码的数据与原始视频的其余部分进行拼接，从而加快导出速度。该优化依赖于能否使用新编码的输出将部分输入文件拼接起来，这意味着编码器的输出格式和输入格式必须兼容。例如，如果文件最初是在具有不同编码器实现的设备上生成的，那么可能无法应用优化。 为使优化成功，通过 EncoderFactory 提供给 Transformer 的编码器必须具有与输入格式兼容的级别和配置文件。

此优化仅适用于单资源 MP4 输入，除无操作视频效果和可被 90 度整除之外的其他效果。如果优化失败，则 Transformer 会自动回退到正常导出，并在 ExportResult.OptimizationResult 中报告优化的结果。

我们正在验证此功能，预计在后续版本中会成为非实验性功能。

视频编辑

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();

自定义视频特效

Effects 构造函数接受要应用的音频和视频效果列表。在内部，Transformer 的效果框架会将视频特效列表转换为一系列按顺序应用的 GL 着色器程序。在某些情况下，效果框架能够通过一个着色器程序应用多种效果。例如，一个着色器程序可以应用多个连续矩阵转换，从而提高效率和质量。

您还可以使用 ExoPlayer.setVideoEffects 在 ExoPlayer 中预览视频特效。

演示版应用包含自定义视频特效的示例。

音频编辑

音效的实现方法是将一系列 AudioProcessor 实例应用于原始 (PCM) 音频。ExoPlayer 支持将音频处理器传递给 DefaultAudioSink.Builder，以便预览音频修改。