

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

# Menggunakan Amazon Connect di lingkungan VDI
<a name="using-ccp-vdi"></a>

Lingkungan Virtual Desktop Infrastructure (VDI) menambahkan lapisan kompleksitas lain pada solusi Anda yang menjamin upaya POC terpisah dan pengujian kinerja untuk dioptimalkan. Contact Control Panel (CCP) dapat beroperasi di lingkungan VDI klien yang tebal, tipis, dan nol seperti aplikasi browser berbasis WebRTC lainnya, dan yang terbaik ditangani oleh tim dukungan VDI configuration/support/optimization Anda. Karena itu, berikut ini adalah kumpulan pertimbangan dan praktik terbaik yang telah membantu pelanggan kami yang berbasis VDI.

## Gunakan model CCP terpisah
<a name="use-split-ccp"></a>

Sebaiknya gunakan model CCP split dengan CCP medialess yang berjalan di VDI dan CCP yang membawa media di PC lokal. Anda dapat membuat CCP khusus dengan Amazon Connect Streams API dengan membuat CCP tanpa media untuk data aplikasi dan pensinyalan panggilan. Dengan cara ini, media dikirim ke desktop lokal menggunakan CCP standar, dengan data dan kontrol panggilan dikirim ke koneksi jarak jauh dengan CCP medialess. Untuk informasi selengkapnya tentang API stream, lihat GitHub repositori di. [https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams)

**catatan**  
**Pengguna Firefox**: Jika Anda menggunakan VDI dalam mode split, Anda tidak dapat menggunakan browser Firefox untuk CCP di luar VDI. CCP sesuai dengan panduan penggunaan mikrofon Firefox, dan hanya memiliki akses untuk terhubung ke mikrofon pengguna saat tab CCP dalam fokus. 

Diagram berikut menunjukkan bagaimana stasiun kerja agen terdiri dari browser lokal dan desktop virtual. Ini terhubung ke Amazon Connect melalui WebRTC, dan terhubung ke infrastruktur virtual perusahaan melalui koneksi VDI.

