Este tópico descreve como editar os parâmetros da Timeline na operação SubmitMediaProducingJob para processar legendas e modelos de legenda.
Observações de uso
A produção inteligente oferece suporte a edição, composição, renderização de efeitos e modelos para transmissões ao vivo, arquivos VOD e materiais do Object Storage Service (OSS). Para mais informações, consulte Visão geral da produção inteligente.
Produza vídeos a partir de um ou mais vídeos, arquivos de áudio, imagens e materiais de legenda configurando os parâmetros da Timeline e chamando a operação SubmitMediaProducingJob.
A timeline é criada ao adicionar materiais e configurar efeitos para gerar um vídeo. Ela consiste em faixas, materiais e efeitos. Para mais detalhes, consulte Configurações da Timeline.
Para saber mais sobre o uso do IMS SDK na edição de arquivos de áudio e vídeo, consulte Introdução.
Adicionar legendas a um vídeo
Adicione legendas a um vídeo criando uma faixa separada (SubtitleTracks) ou definindo-as em Effects.
Defina os horários de início e fim das legendas usando os parâmetros TimelineIn e TimelineOut. Caso esses parâmetros não sejam especificados, as legendas na faixa correspondente terão a duração total do vídeo. Por padrão, legendas adicionadas em Effects duram tanto quanto o clipe de vídeo ao qual pertencem.
Use \N ou \n para exibir legendas em várias linhas.
Efeito | Exemplo de timeline |
|
Configurar tamanho da fonte, fonte do sistema, fonte personalizada, contorno, sombra e ângulo de rotação da legenda
FontSize indica o tamanho da fonte das legendas. Ao adicionar legendas em Effects, recomenda-se usar FixedFontSize para definir o tamanho e evitar que ele mude conforme o tamanho do vídeo.
Font especifica a fonte do sistema, enquanto FontURL define o caminho do objeto OSS com fontes personalizadas. Se ambos estiverem configurados, o sistema priorizará FontURL para renderizar as legendas.
Utilize parâmetros como Outline, OutlineColour, Shadow e BackColour para gerar efeitos simples de contorno e sombra em camada única. Para efeitos complexos de contorno multicamada, consulte o exemplo de configuração de word art personalizado no Exemplo 3.
O parâmetro Angle ajusta o ângulo de rotação das legendas no sentido anti-horário.
Efeito | Exemplo de timeline |
|
Configurar word art
Use o campo EffectColorStyleId para configurar efeitos de word art facilmente. Para obter informações sobre os efeitos, consulte Efeitos de word art.
Para personalizar a aparência das legendas, utilize o campo SubtitleEffects e configure múltiplas camadas de contorno e sombra. Para mais informações, consulte SubtitleEffect.
Efeito | Exemplo de timeline |
|
Configurar efeitos para parte das legendas
Adicione código de sobrescrita ao campo Content para aplicar efeitos a partes específicas das legendas. Observe os seguintes pontos ao adicionar esse código:
Todo código de sobrescrita deve começar com duas barras invertidas (\\).
Todo código de sobrescrita deve estar entre chaves ({ }). É possível incluir várias linhas de código em um único par de chaves.
O código aplica-se às legendas. Para restaurar as configurações originais, adicione o código correspondente para cancelar a sobrescrita.
A tabela a seguir descreve os parâmetros do código de sobrescrita.
Parâmetro | Descrição | Exemplo de Content |
|
| "{\\1c&00FF7F&}Green{\\1c} text" |
| bord, xbord e ybord definem a largura da borda, a largura da borda no eixo x e a largura da borda no eixo y. Unidade: pixels. | "Text {\\bord3\\3c&EBCE87&} stroke{\\bord\\3c}" |
\\b1 \\b0 | b1 indica negrito e b0 remove o efeito de negrito. | "{\\b1}Bold{\\b0} text", |
\\i1 \\i0 | i1 indica itálico e i0 remove o efeito de itálico. | "{\\i1}Italicize{\\i0} text" |
\\u1 \\u0 | u1 ativa o sublinhado e u0 remove o sublinhado. | "{\\u1}Underline{\\u0} text" |
\\s1 \\s0 | s1 ativa o tachado e s0 remove o efeito tachado. | "{\\s1}Strikethrough{\\s0} text" |
\\fs[Tamanho da fonte] | Tamanho da fonte da legenda. Unidade: pixels. | "Size {\\fs100}100{\\fs} text" |
\\fn[Fonte] | Fonte da legenda. Não é possível especificar uma fonte personalizada. | "{\\fnKaiTi}Heiti{\\fn} text" |
Efeito | Exemplo de timeline |
|
Configurar quebra de linha automática
Para garantir a exibição integral das legendas, defina AdaptMode como AutoWrap e ative a quebra de linha automática quando o texto exceder a janela. Além disso, especifique TextWidth em pixels absolutos ou como porcentagem da janela de reprodução para controlar a quebra dentro de uma largura definida.
A configuração "AdaptMode": "AutoWrapAtSpaces" impede quebras de linha no meio de palavras em inglês.
Efeito | Exemplo de timeline |
|
Configurar alinhamento de legendas
-
O posicionamento das legendas varia conforme o modo de alinhamento. A tabela a seguir descreve os modos e as posições padrão.
Alinhamento
Modo de alinhamento
Posição padrão
TopLeft
Alinhamento à esquerda
Canto superior esquerdo.
TopCenter
Alinhamento centralizado
Centro superior.
TopRight
Alinhamento à direita
Canto superior direito.
CenterLeft
Alinhamento à esquerda
Centralizado horizontalmente, com texto alinhado à esquerda.
CenterCenter
Alinhamento centralizado
Centralizado horizontal e verticalmente.
CenterRight
Alinhamento à direita
Centralizado horizontalmente, com texto alinhado à direita.
BottomLeft
Alinhamento à esquerda
Canto inferior esquerdo.
BottomCenter
Alinhamento centralizado
Centro inferior.
BottomRight
Alinhamento à direita
Canto inferior direito.
-
A tabela seguinte detalha três modos de alinhamento — Esquerda, Centro e Direita — que permitem posicionar as legendas com precisão.
Alinhamento
Modo de alinhamento
Ponto de referência de posicionamento
Left
Alinhamento à esquerda
Vértice superior esquerdo da caixa de texto da legenda.
Center
Alinhamento centralizado
Ponto médio da borda superior da caixa de texto da legenda.
Right
Alinhamento à direita
Vértice superior direito da caixa de texto da legenda.
-
A figura abaixo ilustra os diferentes pontos de referência de posicionamento para cada modo de alinhamento.
Efeito | Exemplo de timeline |
|
Configurar efeitos de legenda
Especifique um horário para exibir os efeitos de entrada e saída das legendas e defina a velocidade do efeito de loop.
Os efeitos de entrada/saída e o efeito de loop não podem ser usados simultaneamente.
Efeito | Exemplo de timeline |
|
Configurar o fundo da legenda
Utilize o campo Box em SubtitleEffects para adicionar um fundo de cor sólida às legendas. Também é possível configurar word art, quebra de linha e outros estilos.
Efeito | Exemplo de timeline |
|
Configurar balões de texto
Use BubbleStyleId para especificar o ID de um estilo de balão. Para mais informações sobre estilos de balão, consulte Balões de texto.
Defina BubbleWidth e BubbleHeight para ajustar a largura e a altura do texto do balão. X e Y indicam, respectivamente, as coordenadas do canto superior esquerdo do texto em relação ao canto superior esquerdo do vídeo.
O estilo Box em SubtitleEffects permite adicionar imagens para criar um efeito de balão personalizado. Nesse estilo, especifique Width e Height para indicar a largura e a altura da imagem original do balão. Defina TextArea para determinar a posição e o tamanho da caixa de texto em relação ao balão. Os quatro campos em TextArea indicam as coordenadas do canto superior esquerdo da caixa de texto, além de sua largura e altura relativas ao balão.
Ao usar o recurso de texto em balão, o texto sofre quebra de linha e dimensionamento automáticos dentro do balão.
Efeito | Exemplo de timeline |
|
Configurar rolagem de legendas
Rolagem vertical: Se
TimelineOutpermanecer vazio, o sistema estimará automaticamente a duração das legendas com base no ciclo de rolagem. Especifique as posições inicial (ScrollStartY) e final (ScrollEndY) da rolagem, as durações de pausa no início (ScrollStartFreeze) e no fim (ScrollEndFreeze), os deslocamentos inicial (ScrollStartShift) e final (ScrollEndShift) e a velocidade de rolagem (ScrollSpeed).Rolagem horizontal: Defina as posições inicial (
ScrollStartX) e final (ScrollEndX) da rolagem, a velocidade (ScrollSpeed) e se a rolagem deve repetir em loop (ScrollLoop).As legendas podem alinhar-se a outros elementos de mídia. Por exemplo, defina
ClipIdcomoScrollSubtitleao configurar a rolagem vertical. Para alinhar a imagem de fundo, o áudio de fundo ou o texto do banner às legendas em rolagem, definaReferenceClipIdcomoScrollSubtitle. O horário de início da rolagem vertical deve corresponder à duração da abertura da faixa de vídeo.
Efeito | Exemplo de timeline |
|
Usar FECanvas para manter o tamanho consistente das legendas em vídeos de diferentes resoluções
FontSize especifica a altura do texto da legenda em pixels. Por padrão, aplicar o mesmo FontSize em vídeos de resoluções diferentes gera proporções inconsistentes. Por exemplo, um FontSize de 100 pode parecer grande em um vídeo 480P, mas pequeno em um vídeo 720P. Para manter a consistência visual entre resoluções distintas, configure FECanvas na Timeline.
Efeito | Exemplo de timeline |
|