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 |
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 |
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). |
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 |
Não |
Faixas de legenda. |
|
|
EffectTracks |
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:
|
|
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:
|
|
VideoTrackClips |
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:
|
|
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:
|
|
AudioTrackClips |
Sim |
Materiais na faixa de áudio. |
ImageTrack
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) |
Sim |
Materiais na faixa de imagem. |
SubtitleTrack
Organiza legendas, incluindo textos de banner e legendas externas.
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
SubtitleTrackClips |
Sim |
Materiais na faixa de legenda. |
EffectTrack
Adiciona filtros e efeitos visuais a um vídeo.
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
EffectTrackItems |
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:
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:
|
|
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:
|
|
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.
|
|
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.
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. |
|
|
MediaId |
String |
Não |
ID do áudio usado para renderizar um humano digital. |
|
|
MediaURL |
String |
Não |
URL do arquivo de áudio usado para renderizar um humano digital. |
|
|
Content |
String |
Não |
Conteúdo de texto usado para renderizar um humano digital. |
|
|
AvatarId |
String |
Não |
ID da imagem do humano digital. |
|
|
Voice |
String |
Não |
Tipo de voz. |
|
|
CustomizedVoice |
String |
Não |
Voz humana personalizada. |
|
|
LoopMotion |
Boolean |
Não |
Defina se o primeiro e o último quadro do vídeo são idênticos. |
|
|
SpeechRate |
Integer |
Não |
Ritmo da fala. |
Nota
Exemplos de cálculo do ritmo da fala:
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. |
|
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.
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:
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 |
|
|
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.
Nota
Exemplos de cálculo do ritmo da fala:
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
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:
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.
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:
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:
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.
|
|
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 |
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:
Para especificar posições precisas das legendas em diferentes modos de alinhamento, recomendamos configurar o alinhamento do texto da seguinte forma:
|
|
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:
|
|
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 |
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:
|
|
|
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:
|
|
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:
|
|
SubType |
String |
Não |
Subtipo do efeito.
|