変換

フォーマット間のコード変換

Transformer の作成時に生成する出力音声形式と出力動画形式を指定できます。たとえば、次のコードは、H.264/AVC 動画と AAC オーディオを出力するように Transformer を設定する方法を示しています。

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

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

入力メディア形式が音声または動画の構成とすでに一致している場合、Transformer は自動的にトランス多重化に切り替わります。つまり、入力コンテナから出力コンテナに圧縮サンプルをそのままコピーします。これにより、同じ形式でのデコードと再エンコードの計算コストと品質低下の可能性を回避できます。

音声または動画を削除

EditedMediaItem.Builder を使用して音声または動画を削除します。次に例を示します。

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

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

クリップをカットする

入力メディア アイテムにクリッピング構成を設定すると、指定した開始タイムスタンプと終了タイムスタンプ以外のメディアを削除できます。たとえば、10 秒から 20 秒までのメディアのみを含むクリップを作成するには、次のようにします。

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

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

動画編集

EditedMediaItems には、順番に適用されるオーディオ プロセッサと動画エフェクトのリストがあります。このライブラリには、一般的なユースケースの動画エフェクトの実装が含まれています。また、カスタム エフェクトを作成して、編集済みのメディア アイテムの作成時に渡すこともできます。

メディアのスケーリングも可能です。これは、4K や 8K の動画など、非常に高い解像度の入力を処理するときに、処理リソースや帯域幅を節約するのに役立ちます。たとえば、高さ 480 ピクセルに比例してスケーリングするには、次のようにします。

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

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

また、特定の係数でスケーリングすることもできます。たとえば、サイズを半分にします。

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

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

ローテーションも同じ方法で構成できます。

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

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 シェーダー プログラムのに変換します。場合によっては、エフェクト フレームワークで 1 つのシェーダー プログラムで複数のエフェクトを適用できます。たとえば、1 つのシェーダー プログラムで複数の連続した行列変換を適用できるため、効率と品質が向上します。

ExoPlayer.setVideoEffects を使用した ExoPlayer でのプレビューの動画エフェクトもサポートされています。

デモアプリには、カスタム動画エフェクトのサンプルが用意されています。

音声の編集

オーディオ エフェクトは、AudioProcessor インスタンスのシーケンスを未加工（PCM）音声に適用することで実装されます。ExoPlayer は、音声プロセッサを DefaultAudioSink.Builder に渡すことで、音声編集をプレビューできます。