Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo VOD:Ses işleme

Son Güncelleme:Oct 05, 2026

Bu konu, OpenAPI kullanarak videoları düzenlerken ses işleme senaryoları için yaygın Timeline yapılandırmalarına örnekler sunar. Bu senaryolar arasında tüm videoyu sessize alma, belirli bir segmenti sessize alma, sesi çıkarma, videoyu sessize alıp tam bir ses parçasıyla karıştırma, videoyu sessize alıp belirli bir ses segmentiyle karıştırma, video ve ses düzeyini ayarlama, sesleri birleştirme, birden çok ses parçasını karıştırma ve gelişmiş dublaj yer alır.

İlgili API işlemleri

Timeline örnekleri

Tümünü Sessize Al

Bir videonun tamamını sessize almak, video kaynağındaki tüm sesleri kaldırır. Aşağıdaki örnekte ses için Volume efekti kullanılır. Gain parametresi ses düzeyi kazancını temsil eder. 0 değeri sessizliği ifade eder.

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

Belirli bir segmenti sessize alma

Bu işlem, tüm videoyu sessize almaktan farklıdır çünkü Volume efektine In ve Out parametreleri eklenir. Aşağıdaki örnek, videonun 8. saniyesinden 60. saniyesine kadar olan kısmını sessize alır. Videonun diğer bölümlerinin ses düzeyi değişmez:

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

Sesi çıkarma

Bazı senaryolarda, bir videodaki sesi ayrı bir ses kaynağı olarak çıkarmanız gerekebilir. Bunun için bir AudioTracks nesnesi oluşturun ve video kaynağını bir AudioTrackClip olarak iletin. Aşağıdaki örnekte b3f37e05512043f49f697f7425b9****, ses içeren bir video kaynağının ID değeridir.

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

Videoyu sessize alma ve tam bir ses parçasıyla karıştırma

Bu, orijinal videoyu sessize alıp yeni bir ses parçası ekleyerek yeni bir video oluşturduğunuz tipik bir dublaj senaryosudur. Aşağıda bir örnek verilmiştir:

  • Ses işlemeyle ilgili tüm klipleri bir AudioTrack içine yerleştirin.

  • TimelineIn değerini 5 olarak ayarlayın. Bu, sesin çıktı videosuna 5. saniyeden başlayarak bindirildiğini gösterir.

  • TimelineOut ayarlanmazsa varsayılan olarak tüm ses segmenti karıştırılır. Ses, video izinin toplam süresini aşarsa video izinin sonuna uyacak şekilde kısaltılır.

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

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

Videoyu sessize alma ve belirli bir ses segmentiyle karıştırma

Tam bir ses parçasıyla karıştırmadan farklı olarak bu işlem, ses klibinin In ve Out noktaları için ayarlar ekler. Aşağıdaki örnek, 10. saniyeden 20. saniyeye kadar olan ses segmentini (10 saniyelik bir ses klibi) kırpar ve çıktı videosuna 5. saniyeden başlayarak bindirir:

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

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

Video ve ses düzeyini ayarlama

Ses düzeyini ayarlamak için Volume efektini kullanabilirsiniz. Gain parametresi ses düzeyini temsil eder.

Gain parametresi hakkında bilgiler aşağıda verilmiştir:

  • 0: Sesi sessize alır.

  • 1: Orijinal ses düzeyini korur.

  • 0 ile 1 arasındaki bir değer ses düzeyini azaltır. Değer küçüldükçe ses düzeyi düşer.

  • 1'den büyük bir değer ses düzeyini artırır. Değer büyüdükçe ses düzeyi yükselir.

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

