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à.
# Personalizzazioni aggiuntive per il widget di chiamata web di Amazon Connect
Puoi aggiungere le seguenti personalizzazioni aggiuntive al widget per le chiamate web:
+ Applica la [sfocatura dello sfondo](#background-blur) al riquadro video del cliente.
+ Imposta il widget su [fullscreen](#fullscreen-mode).
+ Seleziona il [dispositivo con fotocamera predefinito](#choose-default-camera).
+ [Ridimensiona il video](#resize-video) per adattarlo al riquadro.
Le sezioni seguenti spiegano i dettagli delle personalizzazioni, i relativi casi d’uso e le modalità di configurazione. Puoi gestire queste personalizzazioni configurando `WebCallingCustomizationObject`.
**Topics**
+ [Sfocatura dello sfondo](#background-blur)
+ [Modalità a schermo intero](#fullscreen-mode)
+ [Scegliere il dispositivo predefinito da utilizzare come fotocamera](#choose-default-camera)
+ [Ridimensionamento del video](#resize-video)
+ [Configurazione dell'oggetto di personalizzazione](#configure-customization-object-web)
+ [Vincoli e opzioni supportate](#supported-options-web-calling)
## Sfocatura dello sfondo
Questa personalizzazione controlla il comportamento di sfocatura dello sfondo del video del cliente. Se abilitata, lo sfondo del cliente è sfocato quando il video è attivo. Questo aiuta a proteggere le informazioni personali o gli spazi privati che potrebbero essere visibili in background durante la chiamata video.
Per attivare la sfocatura dello sfondo, imposta `videoFilter.backgroundBlur.option` su `ENABLED_ON_BY_DEFAULT` in `WebCallingCustomizationObject`.
## Modalità a schermo intero
Usa questa personalizzazione per controllare il comportamento a tutto schermo del widget. È possibile abilitare la modalità a tutto schermo in due modi:
+ Aggiungi un pulsante dedicato al widget. Il cliente può utilizzare il pulsante per attivare e disattivare la modalità a tutto schermo.
Per aggiungere questo pulsante, imposta `fullscreen.displayButton` su `ENABLED`.
O
+ Imposta il widget sulla modalità a tutto schermo al momento del caricamento.
Per abilitare la modalità a tutto schermo al momento del caricamento, imposta `fullscreen.fullscreenOnLoad` su `ENABLED`.
È particolarmente utile attivare la modalità a tutto schermo quando il cliente deve concentrarsi sul widget, ad esempio durante la condivisione dello schermo.
Puoi utilizzare queste due opzioni singolarmente o in combinazione.
## Scegliere il dispositivo predefinito da utilizzare come fotocamera
Questa personalizzazione consente al widget di selezionare il dispositivo con fotocamera predefinito quando il cliente abilita il video, offrendo opzioni per la fotocamera anteriore o posteriore. Questa funzionalità è utile, ad esempio, per eseguire la diagnosi delle apparecchiature da remoto. Il cliente può utilizzare la fotocamera posteriore per mostrare l’apparecchiatura all’agente.
Per selezionare la fotocamera posteriore come predefinita, imposta `devices.defaultCamera` su `Back`.
## Ridimensionamento del video
Questa personalizzazione controlla il modo in cui i riquadri video del cliente e dell’agente vengono ridimensionati nel widget. Ad esempio, il frame del video può essere ridimensionato per riempire l’intero riquadro video o per essere adattato al riquadro video, lasciando spazi vuoti se le proporzioni del frame del video non corrispondono a quelle del riquadro video.
+ Per ridimensionare il video del cliente, imposta `videoTile.localVideoObjectFit` sul valore di destinazione.
+ Per ridimensionare il video dell’agente, imposta `videoTile.remoteVideoObjectFit` sul valore di destinazione.
Per ulteriori informazioni, consulta [Vincoli e opzioni supportate](#supported-options-web-calling).
## Configurazione dell'oggetto di personalizzazione
Nell’esempio seguente viene illustrato come implementare le personalizzazioni opzionali per le chiamate web. Per una descrizione dettagliata di queste opzioni, consulta [Vincoli e opzioni supportate](#supported-options-web-calling).
Puoi implementare alcuni o tutti i campi mostrati nell’esempio seguente. Se non implementi nessuna personalizzazione, i comportamenti predefiniti vengono utilizzati per i campi mancanti.
```
amazon_connect('webCallingCustomizationObject', {
videoFilter: {
backgroundBlur: {
option: "ENABLED_OFF_BY_DEFAULT"
}
},
fullscreen: {
displayButton: "ENABLED",
fullscreenOnLoad: "DISABLED"
},
devices: {
defaultCamera: "Front"
},
videoTile: {
localVideoObjectFit: "cover",
remoteVideoObjectFit: "cover"
},
copyDisplayNameFromAuthenticatedChat: true
});
```
Nell’immagine seguente viene mostrato l’aspetto delle personalizzazioni quando non è attivata la modalità a tutto schermo.
Nell’immagine seguente viene mostrato l’aspetto delle personalizzazioni quando è attivata la modalità a tutto schermo.
## Vincoli e opzioni supportate
Nella tabella seguente sono elencati i campi di personalizzazione supportati e i vincoli sui valori consigliati.
| Opzione di layout personalizzato | Tipo | Valori | Description |
| --- | --- | --- | --- |
| `videoFilter.backgroundBlur.option` | stringa | `ENABLED_ON_BY_DEFAULT` \| `ENABLED_OFF_BY_DEFAULT` | Imposta la sfocatura dello sfondo del riquadro video del cliente. Per impostazione predefinita, quando il cliente abilita il video, il filtro di sfocatura dello sfondo viene applicato al riquadro video. Se non desideri abilitare il filtro per impostazione predefinita, puoi impostarlo su `ENABLED_OFF_BY_DEFAULT`; il cliente può comunque abilitare manualmente il filtro nella pagina delle preferenze del widget. |
| `fullscreen.displayButton` | stringa | `ENABLED` | Aggiunge un pulsante nell’angolo in alto a destra del widget per visualizzarlo a tutto schermo nel browser. Per impostazione predefinita, questo pulsante non viene aggiunto al widget; se desideri aggiungerlo, puoi impostarlo su `ENABLED`. |
| `fullscreen.fullscreenOnLoad` | stringa | `ENABLED` | Visualizza il widget a tutto schermo nel browser. Per impostazione predefinita, il widget verrà ancorato all’angolo in basso a destra della pagina web; impostandolo su `ENABLED` il widget viene visualizzato a tutto schermo nel browser. |
| `devices.defaultCamera` | stringa | `Front` \| `Back` | Imposta il dispositivo con fotocamera predefinito quando il cliente abilita il video. Serve nei casi d’uso relativi a dispositivi mobili o tablet. Per impostazione predefinita, è selezionata la fotocamera predefinita ([consulta i dettagli](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices)). (Per ulteriori informazioni, consultate il [metodoMediaDevices: enumerateDevices () nella documentazione per gli sviluppatori di Mozilla.)](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices) Quando lo imposti su `Front\|Back`, viene selezionata la fotocamera corrispondente, se disponibile. |
| `copyDisplayNameFromAuthenticatedChat` | booleano | `true` \| `false` | Nel caso in cui l’utente finale abbia effettuato l’autenticazione utilizzando il blocco di flusso [Autentica il cliente](authenticate-customer.md), impostando il valore su `true`, il nome visualizzato verrà copiato nel contatto vocale. Il valore predefinito è `false`. |
| `videoTile.localVideoObjectFit` | stringa | `fill` \| `contain` \| `cover` \| `none` \| `scale-down` | Imposta la proprietà [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) del riquadro video del cliente nel widget. Per impostazione predefinita, il valore è determinato dalla larghezza e dall’altezza relative alla risoluzione video: se l’altezza è maggiore della larghezza, sarà `contain`, altrimenti sarà `cover`. Per una descrizione dettagliata di ogni valore, consulta [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) nella documentazione per gli sviluppatori di Mozilla. Questo attributo viene applicato solo all’altezza e alla larghezza di visualizzazione del video del cliente nel widget. L’altezza e la larghezza del video del cliente inviato all’agente rimangono inalterate. |
| `videoTile.remoteVideoObjectFit` | stringa | `fill` \| `contain` \| `cover` \| `none` \| `scale-down` | Imposta la proprietà [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) del riquadro video del cliente nel widget. Per impostazione predefinita, il valore è determinato dalla larghezza e dall’altezza relative alla risoluzione video: se l’altezza è maggiore della larghezza, sarà `contain`, altrimenti sarà `cover`. Per una descrizione dettagliata di ogni valore, consulta [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) nella documentazione per gli sviluppatori di Mozilla. Questo attributo viene applicato solo all’altezza e alla larghezza di visualizzazione del video dell’agente nel widget. |