全部产品
Search
文档中心

ApsaraVideo VOD:Pemrosesan audio

更新时间:Jan 30, 2026

Topik ini menyediakan contoh konfigurasi Timeline umum untuk skenario pemrosesan audio saat Anda mengedit video menggunakan OpenAPI. Skenario tersebut mencakup membisukan seluruh video, membisukan segmen tertentu, mengekstraksi audio, membisukan video dan mencampurnya dengan track audio lengkap, membisukan video dan mencampurnya dengan segmen audio tertentu, menyesuaikan volume video dan audio, menggabungkan audio, mencampurkan beberapa track audio, serta dubbing advanced.

Operasi API terkait

Contoh Timeline

Mute All

Membisukan seluruh video menghapus semua suara dari resource video. Contoh berikut menggunakan efek Volume untuk audio. Gain merepresentasikan penguatan volume. Nilai 0 menunjukkan senyap.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0"
                        }
                    ]
                }
            ]
        }
    ]
}

Mute a specified segment

Operasi ini berbeda dari membisukan seluruh video karena menambahkan parameter In dan Out pada efek Volume. Contoh berikut membisukan video dari detik ke-8 hingga detik ke-60. Volume bagian lain dari video tetap tidak berubah:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                            "In": 8,
                            "Out": "60"
                        }
                    ]
                }
            ]
        }
    ]
}

Extract audio

Dalam beberapa skenario, Anda mungkin perlu mengekstraksi audio dari video sebagai resource audio terpisah. Untuk melakukannya, buat objek AudioTracks dan masukkan resource video sebagai AudioTrackClip. Pada contoh berikut, b3f37e05512043f49f697f7425b9**** adalah ID resource video yang berisi audio.

{
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "b3f37e05512043f49f697f7425b9****"
                }
            ]
        }
    ]
}

Mute a video and mix with a full audio track

Ini merupakan skenario dubbing khas di mana Anda membisukan video asli lalu menambahkan track audio baru untuk membuat video baru. Berikut adalah contohnya:

  • Tempatkan semua klip terkait pemrosesan audio ke dalam AudioTrack.

  • Atur TimelineIn ke 5. Ini menunjukkan bahwa audio ditimpa pada video output, dimulai dari detik ke-5.

  • Jika TimelineOut tidak diatur, seluruh segmen audio akan dicampur secara default. Jika durasi audio melebihi durasi total track video, audio tersebut akan dipotong agar sesuai dengan akhir track video.

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0"
                        }
                    ]
                }
            ]
        }
    ],
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "4a71744998414cbe8ea1976435a7****",
                    "TimelineIn":5
                }
            ]
        }
    ]
}

Mute a video and mix with a specified audio segment

Berbeda dengan pencampuran menggunakan track audio lengkap, operasi ini menambahkan pengaturan titik In dan Out pada klip audio. Contoh berikut memotong segmen audio dari detik ke-10 hingga detik ke-20 (klip audio 10 detik) dan menimpakannya pada video output, dimulai dari detik ke-5:

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0"
                        }
                    ]
                }
            ]
        }
    ],
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "4a71744998414cbe8ea1976435a7****",
                    "In":10,
                    "Out":20,
                    "TimelineIn":5
                }
            ]
        }
    ]
}

Adjust video and audio volume

Anda dapat menggunakan efek Volume untuk mengatur volume. Parameter Gain merepresentasikan tingkat volume.

Berikut penjelasan parameter Gain:

  • 0: Membisukan audio.

  • 1: Mempertahankan volume asli.

  • Nilai antara 0 dan 1 menurunkan volume. Semakin kecil nilainya, semakin rendah volumenya.

  • Nilai lebih besar dari 1 meningkatkan volume. Semakin besar nilainya, semakin tinggi volumenya.

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0.5"
                        }
                    ]
                }
            ]
        }
    ],
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "4a71744998414cbe8ea1976435a7****",
                    "In":10,
                    "Out":20,
                    "TimelineIn":5,
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "2"
                        }
                    ]
                }
            ]
        }
    ]
}

Concatenate audio

Contoh-contoh sebelumnya semuanya mencakup track video. Namun, pengeditan daring juga mendukung pemrosesan track hanya audio. Contoh berikut memotong segmen tertentu dari dua resource audio pada track audio yang sama, menghubungkannya secara berurutan, dan menghasilkan resource audio berdurasi 30 detik:

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

{
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "b3f37e05512043f49f697f7425b9****",
                    "In": 100,
                    "Out": 120
                },
                {
                    "MediaId": "ab654a04ce554e4f806b5f9e5a34****",
                    "In": 50,
                    "Out": 60
                }
            ]
        }
    ]
}

Mix multiple audio tracks

Selain menggabungkan audio pada track yang sama, pengeditan daring juga mendukung pencampuran resource audio dari beberapa track audio. Contoh berikut mencampurkan audio dari beberapa track untuk menghasilkan resource audio berdurasi 20 detik:

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

