Configurazione della VideoFxProcessor oggetto

Nelle tabelle seguenti sono elencate le proprietà che è possibile configurareVideoFxProcessor. L'esempio sotto le tabelle mostra una tipica configurazione di runtime.

Sfocatura dello sfondo

La sfocatura dello sfondo assume le seguenti proprietà:

Proprietà	Tipo	Descrizione
isEnabled	boolean	Quandotrue, il filtro offusca lo sfondo.
strength	string	Determina l'entità della sfocatura. Valori validi: low | medium | high .

Sostituzione dello sfondo

La sostituzione dello sfondo richiede i seguenti parametri:

Proprietà	Tipo	Descrizione
isEnabled	boolean	Quandotrue, il filtro sostituisce lo sfondo.
backgroundImageURL	string	L'immagine URL di sfondo. Il filtro ridimensiona l'immagine dinamicamente in base alle dimensioni della schermata corrente. È possibile utilizzare una stringa come https://... o un dato URL come. data:image/jpeg;base64
defaultColor	string	Una stringa di colore esadecimale come black o owhite. 000000 FFFFFF Se non si specifica un'immagineURL, il processore la utilizza defaultColor come sfondo. Se non si specifica a, per impostazione predefinita defaultColor il processore è nero.

Modifica di una configurazione in fase di esecuzione

È possibile modificare una VideoFxProcessor configurazione in fase di esecuzione utilizzando il videoFxProcessor.setEffectConfig parametro. L'esempio seguente mostra come abilitare la sostituzione dello sfondo e disabilitare la sfocatura dello sfondo.

Nota

È possibile specificare un solo tipo di sostituzione dello sfondo alla volta. Specificate un valore per backgroundImageURL odefaultColor, ma non per entrambi.

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

Se setEffectConfig genera un'eccezione, la configurazione precedente rimane valida. setEffectConfiggenera eccezioni in condizioni simili a quelle che causano VideoFxProcessor.create la generazione di eccezioni.

L'esempio seguente mostra come modificare un'immagine di sfondo durante l'esecuzione del video.

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