Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Processamento de áudio

Última atualização: Jun 27, 2026

Este tópico apresenta exemplos comuns de configurações de Timeline para cenários de processamento de áudio durante a edição de vídeos via OpenAPI. Os cenários incluem silenciar um vídeo inteiro, silenciar um segmento específico, extrair áudio, silenciar um vídeo e mixá-lo com uma faixa de áudio completa, silenciar um vídeo e mixá-lo com um segmento de áudio específico, ajustar o volume do vídeo e do áudio, concatenar áudios, mixar múltiplas faixas de áudio e aplicar dublagem avançada.

Operações de API relacionadas

Exemplos de Timeline

Silenciar tudo

Silenciar um vídeo inteiro remove todo o som do recurso de vídeo. O exemplo a seguir usa o efeito Volume para o áudio. Gain representa o ganho de volume. O valor 0 indica silêncio.

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

Silenciar um segmento específico

Esta operação difere de silenciar o vídeo inteiro porque adiciona os parâmetros In e Out ao efeito Volume. O exemplo abaixo silencia o vídeo do segundo 8 ao segundo 60. O volume das demais partes do vídeo permanece inalterado:

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

Extrair áudio

Em alguns cenários, é necessário extrair o áudio de um vídeo como um recurso separado. Para isso, crie um objeto AudioTracks e passe o recurso de vídeo como um AudioTrackClip. No exemplo a seguir, b3f37e05512043f49f697f7425b9**** é o ID de um recurso de vídeo que contém áudio.

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

Silenciar um vídeo e mixar com uma faixa de áudio completa

Este é um cenário típico de dublagem em que você silencia o vídeo original e adiciona uma nova faixa de áudio para criar um novo vídeo. Veja um exemplo:

  • Coloque todos os clipes relacionados ao processamento de áudio em um AudioTrack.

  • Defina TimelineIn como 5. Isso indica que o áudio será sobreposto ao vídeo de saída a partir do segundo 5.

  • Se TimelineOut não estiver definido, todo o segmento de áudio será mixado por padrão. Caso o áudio ultrapasse a duração total da faixa de vídeo, ele será truncado para corresponder ao final dessa faixa.

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

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

Silenciar um vídeo e mixar com um segmento de áudio específico

Diferentemente da mixagem com uma faixa de áudio completa, esta operação adiciona configurações para os pontos de entrada (In) e saída (Out) do clipe de áudio. O exemplo a seguir recorta o segmento de áudio do segundo 10 ao segundo 20 (um clipe de 10 segundos) e o sobrepõe ao vídeo de saída a partir do segundo 5:

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

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

Ajustar o volume do vídeo e do áudio

Use o efeito Volume para definir o nível sonoro. O parâmetro Gain representa o nível de volume.

O parâmetro Gain funciona da seguinte forma:

  • 0: Silencia o áudio.

  • 1: Mantém o volume original.

  • Valores entre 0 e 1 diminuem o volume. Quanto menor o valor, mais baixo o volume.

  • Valores maiores que 1 aumentam o volume. Quanto maior o valor, mais alto o volume.

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

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

Concatenar áudio

Os exemplos anteriores incluem uma faixa de vídeo. No entanto, a edição online também suporta o processamento de faixas apenas de áudio. O exemplo a seguir recorta segmentos específicos de dois recursos de áudio na mesma faixa, conecta-os em sequência e cria um recurso de áudio de 30 segundos:

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

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

Mixar múltiplas faixas de áudio

Além de concatenar áudio na mesma faixa, a edição online permite mixar recursos de áudio de várias faixas. O exemplo a seguir mixa áudios de múltiplas faixas para criar um recurso de áudio de 20 segundos:

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

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

Dublagem avançada

A dublagem avançada envolve a mixagem de um vídeo com múltiplas faixas de áudio. A seguir, apresentamos um exemplo abrangente de processamento de áudio que inclui silenciar um segmento de vídeo específico, ajustar o volume de outro segmento e mixar várias faixas de áudio. As operações específicas são:

  1. Silencie o vídeo 3f7e62d41a334dec9ac802b0f165** do segundo 50 ao segundo 75. Durante esse período, ative duas faixas de áudio para mixagem. Na primeira faixa, recorte o segmento do segundo 100 ao segundo 120 do ativo de mídia b3f37e05512043f49f697f7425b9. Insira este clipe para começar no segundo 50 e terminar no segundo 70 da timeline, aumentando o volume para 2. Na segunda faixa, recorte o segmento do segundo 150 ao segundo 160 do ativo de mídia ab654a04ce554e4f806b5f9e5a34**. Insira este clipe para começar no segundo 65 e terminar no segundo 75.

  2. Para o vídeo 3f7e62d41a334dec9ac802b0f165****, o volume permanece normal em todos os segmentos, exceto no trecho do segundo 50 ao segundo 75 e no trecho do segundo 120 ao segundo 125.

Nota

Um AudioTrackClip pode ser um recurso apenas de áudio ou um recurso de vídeo com áudio.

Veja um exemplo:

{
    "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 fade-in e fade-out de áudio

Adicione o campo "Type": "AFade" para criar um efeito de fade-in e fade-out de áudio. Por exemplo, configure um fade-in de 3 segundos e um fade-out de 4 segundos para um ativo de mídia em uma faixa de áudio. O volume aumenta e diminui linearmente.

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

Campos de parâmetro

Tipo

Obrigatório

Descrição

SubType

string

Sim

O subtipo do efeito de fade de áudio. Valores válidos:

  • In: fade in.

  • Out: fade out.

Duration

float

Não

A duração do efeito fade-in ou fade-out, em segundos. O efeito fade-in aplica-se ao início do segmento do ativo de mídia, e o efeito fade-out aplica-se ao final. O valor padrão é 0, o que significa que nenhum efeito de fade é aplicado.

Curve

string

Não

A curva de volume para o efeito de fade de áudio. Valores válidos:

  • exp (padrão): O volume muda exponencialmente.

  • tri: O volume muda linearmente.

Configure fade-in e fade-out de áudio para um vídeo

Assim como na configuração de efeitos de fade para uma faixa de áudio, você também pode configurar efeitos de fade-in e fade-out para o áudio de um vídeo. Por exemplo, configure um fade-in de 3 segundos e um fade-out de 4 segundos para um ativo de mídia com áudio em uma faixa de vídeo. O volume aumenta e diminui linearmente.

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