Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Optimalkan audio Amazon Connect untuk desktop cloud Omnissa
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
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
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
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
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.