![\[Stasiun kerja agen, desktop virtual, infrastruktur virtual perusahaan, dan Amazon Connect.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/use-split-ccp.png)


## Desktop awan
<a name="use-cloud-desktops"></a>

Jika Anda menggunakan desktop cloud Citrix WorkSpaces, Amazon, atau Omnissa, Anda dapat membuat yang baru atau memperbarui antarmuka pengguna agen yang ada, seperti CCP khusus, untuk membongkar pemrosesan audio ke perangkat lokal agen Anda dan untuk secara otomatis mengarahkan audio ke Amazon Connect. Ini menghasilkan pengalaman agen yang lebih efisien dan meningkatkan kualitas audio melalui jaringan yang menantang. Untuk memulai, Anda dapat menggunakan [library open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) untuk membuat yang baru atau memperbarui antarmuka pengguna agen yang sudah ada, seperti CCP kustom.

## Hal-hal yang perlu dipertimbangkan saat mendesain lingkungan VDI Anda
<a name="considerations-vdi"></a>
+ **Lokasi agen Anda** — Idealnya, ada lompatan sesedikit mungkin dengan waktu pulang pergi terendah antara lokasi dari mana agen Anda menggunakan PKT dan lokasi host VDI.
+ **Lokasi host solusi VDI Anda** —Idealnya, lokasi host VDI Anda berada di segmen jaringan yang sama dengan agen Anda, dengan lompatan sesedikit mungkin dari sumber daya internal maupun router tepi. Anda juga menginginkan waktu pulang-pergi serendah mungkin untuk kedua titik akhir rentang WebRTC dan Amazon EC2.
+ **Jaringan** — Setiap lompatan yang dilalui lalu lintas di antara titik akhir meningkatkan kemungkinan kegagalan dan menambah peluang untuk memperkenalkan latensi. Lingkungan VDI sangat rentan terhadap masalah kualitas panggilan jika rute yang mendasarinya tidak dioptimalkan atau pipa tidak cepat atau cukup lebar. Meskipun Direct Connect dapat meningkatkan kualitas panggilan dari router tepi ke AWS, itu tidak akan mengatasi masalah perutean internal. Anda mungkin perlu memutakhirkan atau mengoptimalkan LAN/WAN pribadi Anda, atau mengarahkan ulang ke perangkat eksternal untuk menghindari masalah audio panggilan. Dalam kebanyakan skenario, jika ini diperlukan, PKT bukan satu-satunya aplikasi yang mengalami masalah.
+ **Sumber daya khusus** — di tingkat Jaringan dan desktop direkomendasikan untuk mencegah dampak terhadap sumber daya agen yang tersedia dari aktivitas, seperti pencadangan dan transfer file besar. Salah satu cara untuk mencegah perselisihan sumber daya adalah dengan membatasi akses desktop ke pengguna Amazon Connect yang akan menggunakan lingkungan mereka dengan cara yang sama, alih-alih berbagi sumber daya dengan unit bisnis lain yang mungkin menggunakan sumber daya tersebut secara berbeda.
+ **Menggunakan ponsel lunak dengan koneksi jarak jauh** — di lingkungan VDI dapat berdampak pada kualitas audio. 
**Tip**  
Jika agen Anda terhubung ke titik akhir jarak jauh dan beroperasi di lingkungan tersebut, sebaiknya alihkan audio ke titik akhir E.164 eksternal atau menghubungkan media melalui perangkat lokal dan kemudian memberi sinyal melalui koneksi jarak jauh.

# Optimalkan audio Amazon Connect untuk desktop cloud Citrix
<a name="using-ccp-vdi-citrix-step-by-step"></a>

Amazon Connect mempermudah menghadirkan pengalaman suara berkualitas tinggi saat agen Anda menggunakan lingkungan Citrix Virtual Desktop Infrastructure (VDI). Agen Anda dapat memanfaatkan aplikasi desktop jarak jauh Citrix mereka seperti Citrix Workspaces, untuk membongkar pemrosesan audio ke perangkat lokal agen dan untuk secara otomatis mengarahkan audio ke Amazon Connect, menghasilkan peningkatan kualitas audio melalui jaringan yang menantang. 

Untuk memulai, Anda dapat menggunakan [library open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) untuk membuat yang baru atau memperbarui antarmuka pengguna agen yang sudah ada, seperti Panel Kontrol Kontak (CCP) kustom.

## Persyaratan sistem
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

Bagian ini menjelaskan persyaratan sistem untuk menggunakan Citrix Unified Communications SDK dengan Amazon Connect.
+ **Versi Aplikasi Citrix Workspace**

  [Disarankan untuk menggunakan versi terbaru dari Aplikasi Citrix Workspace, sebagaimana diuraikan dalam dokumentasi ini.](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/) Namun, minimal, Anda harus menggunakan CWA 2305 atau yang lebih baru.
+ **Versi Server Citrix**

  Versi Citrix VDA (Virtual Delivery Agent) direkomendasikan menjadi 2203 LTSR atau yang lebih baru.
+ **Pengaturan Server Citrix**

  Citrix UC SDK tidak didukung untuk digunakan secara default dan admin sistem perlu menambahkan entri registri daftar izin sebagai berikut:
  + **Jalur Kunci:** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService`
  + **Nama kunci:** `ProcessWhitelist`
  + **Jenis kunci:** `REG_MULTI_SZ`
  + **Nilai kunci:**
    + `Chrome.exe`
    + `msedge.exe`

  Setelah Anda mengkonfigurasi registri berhasil, restart `CitrixHdxWebSocketService` menggunakan **Task Manager** untuk menyelesaikan pengaturan.  
![\[Menggunakan task manager di Windows untuk memulai ulang CitrixHdxWebSocketService.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png)
+ **Konfigurasi Jaringan/Firewall**
  + **Konfigurasi server Citrix**

    Admin perlu mengizinkan server Citrix mengakses lalu lintas Amazon Connect TCP/443 ke domain yang disebutkan dalam diagram berikut. Untuk informasi selengkapnya, lihat [Siapkan jaringan Anda](ccp-networking.md).
  + **Konfigurasi mesin agen**

    Solusi ini memerlukan koneksi media antara thin client agen dan Amazon Connect. Untuk memungkinkan lalu lintas antara mesin agen dan Softphone Media UDP Port 3478 Amazon Connect, lihat. [Siapkan jaringan Anda](ccp-networking.md)  
![\[Pengaturan firewall server dan mesin agen Citrix.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **Penyebaran PKC yang Tidak Didukung**
  + PKT asli

## Konfirmasikan aliran media antara thin client dan Amazon Connect selama panggilan
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ **Gunakan Task Manager (Windows) untuk memverifikasi**

  Luncurkan **Task Manager** pada thin client agen dan periksa untuk melihat apakah layanan HDX berjalan atau tidak. Jika sedang berjalan, maka itu berarti media sedang dialihkan seperti yang diharapkan.  
![\[Menggunakan task manager di Windows.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)

# Optimalkan audio Amazon Connect untuk desktop WorkSpaces cloud Amazon
<a name="using-ccp-vdi-workspaces"></a>

Amazon Connect menyederhanakan penyampaian pengalaman suara berkualitas tinggi untuk agen yang beroperasi di lingkungan Amazon WorkSpaces Virtual Desktop Infrastructure (VDI). Dengan memanfaatkan Amazon WorkSpaces dengan fitur pengalihan WebRTC, agen dapat mengarahkan pemrosesan audio Amazon Connect ke perangkat lokal mereka. Pendekatan ini menghasilkan peningkatan kualitas audio, bahkan di atas kondisi jaringan yang menantang. Untuk memanfaatkan fitur ini, Anda perlu melakukan hal berikut:
+ Gunakan [library open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) untuk membuat antarmuka pengguna agen baru atau memperbarui antarmuka pengguna agen yang sudah ada, seperti Contact Control Panel (CCP) kustom. 
+ Konfigurasikan Amazon WorkSpaces untuk mengaktifkan pengalihan WebRTC.

## Persyaratan sistem
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

Bagian ini menjelaskan persyaratan sistem untuk menggunakan Amazon Connect dengan pengalihan WorkSpaces WebRTC.
+ **WorkSpaces Protokol**

  WorkSpaces perlu menggunakan Amazon DCV. Untuk informasi selengkapnya, lihat [Apa itu Amazon DCV?](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html) . 
+ **Versi klien**

  Pengguna harus menggunakan WorkSpaces Web Access atau WorkSpaces Windows client versi 5.21.0 atau lebih tinggi. Lengkapi instruksi [Pengaturan dan penginstalan](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup). 
+ **Kebijakan grup**

  Pengalihan WebRTC perlu diaktifkan dalam kebijakan grup DCV. Dalam topik [Kelola pengaturan Kebijakan Grup untuk DCV](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv), buka bagian yang diciutkan berjudul Aktifkan atau **nonaktifkan pengalihan WebRTC untuk DCV dan lengkapi instruksi** tersebut.
+ **Konfigurasi jaringan/firewall**
  + **Konfigurasi VDI ruang kerja**

    Admin harus mengizinkan Workspaces mengakses lalu lintas Amazon Connect TCP/443 ke domain yang disebutkan dalam diagram berikut. Untuk informasi selengkapnya, lihat [Siapkan jaringan Anda](ccp-networking.md).
  + **Konfigurasi mesin agen**

    Solusi ini memerlukan koneksi media antara agent thin client ke Amazon Connect. Untuk memungkinkan lalu lintas antara mesin agen dan Amazon Connect Softphone Media UDP Port 3478, lihat. [Siapkan jaringan Anda](ccp-networking.md)  
![\[Pengaturan firewall VDI dan mesin agen ruang kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/vdi-workspaces.png)
+ **Penyebaran PKC yang Tidak Didukung**
  + PKT asli

## Konfirmasikan aliran media antara mesin agen dan Amazon Connect selama panggilan
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ Pastikan ekstensi browser WebRTC DCV diaktifkan dan dalam keadaan Siap.

# Optimalkan audio Amazon Connect untuk desktop cloud Omnissa
<a name="using-ccp-vdi-omnissa-step-by-step"></a>

Amazon Connect mempermudah menghadirkan pengalaman suara berkualitas tinggi saat agen Anda menggunakan lingkungan Omnissa Virtual Desktop Infrastructure (VDI). Agen Anda dapat memanfaatkan aplikasi desktop jarak jauh Omnissa mereka, seperti Omnissa Horizon Client, untuk menurunkan pemrosesan audio ke perangkat lokal agen dan untuk secara otomatis mengarahkan audio ke Amazon Connect, menghasilkan peningkatan kualitas audio melalui jaringan yang menantang. 

Untuk memulai, Anda dapat menggunakan [library open source Amazon Connect](https://github.com/amazon-connect/amazon-connect-streams) untuk membuat yang baru atau memperbarui antarmuka pengguna agen yang sudah ada, seperti Panel Kontrol Kontak (CCP) kustom.

## Persyaratan sistem
<a name="using-ccp-vdi-omnissa-step-by-step-requirements"></a>

Bagian ini menjelaskan persyaratan sistem untuk menggunakan Omnissa Horizon SDK dengan Amazon Connect.
+ **Versi Klien Omnissa Horizon**
  + Versi minimum yang diperlukan: 8.15.0 (Horizon 2503) untuk agen dan klien
  + Omnissa hanya mendukung workstation agen yang menjalankan Windows untuk fitur ini saat ini.
  + Unduh Klien Omnissa terbaru
**penting**  
Rilis 2503 akan menjadi versi pertama yang mendukung fungsionalitas restart ICE. Versi sebelumnya tidak mendukung fitur ini.
Omnissa Horizon Client versi 2503 akan tersedia melalui [Omnissa](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8) Customer Connect. Periksa Customer Connect untuk versi terbaru.
+ **Persyaratan Ekstensi dan SDK Omnissa**
  + Aplikasi Web Horizon WebRTC Mendukung Ekstensi dan SDK 8.15.0 atau lebih tinggi.
  + [Ekstensi browser ini memungkinkan dukungan webapp untuk WebRTC SDK di dalam Horizon Agent dan dapat diunduh dari Toko Chrome dari sini.](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1) 
+ **Browser Support (terbaru 3 versi)**
  + Google Chrome
  + Microsoft Edge (Chromium)
+ **Pengaturan Server Omnissa**: Omnissa Horizon SDK tidak diaktifkan secara default. Administrator sistem perlu mengkonfigurasi pengaturan registri berikut di dalam Mesin Virtual Agen Omnissa Horizon (sebaiknya melalui Registry Editor (regedit)):
  + **Buka Registry Editor**
    + Untuk Windows:
      + Tekan **Windows\$1R**
      + **Ketik **regedit** dan tekan Enter.**
  + Buat/Arahkan ke jalur registri berikut:

    ```
    Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp
    Key Names and Values:
    chrome_enabled (REG_DWORD) = 1
    edge_chrome_enabled (REG_DWORD) = 1
    enabled (REG_DWORD) = 1
    ```

    ```
    Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp\UrlAllowList
    Key Name: https://*.connect.aws/*
    Key Name: https://*.connect.aws.a2z.com/* 
    Key Type: REG_SZ
    ```

  Setelah instalasi agen Omnissa, proses html5server.exe dan wsnm.exe akan selalu berjalan di Task Manager, terlepas dari status pengaktifan SDK. Gambar berikut menunjukkan proses html5server.exe berjalan di Task Manager.   
![\[Task Manager, proses html5server.exe berjalan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/omnissa-1.png)

  Gambar berikut menunjukkan proses wsnm.exe berjalan di Task Manager.   
![\[Task Manager, proses wsnm.exe berjalan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/omnissa-2.png)
+ **Pemecahan Masalah**
  + File log Omnissa dapat ditemukan di:

    ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**catatan**  
`{pid}`Mengacu pada cakrawala klien "horizon-protocol.exe" ID proses, yang dapat ditemukan di Task Manager.
  + Pengaturan registri untuk pencatatan yang ditingkatkan

    Untuk mengaktifkan pencatatan terperinci untuk pemecahan masalah, tambahkan entri registri berikut:

    ```
    HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr: - "html5mmr.log.noThrottle" = dword:00000001
    ```

    ```
    HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr\WebrtcRedir:
     - "html5mmr.log.webrtc.allowFullText" = dword:00000001
     - "html5mmr.log.webrtc.allowThrottle" = dword:00000000
     - "html5mmr.log.webrtc.sharedlib.internal" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.network" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.media" = dword:00000001
     - "html5mmr.log.webrtc.shim.logToConsole" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.signal" = dword:00000001
     - "html5mmr.log.noThrottle" = dword:00000001
     - "html5mmr.log.webrtc.tracelevel" = dword:00000001
    ```

    Pengaturan registri ini memungkinkan pencatatan terperinci yang dapat membantu dalam mendiagnosis masalah dengan integrasi Omnissa VDI.
+ **Konfigurasi Jaringan/Firewall**
  + **Konfigurasi Omnissa VDI**

    Admin perlu mengizinkan server Omnissa mengakses lalu lintas Amazon Connect TCP/443 ke domain yang disebutkan dalam diagram di bawah ini. Lihat [Siapkan jaringan Anda](ccp-networking.md) topik untuk pengaturan ini.
  + **Konfigurasi Agen Workstation**

    Solusi ini memerlukan koneksi media antara agent thin client ke Amazon Connect. Ikuti [Siapkan jaringan Anda](ccp-networking.md) topik untuk memungkinkan lalu lintas antara mesin agen dan Amazon Connect Softphone Media UDP Port 3478.

     Diagram berikut menggambarkan penggunaan UDP Port 3478.  
![\[Diagram yang menggambarkan penggunaan UDP Port 3478.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/omnissa-3.png)

## Perubahan kode yang diperlukan pada CCP kustom Anda
<a name="omnissa-required-initccp-changes"></a>

Untuk mengaktifkan pengoptimalan audio di lingkungan Omnissa VDI, Anda harus mengonfigurasi CCP khusus Anda dengan perubahan berikut.

1. Tambahkan cuplikan kode berikut sebelum inisialisasi CCP. Ini membantu mengelola identifikasi jendela untuk PKC, terutama penting ketika agen memiliki beberapa jendela terbuka. Ini menambahkan stempel waktu dan penanda 'Active Softphone Tab' untuk membantu mengidentifikasi jendela CCP aktif.

   ```
   const ACTIVE_SOFTPHONE_TAB = "Active Softphone Tab";
   
       window.addEventListener('message', (event) => {
   
           if (event.data.type === 'get_horizon_window_title') {
               let title = document.title;
              const currentTime = new Date();
               if (!title.endsWith(ACTIVE_SOFTPHONE_TAB)) {
                   title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB;
                   document.title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB;
               }
   
               event.source.postMessage(
                   { type: 'horizon_window_title_response', title: title, source: 'parent' },
                   event.origin
               );
           }
       });
   ```

1. Tambahkan parameter platform VDI dalam konfigurasi initCCP Anda. Ini untuk mengaktifkan pengalihan audio.

   ```
   softphone: {
       allowFramedSoftphone: true,  
       VDIPlatform: "OMNISSA"
   }
   ```
**penting**  
Ketika `VDIPlatform: "OMNISSA"` diatur, CCP tidak akan kembali ke audio browser web standar jika optimasi audio Omnissa gagal. Ini berarti:  
Panggilan akan gagal jika agen mengakses PKT di luar VM Omnissa.
Pengembang CCP harus menentukan apakah CCP berjalan di dalam Omnissa VM sebelum mengatur parameter ini.
**Opsi Implementasi**:  
Gunakan jalur URL terpisah untuk akses Omnissa dan non-Omnissa.
Gunakan parameter URL untuk menentukan lingkungan.
Menerapkan API untuk menentukan konfigurasi yang benar berdasarkan konteks pengguna.

## Cara memverifikasi aliran media antara thin client dan Amazon Connect selama panggilan
<a name="verify-omnissa"></a>

1. Pastikan ekstensi browser WebRTC Omnissa Horizon diaktifkan dan dalam keadaan Siap.

1. Periksa ikon ekstensi di bilah alat browser Anda:

   1. Ikon biru menunjukkan status Siap dan fungsionalitas yang tepat.

   1. Ikon abu-abu menunjukkan status Tidak Siap dan potensi masalah.

   Gambar berikut menunjukkan seperti apa ekstensi browser WebRTC Omnissa Horizon saat diaktifkan dan dalam keadaan Siap.  
![\[Ekstensi browser WebRTC Omnissa Horizon saat diaktifkan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/omnissa-4.png)

1. Periksa status proses:

   1. Buka Task Manager.

   1. Verifikasi proses html5server.exe dan wsnm.exe sedang berjalan.

   1. Pastikan proses ini tetap berjalan selama panggilan. Jika salah satu proses macet, fungsionalitas VDI akan gagal.

1. Uji aliran audio:

   1. Lakukan panggilan uji coba

   1. Verifikasi pengoptimalan audio dengan menonaktifkan akses mikrofon di browser VM - panggilan harus terus berfungsi karena audio sedang diproses secara lokal

   1. Periksa latensi audio atau masalah kualitas apa pun.

1. Gunakan Wireshark untuk memverifikasi:

   Wireshark adalah penganalisis paket jaringan sumber terbuka dan gratis. [Untuk informasi lebih lanjut, lihat situs web Wireshark.](https://www.wireshark.org/)

   1. [Unduh Wireshark dari sini.](https://www.wireshark.org/download.html) 

   1. Setelah Wireshark diinstal, buka wireshark pada thin client, dan mulailah memantau jaringan lokal Anda.

   1. Hubungkan ke panggilan, dan di bilah filter di bagian atas, masukkan filter berikut:

      ```
      (udp.srcport == 3478 or udp.dstport == 3478) and ((ip.dst_host = "15.193.6.0/24"))
      ```

   1. Pastikan Anda dapat melihat aliran paket media antara mesin agen dan Amazon Connect. 

   1. Jika tidak ada paket yang terlihat:
      + Periksa konektivitas jaringan dan aturan firewall.
      + Verifikasi pengaturan pengoptimalan audio.
**catatan**  
Rentang IP yang ditunjukkan di atas adalah untuk AWS Wilayah AS Timur (Virginia N.). Untuk rentang IP Wilayah lain, lihat[Siapkan jaringan Anda](ccp-networking.md).  
Gambar berikut menunjukkan rentang IP untuk.  

![\[Ekstensi browser WebRTC Omnissa Horizon saat diaktifkan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/omnissa-5.png)


1. Pencatatan konsol

   1. Untuk Windows: Buka alat pengembang browser (F12).

   1. Cari pesan terkait WebRTC berikut yang mengonfirmasi inisialisasi Omnissa: R `TC.js is using OmnissaVDIStrategy`

      Berikut ini adalah contoh seperti apa pesan konfirmasi itu. 

      ```
      {
              "component": "softphone",
              "level": "LOG",
              "text": " RTC.js is using OmnissaVDIStrategy",
              "time": "2025-04-03T20:47:40.460Z",
              "exception": null,
              "objects": [],
              "line": 64,
              "agentResourceId": "20c6b5a3-259e-4e18-a8a7-b962d54a6344",
              "loggerId": "1743713238678-pz6yp1q4n9s",
              "contextLayer": "CRM"
          },
      ```

## Batasan
<a name="omnissa-limitations"></a>

Konfigurasi PKC berikut tidak didukung:
+ CCP Asli: Optimalisasi audio untuk CCP asli tidak didukung. Media akan terus mengalir melalui browser di dalam VM untuk panggilan yang ditangani menggunakan yang sama.
+ Adaptor CTI Salesforce: Tidak mendukung deteksi platform VDI, menghasilkan perutean media melalui browser VM alih-alih pemrosesan audio sisi klien yang dioptimalkan.

# Gunakan ruang kerja agen untuk mengoptimalkan audio untuk desktop cloud Citrix, Amazon WorkSpaces, dan Omnissa
<a name="optimize-audio-cdd"></a>

Anda dapat menggunakan ruang kerja agen Amazon Connect untuk menyederhanakan penyampaian pengalaman suara berkualitas tinggi di lingkungan Amazon WorkSpaces, Citrix, dan Omnissa Virtual Desktop Infrastructure (VDI). 

Amazon Connect mendukung [pengoptimalan audio untuk desktop cloud Amazon WorkSpaces](using-ccp-vdi-workspaces.md), [Citrix](using-ccp-vdi-citrix-step-by-step.md), dan [Omnissa](using-ccp-vdi-omnissa-step-by-step.md). Pengoptimalan ini mengalihkan media dari desktop lokal agen ke Amazon Connect. Ini merampingkan pengalaman agen dan meningkatkan kualitas audio dengan mengurangi hop jaringan. Agen Anda dapat memanfaatkan pengoptimalan audio ini di ruang kerja agen.

## Hal-hal penting untuk diketahui
<a name="optimize-audio-cdd-important-notes"></a>
+ Untuk pengguna non SSO, jika agen menavigasi ke ruang kerja agen dari situs web Amazon Connect admin, akan ada parameter kueri untuk perujuk yang sudah ditambahkan ke URL. Format URL adalah`https://your-instance-url/agent-app-v2?referrer=admin`. Untuk membentuk parameter kueri platform VDI, hapus parameter perujuk dari URL (misalnya, Anda dapat menggunakan Notepad untuk mengedit URL). Tambahkan parameter platform VDI langsung ke `/agent-app-v2` jalur URL.
+ Untuk optimasi audio di dalam lingkungan VDI, selalu gunakan URL bookmark untuk ruang kerja agen.
+ Jika Anda tidak menggunakan ruang kerja agen di dalam lingkungan VDI yang sebenarnya, jangan tambahkan parameter kueri VDI.
+ Kami menyarankan agar agen tetap menggunakan satu perangkat media selama kontak berkelanjutan dalam lingkungan VDI. Karena informasi perangkat media disampaikan pada awal kontak, jika agen beralih perangkat media selama kontak yang sedang berlangsung, mereka tidak akan dapat mengakses audio di perangkat yang diperbarui.

## Cara menggunakan optimasi audio di ruang kerja agen
<a name="howto-optimize-audio-cdd"></a>

Untuk menggunakan pengoptimalan audio di ruang kerja agen, pengguna harus memiliki parameter kueri di URL dengan nilai untuk lingkungan VDI tempat ruang kerja agen digunakan. Proses ini memberi sinyal pada Contact Control Panel (CCP) untuk melakukan pengalihan WebRTC untuk panggilan dari lingkungan VDI tertentu ke perangkat lokal yang digunakan oleh agen.

Selesaikan langkah-langkah berikut untuk menggunakan parameter kueri untuk lingkungan VDI.

### Gunakan tanpa login berbasis SSO
<a name="without-sso"></a>

1. Buka ruang kerja agen Amazon Connect, dan salin URL untuk ruang kerja agen ke Notepad.

1. Tambahkan parameter kueri dengan kunci `VDIPlatform` dan nilai yang sama dengan lingkungan VDI spesifik yang Anda miliki. Contoh:

   1. Untuk desktop cloud Citrix, nilai untuk parameter kueri adalah. `CITRIX` Kode berikut menunjukkan contoh URL lengkap: 
      + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX`

   1. Untuk desktop WorkSpaces cloud Amazon, nilai untuk parameter kueri adalah`AWS_WORKSPACE`. Kode berikut menunjukkan contoh URL lengkap:
      + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE`

   1. Untuk desktop cloud Omnissa, nilai untuk parameter kueri adalah. `OMNISSA` Kode berikut menunjukkan contoh URL lengkap:
      + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA`

1. Salin dan tempel URL ke browser agen. 

1. Kami merekomendasikan bookmark URL ini untuk semua agen. Hal ini memudahkan agen mengaksesnya di masa depan hanya dengan mengklik link bookmark.

### Gunakan dengan login berbasis SSO
<a name="with-sso"></a>

1. Jika Anda menggunakan SSO untuk langsung masuk ke ruang kerja agen Amazon Connect, Anda perlu mengubah URL status relai penyiapan SSO Anda untuk menambahkan parameter kueri VDI. Selesaikan langkah-langkah berikut untuk melakukan ini:

   1. Salin dan tempel status relai yang Anda gunakan untuk mengakses ruang kerja agen dalam status relai Penyedia Identitas (IDP) Anda. 

   1. Lihat [contoh keadaan relai URLs](configure-saml.md#destination-relay). Dalam contoh, ``%2Fagent-app-v2`` adalah tujuan. 

   1. Tambahkan `VDIPlatform` parameter dengan nilai yang sesuai ke status relai ini. Menggunakan contoh dari tautan di atas, URL status relai lengkap untuk ruang kerja agen Amazon Connect akan terlihat seperti berikut:

      1. Di Citrix Desktop

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=CITRIX`

      1. Di Amazon WorkSpaces

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=AWS_WORKSPACE`

      1. Di Omnissa

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=OMNISSA`

1. Pengaturan `VDIPlatform` dalam URL status relai secara otomatis menyetel pengoptimalan audio di ruang kerja agen untuk lingkungan VDI tertentu yang digunakan.

   1. Masuk dari IDP Anda, dan konfirmasikan bahwa ``VDIPlatform`` ada sebagai parameter kueri.