{
    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

Sesleri birleştirme

Önceki örneklerin tümünde bir video izi bulunur. Ancak çevrimiçi düzenleme, yalnızca ses içeren izlerin işlenmesini de destekler. Aşağıdaki örnek, aynı ses izindeki iki ses kaynağından belirtilen segmentleri kırpar, bunları sırayla birbirine bağlar ve 30 saniyelik bir ses kaynağı oluşturur:

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

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

Birden çok ses parçasını karıştırma

Aynı izdeki sesleri birleştirmenin yanı sıra çevrimiçi düzenleme, birden çok ses izindeki ses kaynaklarının karıştırılmasını da destekler. Aşağıdaki örnek, birden çok izden gelen sesleri karıştırarak 20 saniyelik bir ses kaynağı oluşturur:

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

{
    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

Gelişmiş dublaj

Gelişmiş dublaj, bir videonun birden çok ses parçasıyla karıştırılmasını içerir. Aşağıda, belirli bir video segmentini sessize alma, başka bir segmentin ses düzeyini ayarlama ve birden çok ses parçasını karıştırma işlemlerini içeren kapsamlı bir ses işleme örneği verilmiştir. Belirli işlemler şöyledir:

  1. 3f7e62d41a334dec9ac802b0f165** videosunu 50. saniyeden 75. saniyeye kadar sessize alın. Bu süre boyunca karıştırma için iki ses izini etkinleştirin. İlk ses izi için b3f37e05512043f49f697f7425b9 medya öğesinin 100. saniyesinden 120. saniyesine kadar olan segmentini kırparak bu klibi zaman çizelgesinde 50. saniyede başlayıp 70. saniyede bitecek şekilde ekleyin ve ses düzeyini 2'ye yükseltin. İkinci ses izi için ab654a04ce554e4f806b5f9e5a34** medya öğesinin 150. saniyesinden 160. saniyesine kadar olan segmentini kırparak bu klibi zaman çizelgesinde 65. saniyede başlayıp 75. saniyede bitecek şekilde ekleyin.

  2. 3f7e62d41a334dec9ac802b0f165**** videosu için 50. saniyeden 75. saniyeye kadar olan segment ve 120. saniyeden 125. saniyeye kadar olan segment hariç tüm segmentlerde ses düzeyi normal kalır.

Not

Bir AudioTrackClip, yalnızca ses içeren bir kaynak veya sesli bir video kaynağı olabilir.

Aşağıda bir örnek verilmiştir:

{
    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

Ses yumuşak geçişlerini (fade-in/fade-out) yapılandırma

Ses yumuşak giriş ve çıkış efekti oluşturmak için "Type": "AFade" alanını ekleyebilirsiniz. Örneğin, bir ses izindeki bir medya öğesi için 3 saniyelik yumuşak giriş ve 4 saniyelik yumuşak çıkış yapılandırabilirsiniz. Ses düzeyi doğrusal olarak artar ve azalır.

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

Parametre alanları

Tür

Zorunlu

Açıklama

SubType

string

Evet

Ses yumuşak geçiş efektinin alt türü. Geçerli değerler:

  • In: yumuşak giriş.

  • Out: yumuşak çıkış.

Duration

float

Hayır

Yumuşak giriş veya çıkış efektinin süresi (saniye cinsinden). Yumuşak giriş efekti medya öğesi segmentinin başına, yumuşak çıkış efekti ise sonuna uygulanır. Varsayılan değer 0'dır; bu, yumuşak geçiş efekti uygulanmadığı anlamına gelir.

Curve

string

Hayır

Ses yumuşak geçiş efekti için ses düzeyi eğrisi. Geçerli değerler:

  • exp (varsayılan): Ses düzeyi üstel olarak değişir.

  • tri: Ses düzeyi doğrusal olarak değişir.

Video için ses yumuşak geçişlerini (fade-in/fade-out) yapılandırma

Bir ses izi için yumuşak geçiş efektlerini yapılandırmaya benzer şekilde, bir videodaki ses için de yumuşak giriş ve çıkış efektlerini yapılandırabilirsiniz. Örneğin, bir video izindeki sesli bir medya öğesi için 3 saniyelik yumuşak giriş ve 4 saniyelik yumuşak çıkış yapılandırabilirsiniz. Ses düzeyi doğrusal olarak artar ve azalır.

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