Todos os produtos
Search
Central de documentação

ApsaraVideo Media Processing:Definir cenas de abertura e encerramento

Última atualização: Jun 27, 2026

O ApsaraVideo Media Processing (MPS) permite adicionar uma cena de abertura no início do vídeo em modo picture-in-picture (PiP) e uma cena de encerramento ao final do vídeo com efeitos de transição. Essas cenas são clipes usados para apresentar informações importantes. Este tópico descreve como configurá-las no MPS.

Descrição dos parâmetros

Ao configurar cenas de abertura e encerramento, atente-se aos seguintes parâmetros:

  • Entrada

    Vídeo ao qual você deseja adicionar as cenas de abertura e encerramento e o bucket do Object Storage Service (OSS) onde ele está armazenado.

    Nota

    O parâmetro Location especifica a região do bucket do OSS que armazena o arquivo de entrada. O valor de Location deve corresponder à região onde o MPS foi ativado. Por exemplo, se o endpoint do serviço MPS for mts.cn-hangzhou.aliyuncs.com, defina o parâmetro Location como oss-cn-hangzhou.

  • Detalhes da saída

    Atente-se aos seguintes parâmetros ao configurar a saída de um job:

    • Vídeo

      Informações sobre o arquivo de saída, como largura, altura e bitrate. Se a proporção do vídeo de entrada diferir da proporção de saída, as imagens serão esticadas. Recomendamos especificar apenas a largura ou a altura de saída. A dimensão não especificada será ajustada automaticamente com base na proporção do vídeo de entrada.

    • OpeningList

      Lista de clipes de vídeo a serem mesclados na cena de abertura, seguindo a sequência definida na lista. É possível especificar até dois clipes.

      Especifique os quatro parâmetros abaixo para cada clipe de vídeo:

      • OpenUrl

        Caminho do OSS para o clipe de vídeo.

        Nota

        O clipe deve residir na mesma região do OSS que o vídeo de entrada. Não é possível mesclar vídeos entre regiões diferentes.

      • Start

        Tempo decorrido após o início da reprodução do vídeo de entrada antes que o clipe seja reproduzido. O valor começa em 0. Unidade: segundos. Valor padrão: 0.

      • Width

        Largura do clipe de vídeo. Valores válidos:

        • -1: largura original do clipe.

        • Full: a largura do clipe corresponde à largura da parte principal.

        • Largura personalizada: defina uma largura específica para o clipe. Valores válidos: [0,4096].

          Nota

          O clipe é centralizado com base no ponto central da parte principal. Sua largura deve ser igual ou inferior à largura da parte principal; caso contrário, a cena de abertura pode não ser exibida conforme esperado.

      • Height

        Altura do clipe de vídeo. Valores válidos:

        • -1: altura original do clipe.

        • full: a altura do clipe corresponde à altura da parte principal.

        • Altura personalizada: defina uma altura específica para o clipe. Valores válidos: [0,4096].

          Nota

          O clipe é centralizado com base no ponto central da parte principal. Sua altura deve ser igual ou inferior à altura da parte principal; caso contrário, a cena de abertura pode não ser exibida conforme esperado.

    • TailSlateList

      Lista de clipes de vídeo a serem mesclados na cena de encerramento, respeitando a ordem indicada na lista. O limite é de dois clipes.

      Configure os parâmetros a seguir para cada clipe:

      • TailUrl

        Caminho do OSS para o clipe de vídeo.

        Nota

        O clipe deve estar na mesma região do OSS que o vídeo de entrada. A mesclagem de vídeos entre regiões não é suportada.

      • Width

        Largura do clipe de vídeo. Valores válidos:

        • -1: largura original do clipe.

        • full: a largura do clipe corresponde à largura da parte principal.

        • Largura personalizada: defina manualmente a largura do clipe. Valores válidos: [0,4096]

          Nota

          O alinhamento central do clipe toma como referência o ponto central da parte principal. A largura do clipe não pode exceder a da parte principal; caso contrário, a cena de encerramento pode não aparecer corretamente.

      • Height

        Altura do clipe de vídeo. Valores válidos:

        • -1: altura original do clipe.

        • full: a altura do clipe corresponde à altura da parte principal.

        • Altura personalizada: defina manualmente a altura do clipe. Valores válidos: [0,4096].

          Nota

          O alinhamento central do clipe toma como referência o ponto central da parte principal. A altura do clipe não pode exceder a da parte principal; caso contrário, a cena de encerramento pode não aparecer corretamente.

      • BlendDuration

        Duração da transição entre a parte principal e o clipe. Durante esse intervalo, o último quadro da parte principal desaparece gradualmente (fade out), enquanto o primeiro quadro do clipe surge (fade in). Unidade: segundos. Valor padrão: 0.

      • IsMergeAudio

        Define se o conteúdo de áudio do clipe será mesclado.

      • BgColor

        Cor das barras adicionadas ao clipe quando sua largura ou altura for menor que a da parte principal.

    Exemplo

    Adicione cenas de abertura e encerramento a um vídeo com resolução de 1280 x 720 pixels. As partes de abertura e encerramento são arquivos MP4 com resolução de 640 x480 pixels. A cena de abertura aparece 2 segundos após o início da reprodução do vídeo de saída. A transição entre a parte principal e a cena de encerramento dura 3 segundos. As barras adicionadas à cena de encerramento têm cor preta. Após concluir as configurações, a cena de abertura será exibida em modo PiP sobre a parte principal no marco de tempo 00:00:02, enquanto a parte principal continua sendo reproduzida. Quando a parte principal terminar e desaparecer gradualmente, a cena de encerramento surgirá e depois também desaparecerá.

    Para obter informações sobre códigos de exemplo destinados a configurar cenas de abertura e encerramento usando SDKs do MPS em diferentes linguagens de programação, consulte os tópicos a seguir: