Configurando o objeto VideoFxProcessor

A tabela a seguir lista as propriedades do VideoFxProcessor que você pode configurar. O exemplo abaixo das tabelas mostra uma configuração típica de runtime.

Desfoque de plano de fundo

O desfoque de plano de fundo assume as seguintes propriedades:

Propriedade	Tipo	Descrição
isEnabled	boolean	Quando true, o filtro desfoca o plano de fundo.
strength	string	Determina a extensão do desfoque. Valores válidos: low | medium | high .

Substituição de plano de fundo

A substituição de plano de fundo considera os seguintes parâmetros:

Propriedade	Tipo	Descrição
isEnabled	boolean	Quando true, o filtro substitui o plano de fundo.
backgroundImageURL	string	A URL da imagem do plano de fundo. O filtro redimensiona a imagem dinamicamente para as dimensões da tela atual. Você pode usar uma string, como https://... ou uma URL de dados, como data:image/jpeg;base64.
defaultColor	string	Uma string de cor hexadecimal, como 000000 ou FFFFFF, ou uma string como black ou white. Se você não especificar uma URL da imagem, o processador usará a defaultColor como plano de fundo. Se você não especificar uma defaultColor, o processador usará o padrão preto.

Como alterar uma configuração em runtime

Você pode alterar uma configuração do VideoFxProcessor em runtime usando o parâmetro videoFxProcessor.setEffectConfig. O exemplo a seguir mostra como habilitar a substituição de plano de fundo e desabilitar o desfoque de plano de fundo.

nota

Você só pode especificar um tipo de substituição de plano de fundo por vez. Especifique um valor para backgroundImageURL ou defaultColor, mas não para os dois.

videoFxConfig.backgroundBlur.isEnabled = false;
videoFxConfig.backgroundReplacement.isEnabled = true;
try {
  await videoFxProcessor.setEffectConfig(videoFxConfig);
} catch(error) {
  logger.error(error.toString())
}

Se a setEffectConfig gerar uma exceção, a configuração anterior permanecerá em vigor. A setEffectConfig lança exceções em condições semelhantes às que fazem o VideoFxProcessor.create lançar exceções.

O exemplo a seguir mostra como alterar uma imagem de plano de fundo enquanto o vídeo é executado.

videoFxConfig.backgroundReplacement.backgroundImageURL = "https://my-domain.com/my-other-image.jpg";
try {
  await videoFxProcessor.setEffectConfig(videoFxConfig);
} catch(error) {
  logger.error(error.toString())
}