Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione dell'VideoFxProcessoroggetto per l'SDK Amazon Chime
<a name="configure-videofxprocessor"></a>

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

**Sfocatura dello sfondo**  
La sfocatura dello sfondo assume le seguenti proprietà:


| Proprietà | Tipo | Description | 
| --- | --- | --- | 
| `isEnabled` | `boolean` | Quando`true`, 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 | Description | 
| --- | --- | --- | 
| `isEnabled` | `boolean` | Quando`true`, il filtro sostituisce lo sfondo. | 
| `backgroundImageURL` | `string` | L'URL dell'immagine di sfondo. Il filtro ridimensiona l'immagine dinamicamente in base alle dimensioni della schermata corrente. È possibile utilizzare una stringa come `https://...` o un URL di dati come. `data:image/jpeg;base64` | 
| `defaultColor` | `string` | Una stringa di colore esadecimale come `000000` o `FFFFFF` oppure una stringa come `black` o`white`. Se non si specifica l'URL di un'immagine, il processore lo 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` o`defaultColor`, 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. `setEffectConfig`genera 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())
}
```