Transformasi

Melakukan transcoding antar-format

Anda dapat menentukan format audio dan video output yang ingin dihasilkan saat membangun Transformer. Misalnya, kode berikut menunjukkan cara mengonfigurasi Transformer untuk menghasilkan video H.264/AVC dan audio AAC:

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

Jika format media input sudah cocok dengan konfigurasi untuk audio atau video, Transformer akan otomatis beralih ke transmuxing, yaitu menyalin sampel terkompresi dari penampung input ke penampung output tanpa modifikasi. Hal ini menghindari biaya komputasi dan potensi hilangnya kualitas dekode dan pengodean ulang dalam format yang sama.

Menghapus audio atau video

Menghapus audio atau video menggunakan EditedMediaItem.Builder, misalnya:

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

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

Memangkas klip

Anda dapat menghapus media apa pun di luar stempel waktu mulai dan berakhir yang ditentukan dengan menyetel konfigurasi kliping pada item media input. Misalnya, untuk menghasilkan klip yang hanya berisi media antara 10 detik dan 20 detik:

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

Daftar pengeditan MP4

Untuk pemangkasan yang lebih cepat, Transformer mendukung daftar pengeditan MP4, sehingga memungkinkan pengeditan "khusus pangkas" yang lebih efisien tanpa transkode ulang video secara penuh. Metode ini menggunakan sampel yang sudah dienkode dan "pra-putar" dalam daftar pengeditan, yang menginstruksikan pemutar untuk memulai pemutaran pada titik tertentu, sehingga secara efektif melewati segmen awal yang tidak diinginkan.

Untuk membuat pengeditan khusus pemangkasan jauh lebih cepat, panggil experimentalSetMp4EditListTrimEnabled(true).

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

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

Penting untuk diperhatikan bahwa tidak semua pemutar media mendukung posisi "pre-roll". Artinya, saat pemutar tersebut digunakan, file akan mulai diputar dari awal mutlak sampel yang dienkode, terlepas dari informasi daftar edit yang mungkin menentukan titik awal yang berbeda.

Mengoptimalkan pangkasan

Untuk mengurangi latensi pemangkasan awal video, aktifkan pengoptimalan pemangkasan.

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

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

Hal ini mempercepat ekspor dengan mendekode dan mengenkode ulang sesedikit mungkin video, lalu menggabungkan data yang dienkode ulang dengan video asli lainnya. Pengoptimalan bergantung pada kemampuan untuk menggabungkan bagian file input dengan output yang baru dienkode, yang berarti bahwa format output encoder dan format input harus kompatibel. Jadi, misalnya, jika file awalnya dibuat di perangkat dengan penerapan encoder yang berbeda, kemungkinan pengoptimalan tidak dapat diterapkan. Agar pengoptimalan berhasil, encoder yang diberikan ke Transformer melalui EncoderFactory harus memiliki level dan profil yang kompatibel dengan format input.

Pengoptimalan ini hanya berfungsi dengan input MP4 aset tunggal tanpa efek, kecuali efek video tanpa operasi dan rotasi yang dapat dibagi 90 derajat. Jika pengoptimalan gagal, Transformer akan otomatis kembali ke ekspor normal, dan melaporkan hasil pengoptimalan di ExportResult.OptimizationResult.

Kami sedang memvalidasi fungsi ini dan berharap fungsi ini tidak lagi bersifat eksperimental dalam rilis mendatang.

Pengeditan video

EditedMediaItems memiliki daftar pemroses audio dan efek video yang akan diterapkan secara berurutan. Library ini mencakup penerapan efek video untuk kasus penggunaan umum, atau Anda dapat menulis efek kustom dan meneruskannya saat membuat item media yang diedit.

Anda dapat mengubah skala media, yang dapat berguna untuk menghemat sumber daya pemrosesan atau bandwidth saat menangani input beresolusi sangat tinggi, seperti video 4K atau 8K. Misalnya, untuk menskalakan secara proporsional ke tinggi 480 piksel:

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

Atau, Anda dapat menskalakan dengan faktor tertentu, misalnya, untuk mengurangi ukuran menjadi setengahnya:

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

Anda dapat mengonfigurasi rotasi dengan cara yang sama:

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

Efek video kustom

Konstruktor Effects menerima daftar efek audio dan video yang akan diterapkan. Secara internal, framework efek Transformer mengonversi daftar efek video menjadi urutan program shader GL yang diterapkan secara berurutan. Dalam beberapa kasus, framework efek dapat menerapkan beberapa efek dengan satu program shader. Misalnya, satu program shader dapat menerapkan beberapa transformasi matriks berurutan, yang meningkatkan efisiensi dan kualitas.

Efek video juga didukung untuk pratinjau di ExoPlayer, menggunakan ExoPlayer.setVideoEffects. Untuk mengetahui contoh cara menggunakan API ini, lihat aplikasi demo efek.

Aplikasi demo mencakup contoh efek video kustom.

Pengeditan audio

Efek audio diimplementasikan dengan menerapkan urutan instance AudioProcessor ke audio mentah (PCM). ExoPlayer mendukung penerusan pemroses audio ke DefaultAudioSink.Builder, yang memungkinkan pratinjau pengeditan audio.