Intelligent Media Services:Configurações de timeline

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.)

As faixas de vídeo. A sobreposição das faixas de vídeo 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 do array MediaId.

AudioTracks

AudioTrack[]

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

As faixas de áudio.

ImageTracks (A funcionalidade de faixa de imagem foi integrada à funcionalidade 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.)

As faixas de imagem. Observação:

1. As faixas de imagem devem ficar acima das faixas de vídeo. Para combinar uma imagem com um vídeo como material em cenários de produção de imagem e vídeo, use 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 do array MediaId.

SubtitleTracks

SubtitleTrack[]

Não

As faixas de legenda.

EffectTracks

EffectTrack[]

Não

As faixas de efeitos.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Não

O tipo da faixa de vídeo. Por padrão, o sistema usa 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

Define se a faixa de vídeo atual é a faixa principal. Valor padrão: False. Para obter mais informações, consulte Set a main track.

TrackShortenMode

String

Não

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

• AutoSpeed: acelera o vídeo automaticamente.

TrackExpandMode

String

Não

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

• AutoSpeed: desacelera o vídeo automaticamente.

VideoTrackClips

VideoTrackClip[]

Sim

Os materiais na faixa de vídeo.

Parâmetro

Tipo

Obrigatório

Descrição

MainTrack

Boolean

Não

Define se a faixa de áudio atual é a faixa principal. Valor padrão: False. Para obter mais informações, consulte Set a main track.

TrackShortenMode

String

Não

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

• AutoSpeed: acelera o áudio automaticamente.

TrackExpandMode

String

Não

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

• AutoSpeed: desacelera o áudio automaticamente.

AudioTrackClips

AudioTrackClip[]

Sim

Os materiais na faixa de áudio.

Parâmetro

Tipo

Obrigatório

Descrição

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

ImageTrackClip[]

Sim

Os materiais na faixa de imagem.

Parâmetro

Tipo

Obrigatório

Descrição

SubtitleTrackClips

SubtitleTrackClip[]

Sim

Os materiais na faixa de legenda.

Parâmetro

Tipo

Obrigatório

Descrição

Observações

Type

String

Sim

O tipo do material.

• Defina o valor como AI_Avatar.

MediaId

String

Não

O ID do áudio usado para renderizar um humano digital.

• Especifique apenas um entre MediaId, MediaURL e Content.

MediaURL

String

Não

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

• Especifique apenas um entre MediaId, MediaURL e Content.

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

Content

String

Não

O conteúdo de texto usado para renderizar um humano digital.

• Especifique apenas um entre MediaId, MediaURL e Content.

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

AvatarId

String

Não

O ID da imagem do humano digital.

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

Voice

String

Não

O tipo de voz.

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

• Para efeitos de voz, consulte Intelligent voice demos.

CustomizedVoice

String

Não

A voz humana personalizada.

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

• Se você especificar este parâmetro, Voice perderá o efeito.

LoopMotion

Boolean

Não

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

• Ao definir este parâmetro como true, o primeiro e o último quadro do vídeo gerado para o humano digital serão iguais. Isso evita saltos de quadro nos movimentos e expressões do humano digital 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

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 que o ritmo da fala é 0,5 vez o ritmo original. O valor 0 indica o uso do ritmo original. O valor 500 indica que o ritmo da fala é 2 vezes o ritmo original.

PitchRate

Integer

Não

A entonação.

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

• Valores válidos: -500 a 500.

• Valor padrão: 0.

Parâmetro

Tipo

Obrigatório

Descrição

MediaId

String

Não

O ID do ativo de mídia do IMS ou ApsaraVideo VOD ao qual o material na faixa de imagem corresponde.

Observação: especifique apenas um entre MediaId e MediaURL.

MediaURL

String

Não

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

Observação:

• Especifique apenas um entre MediaId e MediaURL.

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

Para obter mais informações, consulte Change audio and video speed.

X

Float

Não

A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Y

