Todos os produtos
Search
Central de documentação

Intelligent Media Services:Configurações de timeline

Última atualização: Jun 30, 2026

Uma timeline organiza materiais em faixas com efeitos aplicados para produzir um vídeo. Para obter mais informações sobre exemplos de timelines, consulte Casos de uso.

Parâmetro

Tipo

Obrigatório

Descrição

VideoTracks

VideoTrack[]

Não (se não houver faixas de vídeo, as faixas de áudio serão obrigatórias).

Faixas de vídeo. A sobreposição segue a sequência dos elementos do array MediaId. Por exemplo, a faixa correspondente ao primeiro elemento do array MediaId fica abaixo da faixa correspondente ao segundo elemento.

AudioTracks

AudioTrack[]

Não (se não houver faixas de áudio, as faixas de vídeo serão obrigatórias).

Faixas de áudio.

ImageTracks (a funcionalidade de faixa de imagem foi integrada à de faixa de vídeo e não recebe mais iterações ou manutenção).

ImageTrack[]

Não (se existirem faixas de imagem, as faixas de vídeo serão obrigatórias).

Faixas de imagem. Observação:

1. Posicione as faixas de imagem acima das faixas de vídeo. Para combinar uma imagem com um vídeo como material em cenários de produção, utilize faixas de vídeo.

2. A sobreposição das faixas de imagem segue a sequência dos elementos do array MediaId. Por exemplo, a faixa correspondente ao primeiro elemento do array MediaId fica abaixo da faixa correspondente ao segundo elemento.

SubtitleTracks

SubtitleTrack[]

Não

Faixas de legenda.

EffectTracks

EffectTrack[]

Não

Faixas de efeitos.

VideoTrack

Organiza materiais de vídeo e imagem.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Não

Tipo da faixa de vídeo. O padrão é uma faixa de vídeo comum.

Se você definir Type como Effect, a faixa de vídeo poderá ser usada para efeitos. Nesse caso, especifique objetos EffectTrackItem em VideoTrackClips.

MainTrack

Boolean

Não

Defina se a faixa de vídeo atual é a principal. Valor padrão: False. Para obter mais informações, consulte Definir uma faixa principal.

TrackShortenMode

String

Não

Se a duração da faixa de vídeo atual exceder a da faixa principal, o sistema encurta adaptativamente a faixa atual para alinhá-la à principal. Este parâmetro especifica o modo de encurtamento. Valor válido:

  • AutoSpeed: acelera o vídeo automaticamente.

TrackExpandMode

String

Não

Se a duração da faixa de vídeo atual for inferior à da faixa principal, o sistema estende adaptativamente a faixa atual para alinhá-la à principal. Este parâmetro especifica o modo de extensão. Valor válido:

  • AutoSpeed: desacelera o vídeo automaticamente.

VideoTrackClips

VideoTrackClip[]

Sim

Materiais na faixa de vídeo.

AudioTrack

Organiza materiais exclusivamente de áudio e materiais de vídeo com streams de áudio.

Parâmetro

Tipo

Obrigatório

Descrição

MainTrack

Boolean

Não

Defina se a faixa de áudio atual é a principal. Valor padrão: False. Para obter mais informações, consulte Definir uma faixa principal.

TrackShortenMode

String

Não

Se a duração da faixa de áudio atual exceder a da faixa principal, o sistema encurta adaptativamente a faixa atual para alinhá-la à principal. Este parâmetro especifica o modo de encurtamento. Valor válido:

  • AutoSpeed: acelera o áudio automaticamente.

TrackExpandMode

String

Não

Se a duração da faixa de áudio atual for inferior à da faixa principal, o sistema estende adaptativamente a faixa atual para alinhá-la à principal. Este parâmetro especifica o modo de extensão. Valor válido:

  • AutoSpeed: desacelera o áudio automaticamente.

AudioTrackClips

AudioTrackClip[]

Sim

Materiais na faixa de áudio.

ImageTrack

Importante

A funcionalidade de faixa de imagem foi integrada à de faixa de vídeo e não recebe mais iterações ou manutenção.

Organiza materiais de imagem.

Parâmetro

Tipo

Obrigatório

Descrição

ImageTrackClips (a funcionalidade de faixa de imagem foi integrada à de faixa de vídeo e não recebe mais iterações ou manutenção)

ImageTrackClip[]

Sim

Materiais na faixa de imagem.

SubtitleTrack

Organiza legendas, incluindo textos de banner e legendas externas.

Parâmetro

Tipo

Obrigatório

Descrição

SubtitleTrackClips

SubtitleTrackClip[]

Sim

Materiais na faixa de legenda.

EffectTrack

Adiciona filtros e efeitos visuais a um vídeo.

Parâmetro

Tipo

Obrigatório

Descrição

EffectTrackItems

