A estrutura do objeto `Effect` varia conforme o tipo. Cada seção abaixo lista os parâmetros de um tipo específico de efeito.
Tipo de efeito: Text (texto de banner)
Exemplo de timeline:Legendas e modelos de legendas.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
X |
Float |
No |
A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas são dimensionadas com base nos tamanhos do material e do vídeo de saída. |
|
Y |
Float |
No |
A distância vertical do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas são dimensionadas com base nos tamanhos do material e do vídeo de saída. |
|
TimelineIn |
Float |
No |
O momento em que o texto de banner aparece na timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineIn` do clip correspondente será usado. |
|
TimelineOut |
Float |
No |
O momento em que o texto de banner desaparece da timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineOut` do clip correspondente será usado. |
|
Content |
String |
Yes |
O conteúdo do texto de banner. |
|
Font |
String |
No |
A fonte do texto de banner. Fontes suportadas:Lista de fontes. Padrão: SimSun. |
|
FontSize |
Int |
Yes |
O tamanho da fonte do texto de banner. Este tamanho de fonte é dimensionado com base nos tamanhos do material e do vídeo de saída. O valor padrão é 0. O valor máximo é 5000. Observação:
|
|
SizeRequestType |
String |
No |
O método usado para calcular o tamanho renderizado real do texto de banner a partir do tamanho da fonte. O valor padrão é `RealDim`.
|
|
FixedFontSize |
Int |
Yes |
O tamanho da fonte do texto de banner. Este tamanho de fonte não é dimensionado com base nos tamanhos do material e do vídeo de saída. Observação:
|
|
FixedX |
Float |
No |
A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas não são dimensionadas com base nos tamanhos do material e do vídeo de saída. |
|
FixedY |
Float |
No |
O deslocamento horizontal do texto de banner a partir do canto superior esquerdo do vídeo de saída. Você pode especificar este valor em formato de porcentagem ou de pixel. Um valor no intervalo [0, 0,9999] é tratado como uma proporção relativa à largura do vídeo de saída. Um valor inteiro igual ou maior que 2 é tratado como um valor absoluto em pixels. O valor padrão é 0. A coordenada é relativa ao vídeo de saída e não é dimensionada com base nas dimensões do material de origem. |
|
FontColor |
String |
No |
A cor do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`. |
|
FontColorOpacity |
String |
No |
A opacidade do texto de banner. Intervalo: [0, 1]. 1 = opaco, 0 = totalmente transparente. Padrão: 1. |
|
FontFace |
FontFace |
No |
O estilo da fonte do texto de banner. |
|
Spacing |
Integer |
No |
O espaçamento entre caracteres do texto de banner. Unidade: pixels. O valor padrão é 0. |
|
LineSpacing |
Integer |
No |
O espaçamento entre linhas do texto de banner. Unidade: pixels. O valor padrão é 0. |
|
Angle |
Float |
No |
O ângulo de rotação no sentido anti-horário do texto de banner. Unidade: graus. O valor padrão é 0. |
|
BorderStyle |
Int |
No |
O formato de borda e sombra do texto de banner. Valores válidos: 1 (borda + sombra), 3 (caixa de fundo opaco). Padrão: 1. |
|
Outline |
Int |
No |
A largura do contorno do texto de banner. Unidade: pixels. O valor padrão é 0. |
|
OutlineColour |
String |
No |
A cor do contorno do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`. |
|
Shadow |
Int |
No |
A profundidade da sombra projetada pelo texto de banner. Unidade: pixels. O valor padrão é 0. |
|
BackColour |
String |
No |
A cor da sombra do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`. |
|
Alignment |
String |
No |
O alinhamento do texto de banner. O valor padrão é `TopLeft`. Valores válidos:
Para posicionar com precisão as legendas em diferentes modos de alinhamento, defina este parâmetro como um dos seguintes valores:
|
|
AdaptMode |
String |
No |
Especifica se o texto de banner deve ser quebrado ou redimensionado automaticamente quando exceder a largura do vídeo ou o `TextWidth` especificado.
|
|
TextWidth |
String |
No |
A largura da caixa de texto. Este parâmetro é válido apenas quando `AdaptMode` está definido. A largura da caixa de texto é usada para quebra ou redimensionamento automático. Se você não especificar este parâmetro, a largura do vídeo será usada para quebra ou redimensionamento automático. Um valor maior que 0 e menor ou igual a 1 representa uma largura relativa à largura do vídeo de saída. Um valor maior que 1 representa um valor absoluto em pixels. |
|
FontUrl |
String |
No |
O caminho para um arquivo de fonte no seu bucket OSS para gerar legendas. Arquivos de fonte nos formatos TTF, OTF e WOFF são suportados. Exemplo: `https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf` |
|
EffectColorStyle |
String |
No |
O estilo de arte em palavras para o texto de banner.Exemplos de efeitos de arte em palavras. |
|
SubtitleEffects |
No |
Os efeitos de múltiplas camadas para o texto de banner. Você pode definir contornos de múltiplas camadas, sombras de múltiplas camadas, efeitos de desfoque gaussiano e efeitos de fundo de legenda. O desfoque gaussiano é suportado apenas quando o tipo é definido como sombra. Observação:
|
|
|
AaiMotionInEffect |
String |
No |
O efeito de entrada para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de efeitos de legenda. |
|
AaiMotionIn |
Float |
No |
A duração do efeito de entrada para o texto de banner. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar `AaiMotionIn`, o valor padrão é 0,5s. Se a duração do texto for menor que 0,5s, o valor será a duração total menos a duração da saída. |
|
AaiMotionOutEffect |
String |
No |
O efeito de saída para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de efeitos de legenda. |
|
AaiMotionOut |
Float |
No |
A duração do efeito de saída para o texto de banner. Este parâmetro é válido quando o tipo de legenda é texto de banner. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar `AaiMotionOut`, o valor padrão é 0,5s. Se a duração do texto for menor que 0,5s, o valor será a duração total do texto. |
|
AaiMotionLoopEffect |
String |
No |
O efeito de loop para o texto de banner. Válido apenas para legendas de texto de banner. Não pode coexistir com efeitos de entrada ou saída.Exemplos de efeitos de legenda. |
|
Ratio |
Float |
No |
A velocidade de reprodução do efeito de loop para o texto de banner. Válido apenas para legendas de texto de banner. Preciso até quatro casas decimais. Padrão: 1. Valores maiores que 1 aceleram o loop; valores menores que 1 desaceleram. |
|
TextureURL |
String |
No |
O efeito de textura para a legenda. Este parâmetro é válido quando o tipo de legenda é texto de banner. Os formatos PNG, JPG, JPEG e BMP são suportados. Atualmente, apenas arquivos OSS são suportados. Exemplo: `https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png` |
|
BubbleStyleId |
String |
No |
O estilo de balão para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de legendas em balão. |
|
BubbleWidth |
Float |
No |
A largura do fundo do balão em relação ao vídeo de saída. Este parâmetro é válido apenas ao usar legendas em balão. Um valor maior que 1 representa um valor absoluto em pixels. Um valor menor ou igual a 1 representa um valor relativo. |
|
BubbleHeight |
Float |
No |
A altura do fundo do balão em relação ao vídeo de saída. Este parâmetro é válido apenas ao usar legendas em balão. Um valor maior que 1 representa um valor absoluto em pixels. Um valor menor ou igual a 1 representa um valor relativo. |
Tipo de efeito: DeWatermark (mascaramento)
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
X |
Float |
No |
A distância horizontal do canto superior esquerdo da área borrada até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. |
|
Y |
Float |
No |
A distância vertical do canto superior esquerdo da área borrada até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. |
|
Width |
Float |
Yes |
A largura da área borrada no vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Height |
Float |
Yes |
A altura da área borrada no vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
Tipo de efeito: Crop (recorte)
Exemplo de timeline:Recorte de vídeo.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
X |
Float |
No |
A distância horizontal do canto superior esquerdo da área mantida após o recorte até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. |
|
Y |
Float |
No |
A distância vertical do canto superior esquerdo da área mantida após o recorte até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. |
|
Width |
Float |
Yes |
A largura da área mantida no vídeo de saída após o recorte. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Height |
Float |
Yes |
A altura da área mantida no vídeo de saída após o recorte. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
Tipo de efeito: Scale (dimensionamento)
Se a proporção de aspecto de um material diferir do vídeo de saída e nenhum efeito de dimensionamento estiver configurado, o material é dimensionado automaticamente para ajustar a largura ou a altura, centralizado, e o espaço restante é preenchido com barras pretas.
Exemplo de timeline:Configuração de dimensionamento.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Width |
Float |
Yes |
A largura da área mantida no vídeo de saída após o dimensionamento. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
|
Height |
Float |
Yes |
A altura da área mantida no vídeo de saída após o dimensionamento. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
Tipo de efeito: Pad (preenchimento)
Se a proporção de aspecto de um material diferir do vídeo de saída e nenhum efeito de preenchimento estiver configurado, o material é dimensionado automaticamente para ajustar a largura ou a altura, centralizado, e o espaço restante é preenchido com barras pretas.
Exemplo de timeline:Converter vídeo horizontal para vertical com preenchimento borrado.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Left |
Float |
No |
A distância da borda esquerda do material até a borda esquerda do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
|
Right |
Float |
No |
A distância da borda direita do material até a borda direita do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
|
Top |
Float |
No |
A distância da borda superior do material até a borda superior do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
|
Bottom |
Float |
No |
A distância da borda inferior do material até a borda inferior do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels. |
|
Color |
String |
No |
A cor do preenchimento. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#000000`. A cor padrão é preto. |
Tipo de efeito: Background (configurações de fundo)
As configurações de fundo incluem desfoque e cor sólida para preencher áreas em branco quando os tamanhos do material e da saída diferem.
Compatível com os efeitos Crop, Scale, VFX e Transition.
Exemplo de timeline:Converter vídeo horizontal para vertical e definir cor de fundo.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo. Valores válidos: `Blur`: Desfoque de fundo. `Color`: Cor de fundo. |
|
Radius |
Float |
No |
O raio de desfoque. Este parâmetro é válido apenas quando `SubType` é `Blur`. O valor deve estar no intervalo [0,01, 1]. |
|
Color |
String |
No |
O valor da cor. Este parâmetro é válido apenas quando `SubType` é `Color`. O valor é um código de cor RGB hexadecimal. Exemplo: `#FFFFFF`. |
Tipo de efeito: Transition (transição)
Este efeito de transição é criado pela sobreposição de dois clips, o que encurta a duração do vídeo final. Para evitar encurtar a duração, use o efeito `DLTransition` descrito abaixo.
Uma transição ocorre entre dois clips. Configure-a apenas no primeiro clip. O efeito sobrepõe o final do clip 1 com o início do clip 2, reduzindo a duração total do vídeo pelo comprimento da transição.
Por exemplo, uma faixa de vídeo tem dois clips: Clip1 (10s) e Clip2 (8s). Se você adicionar uma transição de 4s entre eles, a duração total da faixa de vídeo se torna 14s em vez de 18s.
A tabela a seguir descreve as propriedades de transição. Efeitos de transição específicos:Exemplos de efeitos de transição.
Exemplo de timeline:Exemplo de configuração de timeline de transição.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo de transição. Especifique um ou mais subtipos de transição, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todas as transições disponíveis. Exemplo: `directional`. Todos os valores e efeitos:Exemplos de efeitos de transição. |
|
Duration |
Float |
No |
A duração do efeito de transição. Unidade: segundos. O valor é preciso até quatro casas decimais. O valor padrão é 1s. |
Tipo de efeito: DLTransition (transição com preenchimento de quadros)
Ao contrário de um efeito `Transition` padrão, uma transição de bloqueio de duração (`DLTransition`) não encurta a duração do vídeo final. Em vez disso, ela preenche o período de transição com quadros estáticos.
Os parâmetros para `DLTransition` são os mesmos que para `Transition`.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo de transição. Especifique um ou mais subtipos de transição, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todas as transições disponíveis. Exemplo: `directional`. Todos os valores e efeitos:Exemplos de efeitos de transição. |
|
Duration |
Float |
No |
A duração do efeito de transição. Unidade: segundos. O valor é preciso até quatro casas decimais. O valor padrão é 1s. |
Tipo de efeito: VFX
Exemplo de timeline:VFX.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo do efeito. Especifique um ou mais subtipos de efeito, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todos os efeitos disponíveis. Exemplo: `colorfulradial`. Todos os valores e efeitos:Exemplos de efeitos. |
|
X |
Float |
No |
Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a distância horizontal do canto superior esquerdo da área de efeito até o canto superior esquerdo do vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Y |
Float |
No |
Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a distância vertical da área de efeito até o canto superior esquerdo do vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Width |
Float |
No |
Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a largura da área de efeito no vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Height |
Float |
No |
Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a altura da área de efeito no vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
ExtParams |
String |
No |
Parâmetros estendidos para o efeito. Este campo é válido apenas para cenários de mascaramento, quando `SubType` é `mask_circle`, `mask_rec`, `mask_linear` ou `mask_minor`. Os parâmetros de configuração de `ExtParams` em cenários de mascaramento são descritos abaixo. |
Exemplos de mascaramento e efeitos de saída:Efeitos de mascaramento.
Para os seguintes parâmetros de máscara, você deve especificar valores float em formato de ponto flutuante, como 0,5 ou 2,0.
Parâmetros para efeitos de máscara circular
SubType=mask_circle
Descrição dos parâmetros de ExtParams
|
Parâmetro |
Tipo |
Intervalo de valores |
Padrão |
Descrição |
|
x |
float |
[0.0, largura do material] |
0.5 |
A coordenada X do centro da máscara em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
y |
float |
[0.0, altura do material] |
0.5 |
A coordenada Y do centro da máscara em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
width |
float |
[0.0, largura do material] |
0.8 |
A largura da máscara elíptica em relação à largura do material. Um valor no intervalo [0,0, 1,0] representa uma largura relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
height |
float |
[0.0, altura do material] |
0.8 |
A altura da máscara elíptica em relação à largura do material. Um valor no intervalo [0,0, 1,0] representa uma altura relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
O parâmetro de suavização de bordas da máscara elíptica. Um valor maior resulta em maior grau de suavização das bordas. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
O ângulo de rotação. |
Parâmetros para efeitos de máscara retangular
SubType=mask_rec
Descrição dos parâmetros de ExtParams
|
Parâmetro |
Tipo |
Intervalo de valores |
Padrão |
Descrição |
|
x |
float |
[0.0, largura do material] |
0.5 |
A coordenada X do centro da máscara retangular no material de vídeo, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
y |
float |
[0.0, altura do material] |
0.5 |
A coordenada Y do centro da máscara retangular no material de vídeo, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
width |
float |
[0.0, largura do material] |
0.8 |
A largura da máscara retangular. Um valor no intervalo [0,0, 1,0] representa uma largura relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
height |
float |
[0.0, altura do material] |
0.8 |
A altura da máscara retangular. Um valor no intervalo [0,0, 1,0] representa uma altura relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
O parâmetro de suavização de bordas da máscara retangular. Um valor maior resulta em maior grau de suavização das bordas. |
|
radius |
float |
[0.0, o maior entre a largura ou a altura do material] |
0.1 |
O raio de borda da máscara retangular. Um valor no intervalo [0,0, 1,0] representa um raio relativo ao maior entre a largura ou a altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
O ângulo de rotação. |
Parâmetros para efeitos de máscara linear
SubType=mask_linear
Descrição dos parâmetros de ExtParams
|
Parâmetro |
Tipo |
Intervalo de valores |
Padrão |
Descrição |
|
x |
float |
[0.0, largura do material] |
0.5 |
A coordenada X do ponto de referência central da máscara linear, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
y |
float |
[0.0, altura do material] |
0.5 |
A coordenada Y do ponto de referência central da máscara linear no material de vídeo, em relação ao canto superior esquerdo do vídeo. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
O parâmetro de suavização de bordas da máscara linear. Um valor maior resulta em maior grau de suavização das bordas. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
O ângulo de rotação. |
Parâmetros para efeitos de máscara espelho
SubType=mask_minor
Descrição dos parâmetros de ExtParams
|
Parâmetro |
Tipo |
Intervalo de valores |
Padrão |
Descrição |
|
x |
float |
[0.0, largura do material] |
0.5 |
A coordenada X do ponto de referência central da máscara espelho, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
y |
float |
[0.0, altura do material] |
0.5 |
A coordenada Y do ponto de referência central da máscara espelho, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels. |
|
antialias |
float |
[0.0, 1.0] |
0.1 |
O parâmetro de suavização de bordas da máscara espelho. Um valor maior resulta em maior grau de suavização das bordas. |
|
angle |
float |
[-9999.0, 9999.0] |
0.0 |
O ângulo de rotação. |
Tipo de efeito: Filter (filtro)
Exemplo de timeline:Filtro.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo de filtro. Especifique um ou mais subtipos de filtro, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todos os filtros disponíveis. Exemplo: `M1`. Todos os valores e efeitos:Exemplos de efeitos de filtro. |
|
TimelineIn |
Float |
No |
O momento em que o filtro é aplicado na timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineIn` do clip correspondente será usado. |
|
TimelineOut |
Float |
No |
O momento em que o filtro é removido da timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineOut` do clip correspondente será usado. |
|
ExtParams |
String |
No |
Parâmetros estendidos para o filtro. Este campo é válido apenas quando `SubType` é `color`, que aplica um filtro de cor. Os parâmetros de configuração de `ExtParams` para um filtro de cor são descritos abaixo. |
Parâmetros de ExtParams para filtro de cor
Exemplo de timeline:Usar filtros de cor.
Descrição dos parâmetros de ExtParams
|
Parâmetro |
Tipo |
Intervalo de valores |
Descrição |
Padrão |
|
brightness |
int |
[-255,255] |
Brilho |
0 |
|
contrast |
int |
[-100,100] |
Contraste |
0 |
|
saturation |
int |
[-100,100] |
Saturação |
0 |
|
kelvin_temperature |
int |
[1000,40000] |
A temperatura. Este parâmetro funciona com O parâmetro temperature_ratio é aplicado. |
6000 |
|
temperature_ratio |
int |
[0,100] |
A proporção de temperatura. |
0 |
|
tint |
int |
[-100,100] |
Matiz |
0 |
|
dark_corner_ratio |
int |
[0,100] |
A proporção de vinheta. |
0 |
Tipo de efeito: Volume (ajuste de volume)
Exemplos de timeline:Silenciar um vídeo inteiro e Ajustar o volume de vídeo e áudio.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Gain |
Float |
No |
O ganho de volume. Intervalo: [0, 10]. 0 = mudo, 1 = volume original, menor que 1 = mais baixo, maior que 1 = mais alto. Padrão: 1. Valores excessivamente altos podem causar distorção. |
Tipo de efeito: AFade (fade de áudio)
Exemplo de timeline:Configurar fade de entrada e saída para clips somente de áudio e áudio em vídeos.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O subtipo de fade de áudio. Valores válidos:
|
|
Duration |
Float |
No |
A duração do fade. Um fade de entrada é aplicado ao início do clip. Um fade de saída é aplicado ao final do clip. O valor padrão é 0, o que significa que o efeito está desativado. |
|
Curve |
String |
No |
A curva de volume para o fade de áudio. O valor padrão é `exp`. Valores válidos:
|
Tipo de efeito: AI_ASR (conversão de fala em texto)
Este efeito gera legendas a partir do áudio. Você pode colocar este efeito no objeto `Effects` de uma faixa de vídeo ou áudio. Os parâmetros são os mesmos que para Tipo de efeito: Text (texto de banner). Por padrão, as legendas são centralizadas na parte inferior do vídeo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
X |
Float |
No |
A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Y |
Float |
No |
A distância vertical do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. |
|
Font |
String |
No |
A fonte do texto de banner. Fontes suportadas:Lista de fontes. Padrão: SimSun. |
|
FontSize |
Int |
Yes |
O tamanho da fonte do texto de banner. |
|
FontColor |
String |
No |
A cor do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`. |
|
FontColorOpacity |
String |
No |
A opacidade do texto de banner. Intervalo: [0, 1]. 1 = opaco, 0 = totalmente transparente. Padrão: 1. |
|
FontFace |
FontFace |
No |
O estilo da fonte do texto de banner. |
|
NeedHighlighting |
Boolean |
No |
Especifica se o realce automático deve ser ativado para legendas ASR. |
|
HighlightingStyle |
No |
O estilo para legendas realçadas. |
Tipo de efeito: Rotate (rotação do material)
Este efeito rotaciona um material em um ângulo especificado. Apenas 90, 180 e 270 graus são suportados. Aplica-se a materiais em faixas de vídeo ou imagem.
Exemplo de timeline:Rotação de material.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Degree |
Integer |
Yes |
O ângulo de rotação no sentido horário do material. Apenas 90, 180 e 270 graus são suportados. |
Tipo de efeito: AI_Matting (chroma key)
Este efeito extrai um sujeito de um fundo de tela verde ou azul e o sobrepõe em outro vídeo ou imagem de fundo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Color |
String |
Yes |
A cor de fundo a ser removida. Apenas `green` (tela verde) e `blue` (tela azul) são suportados. |
|
Auto |
Integer |
Yes |
Especifica se a cor de fundo deve ser detectada automaticamente. Valores válidos:
|
|
Thres |
Float |
No |
O limite para detecção de cor de fundo. Um valor maior significa detecção mais flexível. O valor deve estar no intervalo [0, 10]. |
Tipo de efeito: AI_RealMatting (remoção de fundo em cena real)
Este efeito extrai uma pessoa de uma cena real em um vídeo e a sobrepõe em outro vídeo ou imagem de fundo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Thres |
Float |
No |
O limite para detecção de cor de fundo. Um valor maior significa detecção mais flexível. O valor deve estar no intervalo [0, 10]. O valor padrão é 2. |
Tipo de efeito: AI_Delogo (remoção inteligente de logotipo)
Este efeito reconhece e remove logotipos de vídeos de forma inteligente. Este recurso está disponível apenas nas regiões China (Pequim) e China (Xangai).
Tipo de efeito: Clip (recorte aleatório)
Este efeito recorta aleatoriamente um segmento do material de origem e o adiciona à timeline.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
SubType |
String |
Yes |
O tipo de recorte. Apenas o recorte aleatório é suportado: `RandomClip`. |
|
ClipDuration |
Float |
Yes |
A duração do segmento recortado. |
Tipo de efeito: Flip (inversão)
Você pode inverter vídeos ou imagens em uma faixa de vídeo horizontalmente ou verticalmente.
Exemplo de timeline:Inversão horizontal e vertical.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Direction |
String |
Yes |
|
Tipo de efeito: KenBurns (efeito Ken Burns)
Este efeito aplica um efeito Ken Burns a um vídeo ou imagem em uma faixa de vídeo.
Limitações:
-
Este efeito se aplica a imagens e vídeos. Pode ser usado com VFX, filtros e transições.
-
Como este efeito permite definir a largura e a altura do quadro de saída usando os parâmetros `WindowW` e `WindowH`, ele não pode ser usado com os efeitos `Crop`, `Scale`, `Pad` ou `Background`.
|
Nome |
Tipo |
Obrigatório |
Descrição |
Exemplo |
|
|
Duration |
Float |
No |
A duração do efeito. O padrão é a duração do clip. O valor máximo é 10. Unidade: segundos (s). |
5 |
|
|
WindowW |
Float |
No |
A largura do clip. Por padrão, o valor é igual à largura do vídeo de saída. Unidade: pixels. Um valor no intervalo |
1 |
|
|
WindowH |
Float |
No |
A altura do clip. Por padrão, o valor é igual à altura do vídeo de saída. Unidade: pixels. Se o valor de WindowH estiver no intervalo (0,1], o valor é relativo. > Um valor de 1 indica o valor absoluto. |
1 |
|
|
Start |
String |
No |
A posição da área de efeito antes da aplicação do efeito Ken Burns. A posição é determinada pelas coordenadas x e y do canto superior esquerdo e pela largura e altura da área de efeito. Os parâmetros são opcionais. Os valores devem ser separados por vírgulas (,). "StartX, StartY, StartW, StartH" Limitações: 0 < StartX + StartW <=1 0 < StartY + StartH <=1 |
"0,0,0.9,0.9" |
|
|
StartX |
Float |
No |
A coordenada x do canto superior esquerdo da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartX estiver no intervalo [0,1), o valor é relativo. Um valor igual ou maior que 1 indica um valor absoluto. |
0 |
|
|
StartY |
Float |
No |
A coordenada y do canto superior esquerdo da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartY estiver no intervalo [0,1), o valor é relativo. O valor absoluto deve ser maior ou igual a 1. |
0 |
|
|
StartW |
Float |
No |
A largura da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartW estiver no intervalo (0,1], o valor é relativo. > Um valor de 1 indica o valor absoluto. |
0.9 |
|
|
StartH |
Float |
No |
A altura da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartH estiver no intervalo (0,1], o valor é relativo. > 1 indica um valor absoluto. |
0.9 |
|
|
End |
String |
No |
A posição da área de efeito após a aplicação do efeito Ken Burns. A posição é determinada pelas coordenadas x e y do canto superior esquerdo e pela largura e altura da área de efeito. Os parâmetros são opcionais. Os valores devem ser separados por vírgulas (,). "EndX, EndY, EndW, EndH" Limitações: 0 < EndX + EndW <=1 0 < EndY + EndH <=1 |
"0,0,1,1" |
|
|
EndX |
Float |
No |
A coordenada x do canto superior esquerdo da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartX estiver no intervalo [0,1), o valor é relativo. O valor absoluto deve ser maior ou igual a 1. |
0 |
|
|
EndY |
Float |
No |
A coordenada y do canto superior esquerdo da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartY estiver no intervalo [0,1), o valor é relativo. O valor absoluto deve ser maior ou igual a 1. |
0 |
|
|
EndW |
Float |
No |
A largura da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartW estiver no intervalo (0,1], o valor é relativo. > Um valor de 1 indica o valor absoluto. |
1 |
|
|
EndH |
Float |
No |
A altura da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels. Se o valor do parâmetro StartH estiver no intervalo (0,1], o valor é relativo. > 1 especifica o valor absoluto. |
1 |
|
Tipo de efeito: ADenoise (remoção de ruído de áudio)
Você pode aplicar este efeito a vídeos com áudio em uma faixa de vídeo ou a clips de áudio em uma faixa de áudio.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Mode |
Integer |
No |
|
Tipo de efeito: Zoom (zoom)
Este efeito adiciona um efeito de zoom ao clip correspondente.
Este efeito é suportado apenas para clips em uma `VideoTrack`.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
StartRate |
Float |
No |
|
|
EndRate |
Float |
No |
|
|
Duration |
Float |
No |
|
Tipo de efeito: Harmonization (harmonização de fundo)
Este efeito adiciona um efeito de harmonização de fundo ao clip correspondente e é destinado principalmente a clips de vídeo de humano digital. Quando você aplica este efeito a um clip de vídeo de humano digital, a iluminação, o brilho e a temperatura de cor do clip são ajustados para corresponder à imagem de fundo. Isso reduz a incompatibilidade visual entre o clip de humano digital e o fundo.
-
Este efeito é suportado apenas para clips em uma `VideoTrack`.
-
Você pode adicionar apenas um efeito de harmonização em uma única solicitação de edição de vídeo.
Este efeito não possui outros parâmetros de entrada.
Tipo de efeito: ALoudNorm (normalização de volume)
O efeito `ALoudNorm` se aplica a um único material de áudio ou vídeo. Se você tiver vários materiais de áudio ou vídeo e quiser que todos tenham a mesma sonoridade, configure `ALoudNorm` em cada material separadamente.
Este efeito se aplica apenas a clips de áudio e vídeo. Se `ALoudNorm` for usado com `ADenoise` ou `Volume`, os efeitos são aplicados na seguinte ordem: `ADenoise` > `Volume` > `ALoudNorm`.
Exemplo de timeline:Normalização de volume.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Loudness |
Float |
No |
A sonoridade alvo, que determina o nível de volume e está em conformidade com o padrão EBU R128. Intervalo de valores: [-70,0, -5,0]. Padrão: -24,0. |
|
TruePeak |
Float |
No |
O nível de pico verdadeiro, que limita o nível de pico mais alto do sinal de áudio. Intervalo de valores: [-9,0, +0,0]. Padrão: -2,0. |
Tipo de efeito: AEqualize (equalização de volume)
Este é um efeito global que se aplica à faixa de efeitos. Ele aplica equalização de volume uniforme à mixagem de áudio final.
Este efeito é global e não pode ser aplicado a um único clip.
Exemplo de timeline:Equalização de volume.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Peak |
Float |
No |
O nível de pico alvo do áudio. O valor padrão é 0,95. Não exceda este valor. O valor deve estar no intervalo aberto (0, 1). |
|
Gain |
Float |
No |
O coeficiente de ganho máximo. O valor deve estar no intervalo [1,0, 100,0]. O valor padrão é 10,0. O normalizador de áudio dinâmico determina o fator de ganho (local) máximo possível para cada quadro de entrada que não cause corte ou distorção. |
Tipo de efeito: FreezeFrame (quadro congelado)
Este efeito se aplica a materiais de vídeo em uma faixa de vídeo e cria um quadro congelado a partir do último quadro do vídeo.
Este efeito se aplica apenas a materiais de vídeo em uma faixa de vídeo. Ele não se aplica a materiais de imagem em uma faixa de vídeo ou a materiais em uma faixa de áudio.
Este efeito não pode ser usado com o efeito Tipo de efeito: Transition.
Exemplo de timeline:Quadro congelado de vídeo.
|
Nome |
Tipo |
Obrigatório |
Descrição |
|
Duration |
Float |
No |
A duração do quadro congelado. O valor padrão é 0. Unidade: segundos (s). |