

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Konfiguration des VideoFxProcessor Objekts für das Amazon Chime SDK
<a name="configure-videofxprocessor"></a>

In den folgenden Tabellen sind die `VideoFxProcessor` Eigenschaften aufgeführt, die Sie konfigurieren können. Das Beispiel unter den Tabellen zeigt eine typische Laufzeitkonfiguration.

**Unschärfe im Hintergrund**  
Die Hintergrundunschärfe hat die folgenden Eigenschaften:


| Eigenschaft | Typ | Description | 
| --- | --- | --- | 
| `isEnabled` | `boolean` | Wann `true` verwischt der Filter den Hintergrund. | 
| `strength` | `string` | Bestimmt das Ausmaß der Unschärfe. Zulässige Werte: `low` \| `medium` \| `high`. | 

**Ersetzen des Hintergrunds**  
Für das Ersetzen des Hintergrunds gelten die folgenden Parameter:


| Eigenschaft | Typ | Description | 
| --- | --- | --- | 
| `isEnabled` | `boolean` | Wenn`true`, ersetzt der Filter den Hintergrund. | 
| `backgroundImageURL` | `string` | Die URL des Hintergrundbilds. Der Filter passt die Bildgröße dynamisch an die Abmessungen des aktuellen Bildschirms an. Sie können eine Zeichenfolge wie `https://...` oder eine Daten-URL wie `data:image/jpeg;base64` verwenden. | 
| `defaultColor` | `string` | Eine hexadezimale Zeichenfolge wie `000000` oder `FFFFFF` oder oder eine Zeichenfolge wie `black` oder`white`. Wenn Sie keine Bild-URL angeben, verwendet der Prozessor die `defaultColor` als Hintergrund. Wenn Sie kein A angeben, `defaultColor` ist der Prozessor standardmäßig schwarz. | 

**Änderung einer Konfiguration zur Laufzeit**  
Sie können eine `VideoFxProcessor` Konfiguration zur Laufzeit ändern, indem Sie den `videoFxProcessor.setEffectConfig` Parameter verwenden. Das folgende Beispiel zeigt, wie Sie die Hintergrundersetzung aktivieren und die Hintergrundunschärfe deaktivieren.

**Anmerkung**  
Sie können jeweils nur einen Typ der Hintergrundersetzung angeben. Geben Sie einen Wert für `backgroundImageURL` oder an`defaultColor`, aber nicht für beide.

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

Wenn `setEffectConfig` eine Ausnahme ausgelöst wird, bleibt die vorherige Konfiguration gültig. `setEffectConfig`löst Ausnahmen unter Bedingungen aus, die denen ähneln, die zur Auslösung von Ausnahmen führen`VideoFxProcessor.create`.

Das folgende Beispiel zeigt, wie Sie ein Hintergrundbild ändern können, während das Video läuft.

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