EffectTrackItem[]

Sim

Filtros e efeitos adicionados à faixa de efeitos.

VideoTrackClip

Adicione materiais de vídeo ou imagem a uma faixa de vídeo.

Use os parâmetros In, Out, TimelineIn e TimelineOut para especificar a posição de corte e inserção do material na timeline. Por exemplo, se você definir In como 5, Out como 10, TimelineIn como 15 e TimelineOut como 20, o trecho do material entre o 5º e o 10º segundo será cortado e reproduzido do 15º ao 20º segundo na timeline.

Parâmetro

Tipo

Obrigatório

Descrição

MediaId

String

Não

ID do ativo de mídia do Intelligent Media Services (IMS) ou ApsaraVideo VOD correspondente ao material na faixa de vídeo.

Observação: especifique apenas MediaId ou MediaURL.

MediaURL

String

Não

URL do Object Storage Service (OSS) do material na faixa de vídeo. A URL do OSS tem o seguinte formato:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4.

Observação:

  • Especifique apenas MediaId ou MediaURL.

  • Você pode especificar uma URL pública do OSS ou uma URL pública acessível pela internet neste parâmetro.

Para obter mais informações, consulte Edição de imagem e vídeo.

Type

String

Não

Tipo do material. Valor padrão: Video.

Valores válidos:

  • Video

  • Image

  • GlobalImage: imagem global. A duração de uma imagem global equivale à da faixa de vídeo. Para obter mais informações sobre GlobalImage, consulte Edição de imagem e vídeo.

X

Float

Não

Distância horizontal entre o canto superior esquerdo do material e o canto superior esquerdo do vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Y

Float

Não

Distância vertical entre o canto superior esquerdo do material e o canto superior esquerdo do vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Width

Float

Não

Largura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Height

Float

Não

Altura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

AdaptMode

String

Não

Modo de redimensionamento automático do material. Este parâmetro só tem efeito se você especificar a largura e a altura da visualização. O material é escalonado com base nessas dimensões. Valores válidos:

  • Contain: redimensiona o material mantendo a proporção original.

  • Cover: redimensiona o material mantendo a proporção original para preencher a visualização e corta o excesso. Se a proporção do objeto não corresponder à visualização, o objeto será cortado com base na largura e altura da visualização.

  • Fill (padrão): redimensiona o material e o estica para preencher toda a visualização. O objeto preenche completamente a área. Se a proporção do objeto não corresponder à visualização, o objeto será esticado com base na largura e altura da visualização.

In

Float

Não

Tempo inicial do material no arquivo de source. O arquivo de source deve ser de áudio ou vídeo. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar In, o valor 0 será usado.

Out

Float

Não

Tempo final do material no arquivo de source. O arquivo de source deve ser de áudio ou vídeo. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar Out, o material terminará quando o arquivo de source terminar.

MaxOut

Float

Não

Tempo final máximo do material. Ao especificar este parâmetro, o tempo final do material será o menor valor entre a duração do arquivo de source e o valor de MaxOut. Este parâmetro só tem efeito se o arquivo de source for de áudio ou vídeo. Unidade: segundos. Precisão de quatro casas decimais. Se você especificar Out, MaxOut torna-se inválido. Para obter mais informações, consulte Cortar e mesclar vários segmentos de vídeo.

Duration

Float

Não

Duração do material. Geralmente usado para imagens. Unidade: segundos. Precisão de quatro casas decimais.

DyncFrames

Int

Não

Número de quadros do adesivo animado. Este parâmetro só tem efeito se o arquivo de source for uma imagem animada. Para obter mais informações, consulte Adicionar um adesivo GIF.

TimelineIn

Float

Não

Tempo inicial do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o material começará a ser reproduzido assim que a reprodução do material anterior na timeline terminar.

TimelineOut

Float

Não

Tempo final do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, o material parará de ser reproduzido quando a reprodução do próximo material na timeline começar.

Speed

Float

Não

Velocidade de reprodução do material. Valores válidos: 0,1 a 100. Por exemplo, se você definir este parâmetro como 2, o material será reproduzido com o dobro da velocidade original no vídeo de saída e a duração será reduzida à metade.

Para obter mais informações, consulte Alterar a velocidade de áudio e vídeo.

Opacity

Float

Não

Opacidade do vídeo. Valores válidos: 0 a 1. O valor 0 indica transparência total. O valor 1 indica opacidade total.

MaskVideoUrl

String

Não

URL do arquivo de máscara. Geralmente, é um vídeo com canais alfa. Use canais alfa para adicionar transparência ao vídeo original.

  • Você pode especificar uma URL pública do OSS ou uma URL pública acessível pela internet neste parâmetro.

ClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ReferenceClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final desses materiais serão alinhados aos do material atual.

Para obter mais informações, consulte Alinhar materiais e duração do material automaticamente.

ReferenceClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final do material atual serão alinhados aos dos materiais nas outras faixas.

Para obter mais informações, consulte https://icms.alibaba-inc.com/content/ice/ims?l=1&m=65087&n=4406040.

Effects

Effect[]

Não

Efeitos aplicados ao material.

Vídeo de humano digital

Defina Type como AI_Avatar em VideoTrackClip para gerar diretamente um vídeo de humano digital para edição. Para obter mais informações, consulte Processar tarefas de timeline inteligente em paralelo.

Nota

Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

Parâmetro

Tipo

Obrigatório

Descrição

Observações

Type

String

Sim

Tipo do material.

  • Defina o valor como AI_Avatar.

MediaId

String

Não

ID do áudio usado para renderizar um humano digital.

  • Especifique apenas MediaId, MediaURL ou Content.

MediaURL

String

Não

URL do arquivo de áudio usado para renderizar um humano digital.

  • Especifique apenas MediaId, MediaURL ou Content.

  • Você pode especificar uma URL pública do OSS ou uma URL pública acessível pela internet neste parâmetro.

Content

String

Não

Conteúdo de texto usado para renderizar um humano digital.

  • Especifique apenas MediaId, MediaURL ou Content.

  • O valor deste parâmetro deve conter pelo menos cinco caracteres.

AvatarId

String

Não

ID da imagem do humano digital.

Voice

String

Não

Tipo de voz.

CustomizedVoice

String

Não

Voz humana personalizada.

  • Especifique o ID da voz treinada com o recurso de clonagem de voz humana. Use sua voz personalizada para gerar áudio.

  • Se você especificar este parâmetro, Voice torna-se inválido.

LoopMotion

Boolean

Não

Defina se o primeiro e o último quadro do vídeo são idênticos.

  • Se você definir este parâmetro como true, o primeiro e o último quadro do vídeo gerado para o humano digital serão idênticos. Isso evita saltos de quadro nos movimentos e expressões durante a reprodução em loop ou ao mesclar vídeos de humanos digitais.

  • Valores válidos: true e false.

  • Valor padrão: false.

SpeechRate

Integer

Não

Ritmo da fala.

  • Este parâmetro tem efeito se você especificar Content. Valores válidos: -500 a 500. Valor padrão: 0.

    • O valor -500 indica 0,5 vez o ritmo original. O valor 0 indica o ritmo original. O valor 500 indica 2 vezes o ritmo original.

Nota

Exemplos de cálculo do ritmo da fala:

  • 0,8: (1-1/0,8)/0,002 = -125

  • 1,2: (1-1/1,2)/0,001 = 166

Se a velocidade for menor que 1x, use o coeficiente 0,002.

Se a velocidade for maior que 1x, use o coeficiente 0,001.

O resultado real do cálculo é arredondado para o inteiro mais próximo.

PitchRate

Integer

Não

Entonação.

  • Este parâmetro tem efeito se você especificar Content.

  • Valores válidos: -500 a 500.

  • Valor padrão: 0.

Nota

Os demais parâmetros de timeline para um vídeo de humano digital são idênticos aos de VideoTrackClip. Para obter mais informações, consulte a seção VideoTrackClip deste tópico.

AudioTrackClip

Você pode adicionar materiais exclusivamente de áudio, materiais de vídeo com streams de áudio e materiais de áudio convertidos de texto a uma faixa de áudio.

Use os parâmetros In, Out, TimelineIn e TimelineOut para especificar a posição de corte e inserção do material na timeline. Por exemplo, se você definir In como 5, Out como 10, TimelineIn como 15 e TimelineOut como 20, o trecho do material entre o 5º e o 10º segundo será cortado e reproduzido do 15º ao 20º segundo na timeline.

Nota

O tempo de reprodução dos materiais de áudio na mesma faixa não pode se sobrepor na timeline. Caso contrário, poderá ocorrer um erro de áudio.

Material exclusivamente de áudio ou material de vídeo com streams de áudio

Parâmetro

Tipo

Obrigatório

Descrição

MediaId

String

Não

ID do ativo de mídia do IMS ou ApsaraVideo VOD correspondente ao material na faixa de áudio.

Observação: especifique apenas MediaId ou MediaURL.

MediaURL

String

Não

URL do OSS do material na faixa de áudio. A URL do OSS tem o seguinte formato:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

Observação:

  • Especifique apenas MediaId ou MediaURL.

  • Você pode especificar uma URL pública do OSS ou uma URL pública acessível pela internet neste parâmetro.

Para obter mais informações, consulte Edição de imagem e vídeo.

In

Float

Não

Tempo inicial do material no arquivo de source. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar In, o valor 0 será usado.

Out

Float

Não

Tempo final do material no arquivo de source. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar Out, o material terminará quando o arquivo de source terminar.

TimelineIn

Float

Não

Tempo inicial do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o material começará a ser reproduzido assim que a reprodução do material anterior na timeline terminar.

TimelineOut

Float

Não

Tempo final do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, o material parará de ser reproduzido quando a reprodução do próximo material na timeline começar.

Speed

Float

Não

Velocidade de reprodução do material. Valores válidos: 0,1 a 100. Por exemplo, se você definir este parâmetro como 2, o material será reproduzido com o dobro da velocidade original no áudio de saída e a duração será reduzida à metade.

Para obter mais informações, consulte Alterar a velocidade de áudio e vídeo.

Effects

Effect[]

Não

Efeitos aplicados ao material.

LoopMode

Boolean

Não

Defina se a reprodução em loop do material na timeline está ativada. True: ative a reprodução em loop. False (padrão): desativa a reprodução em loop.

Para obter mais informações, consulte Configurar reprodução de áudio em loop.

ClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ReferenceClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final desses materiais serão alinhados aos do material atual.

Para obter mais informações, consulte Alinhar materiais e duração do material automaticamente.

ReferenceClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final do material atual serão alinhados aos dos materiais nas outras faixas.

Para obter mais informações, consulte Alinhar materiais e duração do material automaticamente.

Material de áudio convertido de texto

Para obter mais informações sobre exemplos de timelines, consulte Converter texto em áudio e adicionar o áudio a um vídeo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do material. Defina o valor como AI_TTS.

Content

String

Sim

Conteúdo de texto.

Voice

String

Não

Tipo de voz. Para obter mais informações, consulte Demonstrações de voz inteligente.

CustomizedVoice

String

Não

  • Voz humana personalizada.

  • Especifique o ID da voz treinada com o recurso de clonagem de voz humana. Use sua voz personalizada para gerar áudio.

  • Se você especificar este parâmetro, Voice torna-se inválido.

Format

String

Não

Formato do arquivo. Valores válidos: pcm, wav e mp3. Valor padrão: mp3.

SpeechRate

Int

Não

Ritmo da fala. Valores válidos: -500 a 500. Valor padrão: 0.

  • O valor -500 indica 0,5 vez o ritmo original. O valor 0 indica o ritmo original. O valor 500 indica 2 vezes o ritmo original. Por padrão, o ritmo de fala de saída do modelo é 1x. O ritmo varia conforme o locutor. Na maioria dos casos, um locutor pronuncia quatro caracteres por segundo.

Nota

Exemplos de cálculo do ritmo da fala:

  • 0,8: (1-1/0,8)/0,002 = -125

  • 1,2: (1-1/1,2)/0,001 = 166

Se a velocidade for menor que 1x, use o coeficiente 0,002.

Se a velocidade for maior que 1x, use o coeficiente 0,001.

O resultado real do cálculo é arredondado para o inteiro mais próximo.

PitchRate

Int

Não

Entonação. Valores válidos: -500 a 500. Valor padrão: 0.

TimelineIn

Float

Não

Tempo inicial do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o material começará a ser reproduzido assim que a reprodução do material anterior na timeline terminar.

TimelineOut

Float

Não

Tempo final do material na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, o material parará de ser reproduzido quando a reprodução do próximo material na timeline começar.

Effects

Effect[]

Não

Efeitos aplicados ao material.

ClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ReferenceClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final desses materiais serão alinhados aos do material atual.

Para obter mais informações, consulte Alinhar materiais e duração do material automaticamente.

ReferenceClipId

String

Não

Valor de alinhamento da faixa. Se o mesmo valor de ClipId for definido para materiais em outras faixas de áudio ou vídeo, os tempos inicial e final do material atual serão alinhados aos dos materiais nas outras faixas.

Para obter mais informações, consulte Alinhar materiais e duração do material automaticamente.

ImageTrackClip

Importante

A funcionalidade de faixa de imagem foi integrada à de faixa de vídeo e não recebe mais iterações ou manutenção.

Adicione materiais de imagem a uma faixa de imagem.

Parâmetro

Tipo

Obrigatório

Descrição

MediaId

String

Não

ID do ativo de mídia do IMS ou ApsaraVideo VOD correspondente ao material na faixa de imagem.

Observação: especifique apenas MediaId ou MediaURL.

MediaURL

String

Não

URL do OSS do material na faixa de imagem. A URL do OSS tem o seguinte formato: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4.

Observação:

  • Especifique apenas MediaId ou MediaURL.

  • Você pode especificar apenas uma URL pública do OSS neste parâmetro.

Para obter mais informações, consulte Alterar a velocidade de áudio e vídeo.

X

Float

Não

Distância horizontal entre o canto superior esquerdo do material e o canto superior esquerdo do vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Y

Float

Não

Distância vertical entre o canto superior esquerdo do material e o canto superior esquerdo do vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Width

Float

Não

Largura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Height

Float

Não

Altura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

TimelineIn

Float

Não

Tempo inicial da imagem na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o valor 0 será usado.

TimelineOut

Float

Não

Tempo final da imagem na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, a duração máxima da faixa de vídeo será usada.

DyncFrames

Int

Não

Número de quadros do adesivo animado. Este parâmetro é obrigatório se o arquivo de source for uma imagem animada. Para obter mais informações, consulte Adicionar marcas d'água, adesivos ou adesivos GIF.

Effects

Effect[]

Não

Efeitos aplicados ao material.

SubtitleTrackClip

Adicione materiais de legenda a uma faixa de legenda.

Nota

O tempo de reprodução dos materiais de legenda na mesma faixa não pode se sobrepor na timeline. Caso contrário, poderão ocorrer problemas como erros de legenda.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do material de legenda. Valores válidos:

SubType

String

Não

Subtipo do material de legenda. Valores válidos:

  • srt: arquivo de legenda externa no formato SubRip Subtitle (SRT)

  • ass: arquivo de legenda externa no formato Advanced SubStation Alpha (ASS)

Ignore este parâmetro se definir Type como Text.

FileURL

String

Não

URL do OSS do arquivo de legenda. Este parâmetro é obrigatório se você definir Type como Subtitle. A URL do OSS tem o seguinte formato:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt.

Observação:

  • Você pode especificar uma URL pública do OSS ou uma URL pública acessível pela internet neste parâmetro.

Para obter mais informações, consulte Legendas e modelos de legenda.

X

Float

Não

Distância horizontal entre o canto superior esquerdo do texto de banner e o canto superior esquerdo do vídeo de saída. Este parâmetro tem efeito se você definir Type como Text. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Y

Float

Não

Distância vertical entre o canto superior esquerdo do texto de banner e o canto superior esquerdo do vídeo de saída. Este parâmetro tem efeito se você definir Type como Text. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

TimelineIn

Float

Não

Tempo inicial do texto de banner na timeline. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o material começará a ser exibido assim que a exibição do material anterior na timeline terminar.

TimelineOut

Float

Não

Tempo final do texto de banner na timeline. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, o material parará de ser exibido quando a exibição do próximo material na timeline começar.

ClipId

Float

Não

Parâmetro usado para alinhar faixas. Se o ReferenceClipId do material em outra faixa for definido com o mesmo valor, os tempos inicial e final desse material serão alinhados ao clipe atual.

Ao especificar este parâmetro, defina TimelineIn e TimelineOut para o clipe atual ou ative a duração de rolagem adaptativa.

ReferenceClipId

String

Não

Parâmetro usado para alinhar faixas. Se o ClipId do material em outra faixa for definido com o mesmo valor, os tempos inicial e final do clipe atual serão alinhados a esse material.

Content

String

Não

Texto de banner. Este parâmetro é obrigatório se você definir Type como Text.

Font

String

Não

Fonte do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Valor padrão: SimSun. Para obter mais informações sobre as fontes suportadas, consulte Lista de fontes.

FontSize

Int

Não

Tamanho da fonte do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Valor padrão: 0. Valor máximo: 5000.

SizeRequestType

String

Não

Método de cálculo do tamanho da fonte renderizada do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Valor padrão: RealDim.

  • Nominal: a altura de renderização da legenda (em pixels) é igual ao tamanho da fonte.

  • RealDim: para algumas fontes, a altura de renderização da legenda (em pixels) pode ser menor que o tamanho da fonte.

FontColor

String

Não

Cor do texto de banner. Este parâmetro tem efeito se você definir Type como Text. O valor segue o formato de um sinal de cerquilha (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

FontColorOpacity

Float

Não

Opacidade do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Valores válidos: 0 a 1. Valor padrão: 1. O valor 1 indica opacidade total. O valor 0 indica transparência total.

FontFace

FontFace

Não

Aparência do texto de banner. Este parâmetro tem efeito se você definir Type como Text.

Spacing

Int

Não

Espaçamento entre palavras do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: pixel. Valor padrão: 0.

LineSpacing

Int

Não

Espaçamento entre linhas do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: pixel. Valor padrão: 0.

Angle

Float

Não

Ângulo de rotação do texto de banner no sentido anti-horário. Este parâmetro tem efeito se você definir Type como Text. Unidade: grau. Valor padrão: 0.

BorderStyle

Int

Não

Estilo da borda do texto de banner. Valores válidos: 1 e 3. O valor 1 indica que o texto tem borda e sombra. O valor 3 indica que o texto tem fundo. Valor padrão: 1.

Outline

Int

Não

Largura do contorno do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: pixel. Valor padrão: 0.

OutlineColour

String

Não

Cor do contorno do texto de banner. Este parâmetro tem efeito se você definir Type como Text. O valor segue o formato de um sinal de cerquilha (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Shadow

Int

Não

Tamanho da sombra do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: pixel. Valor padrão: 0.

BackColour

String

Não

Cor da sombra do texto de banner. Este parâmetro tem efeito se você definir Type como Text. O valor segue o formato de um sinal de cerquilha (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Alignment

String

Não

Modo de alinhamento do texto. Este parâmetro tem efeito se você definir Type como Text. Valor padrão: TopLeft. Valores válidos:

  • TopLeft

  • TopCenter

  • TopRight

  • CenterLeft

  • CenterCenter

  • CenterRight

  • BottomLeft

  • BottomCenter

  • BottomRight

Para especificar posições precisas das legendas em diferentes modos de alinhamento, recomendamos configurar o alinhamento do texto da seguinte forma:

  • Alinhamento à esquerda: especifique as coordenadas do vértice superior esquerdo da legenda em relação ao canto superior esquerdo do vídeo para X e Y.

  • Alinhamento centralizado: especifique as coordenadas da interseção da borda no eixo central da legenda em relação ao canto superior esquerdo do vídeo para X e Y.

  • Alinhamento à direita: especifique as coordenadas do vértice superior direito da legenda em relação ao canto superior esquerdo do vídeo para X e Y.

AdaptMode

String

Não

Defina se a quebra de linha automática ou o dimensionamento automático será ativado quando o texto de banner exceder a largura do vídeo ou a largura da caixa de texto especificada. Valores válidos:

  • AutoWrap: ative a quebra de linha automática.

  • AutoScale: ative o dimensionamento automático.

  • AutoWrapAtSpaces: ative a quebra de linha automática e quebra o texto apenas na posição de um espaço. Esta opção aplica-se somente a texto em inglês.

  • AutoWrapAtSpacesStrict: impõe quebra de palavra estrita baseada em caracteres de espaço. Se uma palavra exceder o limite do contêiner, a palavra inteira será movida para a próxima linha em vez de ser dividida.

TextWidth

Float

Não

Largura da caixa de texto. Este parâmetro tem efeito se você especificar AdaptMode. Use este parâmetro ao ativar a quebra de linha automática ou o dimensionamento automático. Se você não especificar este parâmetro, a largura do vídeo será usada para a quebra de linha automática ou dimensionamento automático. Se o valor for maior que 0 e menor ou igual a 1, ele indica a porcentagem da largura da caixa de texto em relação à largura do vídeo de saída. Se o valor for maior que 1, ele indica o número de pixels.

FontUrl

String

Não

URL do OSS do arquivo de fonte. Este parâmetro tem efeito se você definir Type como Text. Formatos de arquivos de fonte suportados: TTF, OTF e WOFF. Exemplo: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf.

EffectColorStyle

String

Não

Efeito de arte de palavra do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Para obter mais informações sobre efeitos de arte de palavra, consulte Arte de palavra.

SubtitleEffects

SubtitleEffect[]

Não

Efeitos multicamadas do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Configure contornos multicamadas, sombras multicamadas, desfoques gaussianos e efeitos de fundo de legenda. Desfoques gaussianos são suportados apenas se o texto da legenda estiver configurado para ter sombra.

Observação:

  • Se você especificar SubtitleEffects, Outline e Shadow em SubtitleTrackClip tornar-se-ão inválidos.

  • Ao configurar contornos multicamadas, sombras multicamadas ou efeitos de fundo de legenda, os efeitos de legenda serão sobrepostos seguindo a sequência dos elementos do array SubtitleEffects. A camada correspondente ao primeiro efeito de legenda no array fica na parte inferior, e a camada correspondente ao último efeito fica no topo.

ScrollStartY

Float

Não

Valor da coordenada y do ponto inicial para rolar a legenda para cima ou para baixo. Este parâmetro tem efeito se o efeito de rolagem de legenda estiver configurado. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollEndY

Float

Não

Valor da coordenada y do ponto final para rolar a legenda para cima ou para baixo. Este parâmetro tem efeito se o efeito de rolagem de legenda estiver configurado. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollSpeed

Float

Não

Velocidade de rolagem da legenda para cima ou para baixo. Este parâmetro tem efeito se o efeito de rolagem de legenda estiver configurado. Unidade: pixel por segundo.

ScrollStartShift

Float

Não

Deslocamento da posição de rolagem vertical em relação ao ponto inicial. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollEndShift

Float

Não

Deslocamento da posição de rolagem vertical em relação ao ponto final. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollStartFreeze

Float

Não

Duração da pausa no ponto inicial da rolagem vertical. Unidade: segundos.

ScrollEndFreeze

Float

Não

Duração da pausa no ponto final da rolagem vertical. Unidade: segundos.

ScrollDirection

String

Não

Direção da rolagem horizontal. Valores válidos:

  • Left

  • Right

ScrollStartX

Float

Não

Valor da coordenada x do ponto inicial para rolagem horizontal. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollEndX

Float

Não

Valor da coordenada x do ponto final para rolagem horizontal. Unidade: pixel. Se o valor for menor que 1, representa uma medida relativa à altura do vídeo de saída.

ScrollLoop

Boolean

Não

Defina se o efeito de rolagem horizontal será repetido em loop.

AaiMotionInEffect

String

Não

Efeito de entrada do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Para obter mais informações sobre efeitos de entrada de legendas, consulte Exemplos de efeitos de legenda.

AaiMotionIn

Float

Não

Duração do efeito de entrada do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar AaiMotionIn, a duração padrão de 0,5 segundos será usada. Se o texto for exibido por menos de 0,5 segundos, a duração do efeito de entrada será a duração total do texto menos a duração do efeito de saída.

AaiMotionOutEffect

String

Não

Efeito de saída do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Para obter mais informações sobre efeitos de saída de legendas, consulte Exemplos de efeitos de legenda.

AaiMotionOut

Float

Não

Duração do efeito de saída do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar AaiMotionOut, a duração padrão de 0,5 segundos será usada. Se o texto for exibido por menos de 0,5 segundos, a duração do efeito de saída será igual à duração total do texto.

AaiMotionLoopEffect

String

Não

Efeito de loop do texto de banner. Este parâmetro tem efeito se você definir Type como Text. O efeito de loop não pode atuar simultaneamente com o efeito de entrada ou o efeito de saída. Para obter mais informações sobre efeitos de loop de texto, consulte Exemplos de efeitos de legenda.

Ratio

Float

Não

Velocidade do efeito de loop do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Precisão de quatro casas decimais. Se você não especificar este parâmetro, o valor 1 será usado. Um valor maior que 1 indica maior velocidade, e um valor menor que 1 indica menor velocidade.

TextureURL

String

Não

URL da textura do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Apenas objetos do OSS nos formatos PNG, JPG, JPEG ou BMP são suportados. Exemplo: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png.

BubbleStyleId

String

Não

ID do efeito de bolha do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Para obter mais informações sobre efeitos de bolha, consulte Exemplos de efeitos de bolha de texto.

BubbleWidth

Float

Não

Largura do mapa base da bolha em relação ao vídeo de saída. Este parâmetro tem efeito apenas se legendas em bolha forem usadas. Um valor maior que 1 indica pixels. Um valor menor ou igual a 1 indica porcentagem.

BubbleHeight

Float

Não

Altura do mapa base da bolha em relação ao vídeo de saída. Este parâmetro tem efeito apenas se legendas em bolha forem usadas. Um valor maior que 1 indica pixels. Um valor menor ou igual a 1 indica porcentagem.

EffectTrackItem

Adicione efeitos visuais e filtros a uma faixa de efeitos.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do efeito. Valores válidos: VFX e Filter.

SubType

String

Sim

Subtipo do efeito.

TimelineIn

Float

Não

Tempo inicial do efeito na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineIn, o valor 0 será usado.

TimelineOut

Float

Não

Tempo final do efeito na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar TimelineOut, o efeito terminará quando o vídeo terminar.

Duration

Float

Não

Duração do efeito na timeline. Unidade: segundos. Precisão de quatro casas decimais. Se você não especificar Duration, a duração do vídeo será usada.

Não é possível especificar Duration e TimelineOut simultaneamente.

X

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur. Distância horizontal entre o canto superior esquerdo da área de efeito e o canto superior esquerdo do vídeo de saída.

Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Y

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur.

Distância vertical entre o canto superior esquerdo da área de efeito e o canto superior esquerdo do vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Width

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur. Largura da área de efeito no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

Height

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur. Altura da área de efeito no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Valores entre 0 e 0,9999 indicam porcentagem. Valores inteiros maiores ou iguais a 2 indicam pixels.

SubtitleEffect

Adicione contornos ou sombras a uma faixa de legenda.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do efeito. Valores válidos: Outline, Shadow e Box.

Bord

Float

Não

Largura ou altura do contorno ou da sombra. Um valor maior que 1 indica pixels. Um valor maior que 0 e menor que 1 indica a largura ou altura relativa ao tamanho do texto.

XBord

Float

Não

Largura do contorno ou da sombra. Um valor maior que 1 indica pixels. Um valor maior que 0 e menor que 1 indica a largura relativa ao tamanho do texto. A prioridade deste parâmetro é superior à de Bord.

YBord

Float

Não

Altura do contorno ou da sombra. Um valor maior que 1 indica pixels. Um valor maior que 0 e menor que 1 indica a altura relativa ao tamanho do texto. A prioridade deste parâmetro é superior à de Bord.

Shift

Float

Não

Deslocamento horizontal ou vertical do contorno ou da sombra. Um valor absoluto maior que 1 indica pixels. Um valor absoluto maior que 0 e menor que 1 indica o deslocamento relativo ao tamanho do texto. Você pode definir este parâmetro como um número negativo, indicando deslocamento para cima ou para a esquerda.

XShift

Float

Não

Deslocamento horizontal do contorno ou da sombra. Um valor absoluto maior que 1 indica pixels. Um valor absoluto maior que 0 e menor que 1 indica o deslocamento horizontal relativo ao tamanho do texto. A prioridade deste parâmetro é superior à de Shift.

YShift

Float

Não

Deslocamento vertical do contorno ou da sombra. Um valor absoluto maior que 1 indica pixels. Um valor absoluto maior que 0 e menor que 1 indica o deslocamento vertical relativo ao tamanho do texto. A prioridade deste parâmetro é superior à de Shift.

Color

String

Não

Cor RGB. O valor segue o formato de um sinal de cerquilha (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Opacity

String

Não

Opacidade da legenda. O valor 1 indica opacidade total. O valor 0 indica transparência total.

Blur

Float

Não

Alcance do desfoque gaussiano em pixels. Este parâmetro tem efeito apenas se você definir Type como Shadow. Após configurar este parâmetro, o contorno da legenda ficará brilhante.

Radius

Float

Não

Raio da borda do fundo de cor sólida do texto. Este parâmetro tem efeito apenas se você definir Type como Box. Após configurar este parâmetro, o fundo da legenda terá cantos arredondados.

ImageUrl

String

Não

URL da imagem de fundo personalizada da legenda. Este parâmetro tem efeito apenas se você definir Type como Box. Após configurar este parâmetro, um efeito de bolha personalizado pode ser implementado. Use BubbleWidth ou BubbleHeight para alterar o tamanho da legenda. Apenas objetos do OSS nos formatos PNG, JPG, JPEG ou BMP são suportados. Exemplo: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png.

Width

Float

Não

Largura do mapa base da bolha de source. Este parâmetro é obrigatório se legendas em bolha personalizadas forem usadas.

Height

Float

Não

Altura do mapa base da bolha de source. Este parâmetro é obrigatório se legendas em bolha personalizadas forem usadas.

TextArea

String

Não

Área de texto no mapa base da bolha. Este parâmetro é obrigatório se legendas em bolha personalizadas forem usadas. A área de texto contém quatro números de ponto flutuante cujos valores variam de 0 a 1, separados por vírgulas (,). Por exemplo, se você especificar 0,1,0,2,0,8,0,6, as coordenadas do canto superior esquerdo da caixa de texto em relação à bolha serão 0,1 e 0,2, e a largura e altura da caixa de texto em relação à bolha serão 0,8 e 0,6.

FontFace

A tabela a seguir descreve os parâmetros de estilo de fonte.

Parâmetro

Tipo

Obrigatório

Descrição

Bold

Boolean

Não

Defina se a fonte está em negrito.

Italic

Boolean

Não

Defina se a fonte está em itálico.

Underline

Boolean

Não

Defina se a fonte está sublinhada.

Effect

Efeitos de material

Configure os seguintes parâmetros para definir efeitos. Alguns parâmetros são compartilhados entre vários tipos de efeitos.

Para obter mais informações sobre parâmetros de efeitos, consulte Configurações de efeitos.

A tabela a seguir descreve os parâmetros comuns dos efeitos.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do efeito. Valores válidos:

  • Text: adiciona texto de banner a um material em uma faixa de vídeo.

  • DeWatermark: desfoca a marca d'água em um material em uma faixa de vídeo.

  • Crop: corta um material em uma faixa de vídeo.

  • Pad: adiciona preenchimentos a um material em uma faixa de vídeo.

  • Scale: dimensiona um material em uma faixa de vídeo.

  • Transition: adiciona um efeito de transição a um material em uma faixa de vídeo.

  • VFX: adiciona um efeito visual a um material em uma faixa de vídeo.

  • Volume: ajusta o volume de um material em uma faixa de áudio.

  • AFade: configure fade-in e fade-out de áudio para um material em uma faixa de áudio.

  • AI_ASR: gera legendas a partir do áudio em uma faixa de áudio ou vídeo.

SubType

String

Não

Subtipo do efeito.

  • Se você definir Type como Transition, este parâmetro especifica o subtipo do efeito de transição.

  • Se você definir Type como VFX, este parâmetro especifica o subtipo do efeito visual.

  • Se você definir Type como Filter, este parâmetro especifica o subtipo do efeito de filtro. Para obter mais informações, consulte Exemplos de filtros.