

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kustomisasi tambahan untuk widget panggilan web Amazon Connect Anda
<a name="more-customizations-web-calling-widget"></a>

Anda dapat menambahkan penyesuaian tambahan berikut ke widget panggilan web Anda:
+ Terapkan [blur latar belakang](#background-blur) ke ubin video pelanggan Anda.
+ Atur widget ke layar [penuh](#fullscreen-mode).
+ Pilih [perangkat kamera default](#choose-default-camera).
+ [Ubah ukuran video](#resize-video) agar sesuai dengan wadahnya.

Bagian berikut menjelaskan detail penyesuaian, kasus penggunaannya, dan cara mengonfigurasinya. Anda mengelola penyesuaian ini dengan mengonfigurasi. `WebCallingCustomizationObject`

**Topics**
+ [Latar belakang kabur](#background-blur)
+ [Mode layar penuh](#fullscreen-mode)
+ [Pilih perangkat kamera default](#choose-default-camera)
+ [Ubah ukuran video](#resize-video)
+ [Konfigurasikan objek kustomisasi](#configure-customization-object-web)
+ [Opsi dan kendala yang didukung](#supported-options-web-calling)

## Latar belakang kabur
<a name="background-blur"></a>

Kustomisasi ini mengontrol perilaku blur latar belakang video pelanggan. Saat diaktifkan, latar belakang pelanggan menjadi kabur saat video aktif. Ini membantu melindungi informasi pribadi atau ruang pribadi mereka yang mungkin terlihat di latar belakang selama panggilan video.

Untuk mengaktifkan blur latar belakang, atur `videoFilter.backgroundBlur.option` ke `ENABLED_ON_BY_DEFAULT` dalam`WebCallingCustomizationObject`.

## Mode layar penuh
<a name="fullscreen-mode"></a>

Gunakan kustomisasi ini untuk mengontrol perilaku layar penuh widget. Ada dua cara Anda dapat mengaktifkan layar penuh: 
+ Tambahkan tombol layar penuh ke widget. Pelanggan dapat menggunakan tombol untuk mengaktifkan dan mematikan layar penuh.

  Untuk menambahkan tombol layar penuh, atur `fullscreen.displayButton` ke. `ENABLED` 

ATAU
+ Atur widget ke layar penuh saat memuat.

  Untuk mengaktifkan layar penuh saat memuat, atur `fullscreen.fullscreenOnLoad` ke. `ENABLED`

Ini sangat membantu untuk menggunakan mode layar penuh ketika pelanggan perlu fokus pada widget, seperti selama berbagi layar.

Anda dapat menggunakan dua opsi ini secara individual atau dalam kombinasi.

## Pilih perangkat kamera default
<a name="choose-default-camera"></a>

Kustomisasi ini memungkinkan widget untuk memilih perangkat kamera default ketika pelanggan Anda mengaktifkan video, menawarkan opsi untuk kamera depan atau belakang. Kemampuan ini berguna untuk mendiagnosis peralatan dari jarak jauh, misalnya. Pelanggan dapat menggunakan kamera belakang untuk menunjukkan alat kepada agen.

Untuk memilih kamera belakang sebagai default, atur `devices.defaultCamera` ke`Back`.

## Ubah ukuran video
<a name="resize-video"></a>

Kustomisasi ini mengontrol bagaimana ubin video untuk pelanggan dan agen diubah ukurannya di widget. Misalnya, bingkai video dapat diubah ukurannya untuk mengisi seluruh ubin video, atau diskalakan agar sesuai dengan ubin video, meninggalkan ruang kosong jika rasio aspek bingkai video tidak cocok dengan ubin video.
+ Untuk mengubah ukuran video untuk pelanggan, atur `videoTile.localVideoObjectFit` ke nilai target.
+ Untuk mengubah ukuran video untuk agen, atur `videoTile.remoteVideoObjectFit` ke nilai target.

Untuk informasi selengkapnya, lihat [Opsi dan kendala yang didukung](#supported-options-web-calling).

## Konfigurasikan objek kustomisasi
<a name="configure-customization-object-web"></a>

Contoh berikut menunjukkan bagaimana menerapkan kustomisasi opsional untuk panggilan web. Untuk penjelasan rinci tentang opsi ini, lihat[Opsi dan kendala yang didukung](#supported-options-web-calling). 

Anda dapat menerapkan beberapa atau semua bidang yang ditunjukkan dalam contoh berikut. Bila Anda tidak menerapkan kustomisasi, perilaku default akan digunakan untuk bidang yang hilang.

```
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
});
```

Gambar berikut menunjukkan bagaimana kustomisasi terlihat ketika tidak dalam mode layar penuh. 

![Kustomisasi saat tidak dalam model layar penuh.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/fullscreenmode.png)


Gambar berikut menunjukkan bagaimana kustomisasi terlihat ketika dalam mode layar penuh.

![Kustomisasi saat dalam mode layar penuh.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/nonfullscreenmode.png)


## Opsi dan kendala yang didukung
<a name="supported-options-web-calling"></a>

Tabel berikut mencantumkan bidang kustomisasi yang didukung dan batasan nilai yang direkomendasikan.


| Opsi tata letak kustom | Tipe | Nilai | Deskripsi | 
| --- | --- | --- | --- | 
| `videoFilter.backgroundBlur.option` | string | `ENABLED_ON_BY_DEFAULT` \| `ENABLED_OFF_BY_DEFAULT` | Mengatur keburaman latar belakang ubin video pelanggan Anda. Secara default, ketika pelanggan Anda mengaktifkan video, filter blur latar belakang akan diterapkan ke ubin video, jika Anda tidak ingin mengaktifkan filter secara default, Anda dapat mengaturnya ke`ENABLED_OFF_BY_DEFAULT`, pelanggan Anda masih dapat mengaktifkan filter secara manual di halaman preferensi widget. | 
| `fullscreen.displayButton` | string | `ENABLED` | Menambahkan tombol ke sudut kanan atas widget untuk membuatnya layar penuh di browser. Secara default, tombol ini tidak akan ditambahkan ke widget, jika Anda ingin menambahkan tombol ini, Anda dapat mengaturnya ke`ENABLED`. | 
| `fullscreen.fullscreenOnLoad` | string | `ENABLED` | Membuat widget layar penuh di browser. Secara default, widget akan ditambatkan ke sudut kanan bawah halaman web, mengaturnya untuk `ENABLED` membuat widget layar penuh di browser. | 
| `devices.defaultCamera` | string | `Front` \| `Back` | Menetapkan perangkat kamera default saat pelanggan Anda mengaktifkan video. Ini untuk kasus penggunaan seluler atau tablet. Secara default, kamera default dipilih ([detail](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices)). (Untuk informasi selengkapnya, lihat [metodeMediaDevices: enumerateDevices ()](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices) dalam dokumentasi pengembang Mozilla.) Saat Anda mengaturnya`Front\|Back`, ia memilih kamera yang sesuai jika tersedia. | 
| `copyDisplayNameFromAuthenticatedChat` | boolean | `true` \| `false` | Jika pelanggan akhir diautentikasi menggunakan blok aliran [Authenticate Customer](authenticate-customer.md), menyetel nilainya `true` akan menyalin nama tampilan ke kontak suara. Nilai default-nya `false`. | 
| `videoTile.localVideoObjectFit` | string | `fill` \| `contain` \| `cover` \| `none` \| `scale-down` | Menetapkan properti [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) dari ubin video pelanggan Anda di widget. Secara default, nilainya ditentukan oleh lebar dan tinggi resolusi video: jika tinggi lebih besar dari lebar, itu akan menjadi, jika tidak`contain`, itu akan menjadi`cover`. Untuk penjelasan rinci tentang setiap nilai, lihat [object-fit dalam dokumentasi](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) pengembang Mozilla. Atribut ini diterapkan hanya pada tinggi tampilan dan lebar video pelanggan di widget. Tinggi dan lebar video pelanggan yang dikirim ke agen tidak berubah.  | 
| `videoTile.remoteVideoObjectFit` | string | `fill` \| `contain` \| `cover` \| `none` \| `scale-down` | Menetapkan properti [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) dari ubin video pelanggan Anda di widget. Secara default, nilainya ditentukan oleh lebar dan tinggi resolusi video: jika tinggi lebih besar dari lebar, itu akan menjadi, jika tidak`contain`, itu akan menjadi`cover`. Untuk penjelasan rinci tentang setiap nilai, lihat [object-fit dalam dokumentasi](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) pengembang Mozilla. Atribut ini diterapkan hanya pada tinggi tampilan dan lebar video agen di widget.   | 