Todos os produtos
Search
Central de documentação

ApsaraVideo Media Processing:Set merging and clipping

Última atualização: Jun 27, 2026

O MPS permite mesclar vários vídeos em uma única saída, combinar clipes de transmissões ao vivo gravadas e extrair trechos de um vídeo. Use o recurso de mesclagem para unificar vídeos com diferentes formatos, codecs e resoluções em um único arquivo de saída. Use o recurso de recorte para isolar um intervalo de tempo específico de um vídeo e salve-o como um novo arquivo.

Mesclar vídeos

Defina os parâmetros a seguir para configurar um trabalho de mesclagem de vídeo:

  • Input

    A parte inicial a mesclar e o bucket do OSS onde ela está armazenada.

    Nota

    O parâmetro Location especifica a região do bucket do OSS. Esse valor deve corresponder à região onde o MPS está ativado. Por exemplo, se o endpoint do MPS for mts.cn-hangzhou.aliyuncs.com, defina Location como oss-cn-hangzhou.

  • Output

    Configure os seguintes parâmetros para a saída do trabalho:

    • Video

      Propriedades do vídeo de saída, como largura, altura e taxa de bits. Se as proporções dos vídeos a mesclar (incluindo as partes inicial e final) diferirem da proporção de saída, o MPS adiciona barras pretas automaticamente para preencher o quadro. Prepare as partes inicial e final em diversas proporções para atender a diferentes resoluções de saída.

    • MergeList

      Lista de vídeos a mesclar, processados na ordem especificada. O último item da lista corresponde à parte final. Há suporte para até cinco vídeos, incluindo as partes inicial e final. Para mesclar mais de cinco vídeos, use MergeConfigUrl.

      Nota

      Especifique apenas um entre MergeList e MergeConfigUrl.

      Cada entrada no MergeList aceita os seguintes parâmetros:

      • MergeURL

        Caminho no OSS do vídeo a mesclar.

        Nota

        Todos os vídeos do trabalho de mesclagem devem estar na mesma região do OSS que a parte inicial. Não há suporte para mesclagem entre regiões.

      • Start

        Ponto de início do segmento a mesclar. Defina este parâmetro para mesclar apenas uma parte do vídeo. Valor padrão: 0.

      • Duration

        Duração do segmento a mesclar, contada a partir do ponto Start. Configure este parâmetro para mesclar somente um trecho do vídeo. Por padrão, o segmento vai do ponto Start até o fim do vídeo.

    • MergeConfigUrl

      URL no OSS de um arquivo de configuração JSON para o trabalho de mesclagem. O conteúdo do arquivo segue o mesmo esquema do parâmetro MergeList.

      Nota

      Os vídeos são mesclados conforme a ordem definida no arquivo de configuração. A última entrada representa a parte final. Este método suporta até 100 vídeos, incluindo as partes inicial e final.

Extrair um clipe de vídeo

Para extrair um clipe de um vídeo, configure os parâmetros a seguir:

  • Input

    O vídeo de source e o bucket do OSS onde ele está armazenado.

    Nota

    O parâmetro Location indica a região do bucket do OSS. Esse valor deve coincidir com a região onde o MPS está ativado. Se o endpoint do MPS for mts.cn-hangzhou.aliyuncs.com, por exemplo, defina Location como oss-cn-hangzhou.

  • Output

    Configure os parâmetros a seguir para a saída do trabalho:

    • TimeSpan

      Intervalo de tempo do clipe a extrair. Determina onde o clipe começa e sua duração.

      Use os seguintes parâmetros para definir o intervalo de tempo:

      • Seek

        Momento exato em que o clipe começa.

      • Duration

        Comprimento total do clipe.

      • End

        Quantidade de tempo a remover do final do vídeo original.

        Nota

        Se End for especificado, o parâmetro Duration será ignorado.

    • ConfigToClipFirstPart

      Determina se o recorte ocorre antes ou depois da mesclagem. Defina como true para recortar a primeira parte dos vídeos antes de mesclá-los. Defina como false para mesclar as entradas primeiro e depois recortar a saída. Valor padrão: false.

    • Exemplo

      Adicione partes inicial e final com resolução de 640 × 480 pixels a um vídeo com resolução de 1280 × 720 pixels para gerar um vídeo MP4 com resolução de 1280 × 720 pixels. As partes inicial e final recebem barras pretas nas laterais (letterbox), enquanto o vídeo principal é exibido normalmente.

      Para ver exemplos de código em diferentes linguagens de programação, consulte: