Configurar o objeto VideoFxProcessor do SDK do Amazon Chime - SDK do Amazon Chime

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar o objeto VideoFxProcessor do SDK do Amazon Chime

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

Type

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

Type

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())
}