Float

Não

A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Width

Float

Não

A largura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Height

Float

Não

A altura do material no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

TimelineIn

Float

Não

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

TimelineOut

Float

Não

O tempo final da imagem na timeline. Unidade: segundos. O valor possui 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

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 Add watermarks, stickers, or GIF stickers.

Effects

Effect[]

Não

Os efeitos aplicados ao material.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

O tipo do material de legenda. Valores válidos:

• Subtitle: an external subtitle file

• Text: texto de banner

SubType

String

Não

O subtipo do material de legenda. Valores válidos:

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

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

Ignore este parâmetro se você definir Type como Text.

FileURL

String

Não

A URL do OSS do arquivo de legenda. Este parâmetro é obrigatório se você definir Type como Subtitle. A URL do OSS segue o 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 para este parâmetro.

Para obter mais informações, consulte Subtitles and subtitle templates.

X

Float

Não

A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Y

Float

Não

A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

TimelineIn

Float

Não

O tempo inicial do texto de banner na timeline. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. O valor possui 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

O tempo final do texto de banner na timeline. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. O valor possui 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

Este parâmetro serve 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

Este parâmetro serve 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

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

Font

String

Não

A 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 Font list.

FontSize

Int

Não

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

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

A 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 número (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

FontColorOpacity

Float

Não

A 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 que o texto é completamente opaco. O valor 0 indica que o texto é completamente transparente.

FontFace

FontFace

Não

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

Spacing

Int

Não

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

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

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

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

Outline

Int

Não

A 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

A 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 número (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Shadow

Int

Não

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

A 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 número (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Alignment

String

Não

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

Define 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: ativa a quebra de linha automática.

• AutoScale: ativa o dimensionamento automático.

• AutoWrapAtSpaces: ativa 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 textos em inglês.

• AutoWrapAtSpacesStrict: impõe uma 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

A 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 o dimensionamento automático. Se o valor for maior que 0 e menor ou igual a 1, ele representa 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 representa o número de pixels.

FontUrl

String

Não

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

EffectColorStyle

String

Não

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

SubtitleEffects

SubtitleEffect[]

Não

Os 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. Os 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 perderão o efeito.

• 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 ficará na parte inferior, e a camada correspondente ao último efeito de legenda no array ficará na parte superior.

EnableLocalStyleAutoScale

Boolean

Não

Ao configurar o estilo local da legenda, define se o tamanho da fonte, o tamanho do traço e o tamanho da sombra do estilo local serão dimensionados conforme o tamanho do vídeo de saída e o tamanho do FECanvas. O valor padrão é False, ou seja, o estilo local não é dimensionado.

SupportBidi

Boolean

Não

Define se a renderização de texto bidirecional estará ativada. Quando um texto de legenda contém tanto texto da esquerda para a direita (LTR, como inglês, números, letras latinas) quanto texto da direita para a esquerda (RTL), recomenda-se ativar esta opção. Desativado por padrão.

ScrollStartY

Float

Não

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, ele representa uma medida relativa à altura do vídeo de saída.

ScrollEndY

Float

Não

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, ele representa uma medida relativa à altura do vídeo de saída.

ScrollSpeed

Float

Não

A 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

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

ScrollEndShift

Float

Não

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

ScrollStartFreeze

Float

Não

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

ScrollEndFreeze

Float

Não

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

ScrollDirection

String

Não

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

• Left

• Right

ScrollStartX

Float

Não

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

ScrollEndX

Float

Não

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

ScrollLoop

Boolean

Não

Define se o efeito de rolagem horizontal será executado em loop.

AaiMotionInEffect

String

Não

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 Subtitle effect examples.

AaiMotionIn

Float

Não

A duração do efeito de entrada do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Unidade: segundos. O valor possui precisão de quatro casas decimais. Se você não especificar AaiMotionIn, a duração padrão de 0,5 segundo será usada. Se o texto for exibido por menos de 0,5 segundo, 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

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 Subtitle effect examples.

AaiMotionOut

Float

Não

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

AaiMotionLoopEffect

String

Não

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 ser aplicado simultaneamente com o efeito de entrada ou o efeito de saída. Para obter mais informações sobre efeitos de loop de texto, consulte Subtitle effect examples.

Ratio

Float

Não

A velocidade do efeito de loop do texto de banner. Este parâmetro tem efeito se você definir Type como Text. O valor possui 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 uma velocidade maior, e um valor menor que 1 indica uma velocidade menor.

TextureURL

String

Não

A 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

O ID do efeito de balão do texto de banner. Este parâmetro tem efeito se você definir Type como Text. Para obter mais informações sobre efeitos de balão, consulte Text bubble effect examples.

BubbleWidth

Float

Não

A largura do mapa base do balão em relação ao vídeo de saída. Este parâmetro tem efeito apenas se legendas em balão forem usadas. Um valor maior que 1 indica um número de pixels. Um valor menor ou igual a 1 indica uma porcentagem.

BubbleHeight

Float

Não

A altura do mapa base do balão em relação ao vídeo de saída. Este parâmetro tem efeito apenas se legendas em balão forem usadas. Um valor maior que 1 indica um número de pixels. Um valor menor ou igual a 1 indica uma porcentagem.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

O tipo do efeito. Valores válidos: VFX e Filter.

SubType

String

Sim

O subtipo do efeito.

TimelineIn

Float

Não

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

TimelineOut

Float

Não

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

Duration

Float

Não

A duração do efeito na timeline. Unidade: segundos. O valor possui 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. A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Y

Float

Não

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

A 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. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Width

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur. A largura da área de efeito no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Height

Float

Não

Este parâmetro tem efeito apenas se você definir SubType como mosaic_rect/blur. A altura da área de efeito no vídeo de saída. Defina o valor como porcentagem ou número de pixels. Se o valor estiver entre 0 e 0,9999, ele representa uma porcentagem. Se for um número inteiro maior ou igual a 2, representa uma quantidade de pixels.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

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

Bord

Float

Não

A largura ou altura do contorno ou da sombra. Um valor maior que 1 indica um número de pixels. Um valor maior que 0 e menor que 1 indica a largura ou altura relativa ao tamanho do texto.

XBord

Float

Não

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

YBord

Float

Não

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

Shift

Float

Não

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

XShift

Float

Não

O deslocamento horizontal do contorno ou da sombra. Um valor absoluto maior que 1 indica um número de 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 é menor que a de Shift.

YShift

Float

Não

O deslocamento vertical do contorno ou da sombra. Um valor absoluto maior que 1 indica um número de 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 é menor que a de Shift.

Color

String

Não

A cor RGB. O valor segue o formato de um sinal de número (#) seguido de um valor hexadecimal. Exemplo: #ffffff.

Opacity

String

Não

A opacidade da legenda. O valor 1 indica que a legenda é completamente opaca. O valor 0 indica que a legenda é completamente transparente.

Blur

Float

Não

O intervalo de 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

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

A 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 balão 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

A largura do mapa base do balão de source. Este parâmetro é obrigatório se legendas em balão personalizadas forem usadas.

Height

Float

Não

A altura do mapa base do balão de source. Este parâmetro é obrigatório se legendas em balão personalizadas forem usadas.

TextArea

String

Não

A área de texto no mapa base do balão. Este parâmetro é obrigatório se legendas em balão 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 ao balão serão 0,1 e 0,2, e a largura e a altura da caixa de texto em relação ao balão serão 0,8 e 0,6.

Parâmetro

Tipo

Obrigatório

Descrição

Bold

Boolean

Não

Define se a fonte está em negrito.

Italic

Boolean

Não

Define se a fonte está em itálico.

Underline

Boolean

Não

Define se a fonte está sublinhada.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

O 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: recorta 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: configura 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

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 Filter examples.