{
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "b3f37e05512043f49f697f7425b9****",
                    "In": 100,
                    "Out": 120,
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "2"
                        }
                    ]
                }
            ]
        },
        {
            "AudioTrackClips": [
                {
                    "MediaId": "ab654a04ce554e4f806b5f9e5a34****",
                    "In": 50,
                    "Out": 60,
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "1"
                        }
                    ]
                }
            ]
        }
    ]
}

Advanced dubbing

Dubbing advanced melibatkan pencampuran video dengan beberapa track audio. Berikut adalah contoh komprehensif pemrosesan audio yang mencakup membisukan segmen video tertentu, menyesuaikan volume segmen lain, serta mencampurkan beberapa track audio. Operasi spesifiknya sebagai berikut:

  1. Bisukan video 3f7e62d41a334dec9ac802b0f165**** dari detik ke-50 hingga detik ke-75. Selama periode ini, aktifkan dua track audio untuk pencampuran. Untuk track audio pertama, potong segmen dari detik ke-100 hingga detik ke-120 dari aset media b3f37e05512043f49f697f7425b9****. Masukkan klip ini agar dimulai pada detik ke-50 dan berakhir pada detik ke-70 di timeline, serta tingkatkan volumenya menjadi 2. Untuk track audio kedua, potong segmen dari detik ke-150 hingga detik ke-160 dari aset media ab654a04ce554e4f806b5f9e5a34****. Masukkan klip ini agar dimulai pada detik ke-65 dan berakhir pada detik ke-75.

  2. Untuk video 3f7e62d41a334dec9ac802b0f165****, volume tetap normal untuk semua segmen kecuali segmen dari detik ke-50 hingga detik ke-75 dan segmen dari detik ke-120 hingga detik ke-125.

Catatan

AudioTrackClip dapat berupa resource hanya audio atau resource video yang berisi audio.

Berikut adalah contohnya:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "3f7e62d41a334dec9ac802b0f165****",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                            "In": 50,
                            "Out": "75"
                        },
                        {
                            "Type": "Volume",
                            "Gain": "0.8",
                            "In": 120,
                            "Out": "125"
                        },

                    ]
                }
            ]
        }
    ],
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId": "b3f37e05512043f49f697f7425b9****",
                    "In": 100,
                    "Out": 120,
                    "TimelineIn":50,
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "2"
                        }
                    ]
                }
            ]
        },
        {
            "AudioTrackClips": [
                {
                    "MediaId": "ab654a04ce554e4f806b5f9e5a34****",
                    "In": 150,
                    "Out": 160,
                    "TimelineIn":65,
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "1"
                        }
                    ]
                }
            ]
        }
    ]
}

Configure audio fade-in and fade-out

Anda dapat menambahkan bidang "Type": "AFade" untuk membuat efek fade-in dan fade-out audio. Misalnya, Anda dapat mengonfigurasi fade-in selama 3 detik dan fade-out selama 4 detik untuk aset media pada track audio. Volume akan meningkat dan menurun secara linear.

{
  "AudioTracks": [
    {
      "AudioTrackClips": [
        {
          "MediaId": "f044b3adc7967ba8f5cdf044b059****",
          "Effects": [
            {
              "Type": "AFade",
              "SubType": "In",
              "Duration": 3,
              "Curve": "tri"
            },
            {
              "Type": "AFade",
              "SubType": "Out",
              "Duration": 4,
              "Curve": "tri"
            }
          ]
        }
      ]
    }
  ]
}

Bidang parameter

Tipe

Wajib

Deskripsi

SubType

string

Ya

Subtipe efek fade audio. Nilai yang valid:

  • In: fade in.

  • Out: fade out.

Duration

float

Tidak

Durasi efek fade-in atau fade-out, dalam satuan detik. Efek fade-in diterapkan pada awal segmen aset media, sedangkan efek fade-out diterapkan pada akhirnya. Nilai default adalah 0, yang berarti tidak ada efek fade yang diterapkan.

Curve

string

Tidak

Kurva volume untuk efek fade audio. Nilai yang valid:

  • exp (default): Volume berubah secara eksponensial.

  • tri: Volume berubah secara linear.

Configure audio fade-in and fade-out for a video

Seperti mengonfigurasi efek fade untuk track audio, Anda juga dapat mengonfigurasi efek fade-in dan fade-out untuk audio dalam video. Misalnya, Anda dapat mengonfigurasi fade-in selama 3 detik dan fade-out selama 4 detik untuk aset media yang berisi audio pada track video. Volume akan meningkat dan menurun secara linear.

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "f044b3adc7967ba8f5cdf044b059****",
          "Effects": [
            {
              "Type": "AFade",
              "SubType": "In",
              "Curve": "tri",
              "Duration": 3
            },
            {
              "Type": "AFade",
              "SubType": "Out",
              "Duration": 4,
              "Curve": "tri"
            }
          ]
        }
      ]
    }
  ]
}