

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 VDI 環境中使用 Amazon Connect
<a name="using-ccp-vdi"></a>

虛擬桌面基礎架構 (VDI)環境會為您的解決方案增添另一層複雜性，需要單獨的 POC 作業並將效能測試最佳化。 聯絡控制面板 (CCP) 可在複雜型、精簡型和極簡型用戶端 VDI 環境運作，正如其他以 WebRTC 為基礎的瀏覽器應用程式，而組態/支援/最佳化最好由您的 VDI 支援團隊處理。雖然如此，以下仍提出對我們 VDI 型客戶有幫助的考量和最佳實務。

## 使用分割 CCP 模型
<a name="use-split-ccp"></a>

建議使用分割 CCP 模型搭配在 VDI 中執行的無媒體 CCP，以及在本機 PC 上攜帶媒體的 CCP。您可以建立沒有應用程式資料和通話發訊媒體的 CCP，以使用 Amazon Connect Streams API 建置自訂 CCP。如此一來，媒體會使用標準 CCP 傳遞至本機桌面，而資料和通話控制會傳遞至與無媒體 CCP 的遠端連線。如需有關 Streams API 的詳細資訊，請參閱 GitHub 儲存庫 [https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams)。

**注意**  
**Firefox 使用者**：如果您在分割模式下使用 VDI，則無法在 VDI 外部針對 CCP 使用 Firefox 瀏覽器。CCP 會遵循 Firefox 麥克風使用指引，而且只有在 CCP 標籤成為焦點時，才具有連線至使用者麥克風的存取權。

下圖顯示客服工作站如何由本機瀏覽器和虛擬桌面組成。它透過 WebRTC 連線至 Amazon Connect，並透過 VDI 連線來連線至公司虛擬基礎設施。

![\[客服工作站、虛擬桌面、公司虛擬基礎設施和 Amazon Connect。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/use-split-ccp.png)


## 雲端桌面
<a name="use-cloud-desktops"></a>

如果您使用 Citrix、Amazon WorkSpaces 或 Omnissa 雲端桌面，您可以建立新的客服使用者介面或更新現有的客服使用者介面，例如自訂 CCP，以將音訊處理卸載至客服的本機裝置，並自動將音訊重新導向至 Amazon Connect。這樣可以在具有挑戰性的網路上獲得更簡化的客服人員體驗，並改善音訊品質。若要開始使用，您可以使用 [Amazon Connect 開放原始碼程式庫](https://github.com/amazon-connect/amazon-connect-streams)，以建立新的客服使用者介面或更新現有的客服使用者介面，例如自訂 CCP。

## 設計 VDI 環境時的考量事項
<a name="considerations-vdi"></a>
+ **客服人員的位置**–在理想情況下，使用 CCP 的客服人員位置和 VDI 主機位置之間的跳轉次數與往返時間要盡量降至最低。
+ **VDI 解決方案的主機位置**–在理想情況下，VDI 主機位置應與客服人員位於相同的網路區段，且來自內部資源和邊緣路由器的跳轉次數均應降至最低。而到 WebRTC 和 Amazon EC2 範圍端點的往返時間也應降至最低。
+ **網路**–流量在端點之間經歷的每次跳轉，都會增加故障的可能性並提高延遲的機會。如果基本路由未最佳化，或者管道不夠快速或寬廣，VDI 環境就特別會發生通話品質問題。雖然 Direct Connect 可以改善從邊緣路由器到 的呼叫品質 AWS，但無法解決內部路由問題。您可能需要升級或最佳化您的私有 LAN/WAN，或重新導向到外部裝置，避免通話音訊問題。在大部分情況下，如果需要這麼做，則 CCP 不會是唯一發生問題的應用程式。
+ **專用資源**–建議於網路和桌面層級採用，避免備份和大型檔案傳輸之類活動影響可用的客服人員資源。防止資源爭用的其中一種方式，是針對以類似方式使用環境的 Amazon Connect 使用者限制桌面存取，而非與可能以不同方式使用這些資源的其他業務單位共用資源。
+ **透過遠端連線使用軟體電話**–這在 VDI 環境中可能會導致音訊品質受到影響。
**提示**  
如果您的客服人員會連接至遠端端點並在該環境中作業，我們建議將音訊重新路由至外部 E.164 端點，或者透過本機裝置連接媒體，再經由遠端連線發出訊號。

# 最佳化 Citrix 雲端桌面的 Amazon Connect 音訊
<a name="using-ccp-vdi-citrix-step-by-step"></a>

當您的代理商使用 Citrix 虛擬桌面基礎架構 (VDI) 環境時，Amazon Connect 可讓您更輕鬆提供高品質的語音體驗。您的客服可以利用 Citrix Workspace 等 Citrix 遠端桌面應用程式，將音訊處理卸載到客服的本機裝置，並自動將音訊重新導向到 Amazon Connect，進而在具有挑戰性的網路上提高音訊品質。

若要開始使用，您可以使用 [Amazon Connect 開放原始碼程式庫](https://github.com/amazon-connect/amazon-connect-streams)以建立新的或更新現有的客服人員使用者介面，例如自訂聯絡人控制面板 (CCP)。

## 系統要求
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

本節描述將 Citrix Unified Communications SDK 與 Amazon Connect 搭配使用的系統要求。
+ **Citrix Workspace 應用程式版本**

  建議您使用最新版本的 Citrix Workspace Application，如[本文件](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/)所述。不過，您至少必須使用 CWA 2305 或更新版本。
+ **Citrix 伺服器版本**

  Citrix VDA (虛擬交付代理程式) 的版本建議為 2203 LTSR 或更新版本。
+ **Citrix 伺服器安裝**

  預設不支援使用 Citrix UC SDK，系統管理員需要新增允許清單註冊表項目，如下所示：
  + **鍵路徑：** `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService`
  + **鍵名稱：** `ProcessWhitelist`
  + **鍵類型：** `REG_MULTI_SZ`
  + **鍵值：**
    + `Chrome.exe`
    + `msedge.exe`

  在您成功設定登錄檔之後，使用**任務管理員**重新啟動 `CitrixHdxWebSocketService` 以完成設定。  
![\[使用 Windows 中的任務管理器重新啟動 CitrixHdxWebSocketService。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png)
+ **網路/防火牆配置**
  + **Citrix 伺服器配置**

    管理者需要允許 Citrix 伺服器存取 Amazon Connect TCP/443 流量到下圖提到的網域。如需詳細資訊，請參閱[設定您的網路](ccp-networking.md)。
  + **客服人員機器配置**

    此解決方案需要在客服人員的精簡型客戶端和 Amazon Connect 之間建立媒體連線。若要允許客服機器與 Amazon Connect 軟體電話媒體 UDP 連接埠 3478 之間的流量，請參閱 [設定您的網路](ccp-networking.md)。  
![\[Citrix 伺服器和客服人員電腦防火牆設定。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **不支援的 CCP 部署**
  + 原生 CCP

## 在通話期間確認精簡型客戶端和 Amazon Connect 之間的媒體串流
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ **使用工作管理員 (Windows) 進行驗證**

  在客服人員的精簡型客戶端上啟動**工作管理員**並檢查 HDX 服務是否正在執行。如果正在執行，則代表媒體正在按預期重新導向。  
![\[在 Windows 中使用工作管理員。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)

# 最佳化 Amazon WorkSpaces 雲端桌面的 Amazon Connect 音訊
<a name="using-ccp-vdi-workspaces"></a>

Amazon Connect 可為在 Amazon WorkSpaces 虛擬桌面基礎結構 (VDI) 環境中操作的客服簡化高品質語音體驗的交付。透過利用 Amazon WorkSpaces 搭配 WebRTC 重新導向功能，客服可以將 Amazon Connect 音訊處理重新導向至其本機裝置。這種方法會提高音訊品質，即使在嚴峻的網路情況下也是如此。若要利用此功能，您需要執行下列動作：
+ 使用 [Amazon Connect 開放原始碼程式庫](https://github.com/amazon-connect/amazon-connect-streams)，以建立新的客服使用者介面或更新現有的客服使用者介面，例如自訂聯絡人控制台 (CCP)。
+ 設定 Amazon WorkSpaces 以啟用 WebRTC 重新導向。

## 系統要求
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

本節描述使用 Amazon Connect 搭配 WorkSpaces WebRTC 重新導向的系統要求。
+ **WorkSpaces 通訊協定**

  WorkSpaces 需要使用 Amazon DCV。如需詳細資訊，請參閱[什麼是 Amazon VPC？](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html)。
+ **用戶端版本**

  使用者應使用 WorkSpaces Web Access 或 WorkSpaces Windows 用戶端 5.21.0 版或更新版本。完成[設定和安裝](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup)指示。
+ **群組政策**

  需要在 DCV 群組政策中啟用 WebRTC 重新導向。在[管理 DCV 的群組政策設定](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv)主題中，開啟標題為**啟用或停用 DCV 的 WebRTC 重新導向**的收合章節，並完成這些指示。
+ **網路/防火牆組態**
  + **Workspace VDI 組態**

    管理者需要允許 Workspaces 存取流向下圖所提網域的 Amazon Connect TCP/443 流量。如需詳細資訊，請參閱[設定您的網路](ccp-networking.md)。
  + **客服人員機器配置**

    此解決方案需要在客服精簡型客戶端與 Amazon Connect 之間建立媒體連線。若要允許客服機器與 Amazon Connect 軟體電話媒體 UDP 連接埠 3478 之間的流量，請參閱[設定您的網路](ccp-networking.md)。  
![\[Workspace VDI 和客服機器防火牆設定。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/vdi-workspaces.png)
+ **不支援的 CCP 部署**
  + 原生 CCP

## 在通話期間確認客服機器與 Amazon Connect 之間的媒體串流
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ 確定 DCV WebRTC 瀏覽器延伸模組已啟用且處於備妥狀態。

# 最佳化 Omnissa 雲端桌面的 Amazon Connect 音訊
<a name="using-ccp-vdi-omnissa-step-by-step"></a>

當您的客服使用 Omnissa 虛擬桌面基礎結構 (VDI) 環境時，Amazon Connect 可讓您更輕鬆提供高品質的語音體驗。您的客服可以利用 Omnissa Horizon Client 等 Omnissa 遠端桌面應用程式，將音訊處理卸載到客服的本機裝置，並自動將音訊重新導向到 Amazon Connect，進而在具有挑戰性的網路上提高音訊品質。

若要開始使用，您可以使用 [Amazon Connect 開放原始碼程式庫](https://github.com/amazon-connect/amazon-connect-streams)以建立新的或更新現有的客服人員使用者介面，例如自訂聯絡人控制面板 (CCP)。

## 系統要求
<a name="using-ccp-vdi-omnissa-step-by-step-requirements"></a>

本節描述使用 Omnissa Horizon SDK 搭配 Amazon Connect 的系統要求。
+ **Omnissa Horizon Client 版本**
  + 最低必要版本：8.15.0 (Horizon 2503)，適用於客服和用戶端
  + Omnissa 目前僅支援執行 Windows 的客服工作站使用此功能。
  + 下載最新的 Omnissa 用戶端
**重要**  
2503 版本將是支援 ICE 重新啟動功能的第一個版本。舊版不支援此功能。
Omnissa Horizon Client 版本 2503 將可透過 [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8) 取得。檢查 Customer Connect 以取得最新版本。
+ **Omnissa 延伸模組和 SDK 要求**
  + Horizon WebRTC Web 應用程式同時支援延伸模組和 SDK 8.15.0 或更新版本。
  + 此瀏覽器延伸模組啟用了 Horizon Agent 內 WebRTC SDK 的 Web 應用程式支援，而且可從[這裡](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1)的 Chrome Store 下載。
+ **瀏覽器支援 (最近 3 個版本)**
  + Google Chrome
  + Microsoft Edge (Chromium)
+ **Omnissa 伺服器設定**：預設不會啟用 Omnissa Horizon SDK。系統管理員需要在 Omnissa Horizon Agent 虛擬機器內設定下列登錄設定 (最好透過登錄編輯程式 (regedit))：
  + **開啟登錄編輯器**
    + 針對 Windows：
      + 按下 **Windows \$1 R**
      + 輸入 **regedit**，然後按下 **Enter** 鍵。
  + 建立/導覽至以下登錄檔路徑：

    ```
    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
    ```

  在安裝 Omnissa 代理程式之後，無論 SDK 啟用狀態為何，html5server.exe 和 wsnm.exe 程序一律會在任務管理員中執行。下圖顯示在任務管理員中執行的 html5server.exe 程序。  
![\[任務管理員，html5server.exe 程序執行中。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/omnissa-1.png)

  下圖顯示在任務管理員中執行的 wsnm.exe 程序。  
![\[任務管理員，wsnm.exe 程序執行中。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/omnissa-2.png)
+ **疑難排解**
  + Omnissa 日誌檔案可在下列位置找到：

    ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**注意**  
`{pid}` 是指 Horizon Client "horizon-protocol.exe" 程序 ID，可在任務管理員中找到。
  + 增強型記錄的登錄設定

    若要啟用詳細記錄以進行疑難排解，請新增下列登錄項目：

    ```
    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
    ```

    這些登錄設定會啟用詳細的記錄，可協助診斷 Omnissa VDI 整合的問題。
+ **網路/防火牆組態**
  + **Omnissa VDI 組態**

    管理員需要允許 Omnissa 伺服器存取流向下圖所提網域的 Amazon Connect TCP/443 流量。請參閱[設定您的網路](ccp-networking.md)主題以進行此設定。
  + **客服工作站組態**

    此解決方案需要在客服精簡型客戶端與 Amazon Connect 之間建立媒體連線。遵循[設定您的網路](ccp-networking.md)主題，允許客服機器與 Amazon Connect 軟體電話媒體 UDP 連接埠 3478 之間的流量。

     下圖說明 UDP 連接埠 3478 的使用方式。  
![\[說明 UDP 連接埠 3478 使用方式的圖表。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/omnissa-3.png)

## 自訂 CCP 上的必要程式碼變更
<a name="omnissa-required-initccp-changes"></a>

若要在 Omnissa VDI 環境中啟用音訊最佳化，您必須使用下列變更來設定自訂 CCP。

1. 在 CCP 初始化之前新增下列程式碼片段。它有助於管理 CCP 的視窗識別，這在客服開啟多個視窗時尤其重要。它會新增時間戳記和「作用中軟體電話標籤」標記，以協助識別作用中的 CCP 視窗。

   ```
   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. 在 initCCP 組態中新增 VDI 平台參數。這是為了啟用音訊重新導向。

   ```
   softphone: {
       allowFramedSoftphone: true,  
       VDIPlatform: "OMNISSA"
   }
   ```
**重要**  
設定 `VDIPlatform: "OMNISSA"` 時，如果 Omnissa 音訊最佳化失敗，CCP 將不會回復到標準 Web 瀏覽器音訊。這表示：  
如果客服在 Omnissa VM 外部存取 CCP，通話將會失敗。
CCP 開發人員必須先判斷 CCP 是否正在 Omnissa VM 內執行，然後再設定此參數。
**實作選項**：  
使用個別的 URL 路徑進行 Omnissa 和非 Omnissa 存取。
使用 URL 參數來判斷環境。
實作 API，根據使用者內容判斷正確的組態。

## 如何在通話期間驗證精簡型客戶端與 Amazon Connect 之間的媒體流程
<a name="verify-omnissa"></a>

1. 確保 Omnissa Horizon WebRTC 瀏覽器延伸模組已啟用且處於備妥狀態。

1. 檢查瀏覽器工具列中的延伸模組圖示：

   1. 藍色圖示表示備妥狀態和適當的功能。

   1. 灰色圖示表示未備妥狀態和潛在問題。

   下圖顯示 Omnissa Horizon WebRTC 瀏覽器延伸模組在已啟用且處於備妥狀態時看起來像什麼。  
![\[Omnissa Horizon WebRTC 瀏覽器延伸模組 (啟用時)。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/omnissa-4.png)

1. 檢查程序狀態：

   1. 開啟任務管理員。

   1. 驗證 html5server.exe 和 wsnm.exe 程序是否正在執行。

   1. 確保這些程序在通話期間持續執行。如果任一程序當機，VDI 功能將會失敗。

1. 測試音訊流程：

   1. 進行測試通話

   1. 在 VM 的瀏覽器中停用麥克風存取來驗證音訊最佳化 - 通話應在本機處理音訊時繼續運作

   1. 檢查是否有任何音訊延遲或品質問題。

1. 使用 Wireshark 來驗證：

   Wireshark 是免費的開放原始碼網路封包分析器。如需詳細資訊，請參閱 Wireshark [網站](https://www.wireshark.org/)。

   1. 從[這裡](https://www.wireshark.org/download.html)下載 Wireshark。

   1. 在安裝了 Wireshark 之後，請在精簡型客戶端上開啟 wireshark，然後開始監控您的本機網路。

   1. 接通電話，然後在頂端的篩選條件列中輸入下列篩選條件：

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

   1. 驗證您是否可以看到客服機器與 Amazon Connect 之間的媒體封包流程。

   1. 如果看不到任何封包：
      + 檢查網路連線能力和防火牆規則。
      + 驗證音訊最佳化設定。
**注意**  
上面顯示的 IP 範圍適用於美國東部 (維吉尼亞北部) AWS 區域。如需其他區域的 IP 範圍，請參閱[設定您的網路](ccp-networking.md)。  
下圖顯示 IP 範圍：  

![\[Omnissa Horizon WebRTC 瀏覽器延伸模組 (啟用時)。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/omnissa-5.png)


1. 主控台記錄

   1. 對於 Windows：開啟瀏覽器開發人員工具 (F12)。

   1. 尋找確認 Omnissa 初始化的下列 WebRTC 相關訊息：R`TC.js is using OmnissaVDIStrategy`

      以下為確認訊息具體形式的範例：

      ```
      {
              "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"
          },
      ```

## 限制
<a name="omnissa-limitations"></a>

不支援以下 CCP 組態：
+ 原生 CCP：不支援原生 CCP 的音訊最佳化。針對使用相同方式處理的通話，媒體將繼續流經 VM 內的瀏覽器。
+ Salesforce CTI Adapter：不支援 VDI 平台偵測，導致媒體透過 VM 的瀏覽器路由，而不是最佳化的用戶端音訊處理。

# 使用客服人員工作區來最佳化 Citrix、Amazon WorkSpaces 和 Omnissa 雲端桌面的音訊
<a name="optimize-audio-cdd"></a>

您可以使用 Amazon Connect 代理程式工作區，在 Amazon WorkSpaces、Citrix 和 Omnissa Virtual Desktop Infrastructure (VDI) 環境中簡化高品質語音體驗的交付。

Amazon Connect 支援 [Amazon WorkSpaces 的音訊最佳化](using-ccp-vdi-workspaces.md)、[Citrix](using-ccp-vdi-citrix-step-by-step.md) 和 [Omnissa 雲端桌面](using-ccp-vdi-omnissa-step-by-step.md)。此最佳化會將媒體從客服的本機桌面重新導向至 Amazon Connect。它透過減少網路跳轉來簡化客服人員體驗並改善音訊品質。您的客服可以在客服人員工作區中利用這些音訊最佳化。

## 須知事項
<a name="optimize-audio-cdd-important-notes"></a>
+ 對於非 SSO 使用者，如果客服人員從 Amazon Connect 管理員網站導覽至客服人員工作區，則參考者的查詢參數已附加至 URL。URL 的格式為 `https://your-instance-url/agent-app-v2?referrer=admin`。若要形成 VDI 平台查詢參數，請從 URL 移除推薦網站參數 (例如，您可以使用記事本編輯 URL)。將 VDI 平台參數直接附加到 URL 的 `/agent-app-v2` 路徑。
+ 如需在 VDI 環境內進行音訊最佳化，請一律使用加上書籤的客服人員工作區 URL。
+ 如果您不是在實際的 VDI 環境內使用客服人員工作區，請勿附加 VDI 查詢參數。
+ 我們建議客服在 VDI 環境內進行持續聯絡期間保留一個媒體裝置。由於媒體裝置資訊會在聯絡開始時轉送，因此如果客服在持續聯絡期間切換媒體裝置，他們將無法存取已更新裝置中的音訊。

## 如何在客服人員工作區中使用音訊最佳化
<a name="howto-optimize-audio-cdd"></a>

若要在客服人員工作區中使用音訊最佳化，使用者需要在 URL 中具有查詢參數，其值為使用客服人員工作區的 VDI 環境。此程序會向聯絡人控制台 (CCP) 發出訊號，以針對從該特定 VDI 環境到客服所使用本機裝置的通話執行 WebRTC 重新導向。

請完成下列步驟，針對 VDI 環境使用查詢參數。

### 在沒有 SSO 型登入的情況下使用
<a name="without-sso"></a>

1. 前往 Amazon Connect 客服人員工作區，並將客服人員工作區的 URL 複製到 Notepad。

1. 附加金鑰為 `VDIPlatform` 且值等於您所擁有特定 VDI 環境的查詢參數。例如：

   1. 對於 Citrix 雲端桌面，查詢參數的值為 `CITRIX`。下列程式碼顯示完整 URL 的範例。
      + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX`

   1. 對於 Amazon WorkSpaces 雲端桌面，查詢參數的值為 `AWS_WORKSPACE`。下列程式碼顯示完整 URL 的範例。
      + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE`

   1. 對於 Omnissa 雲端桌面，查詢參數的值為 `OMNISSA`。下列程式碼顯示完整 URL 的範例。
      + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA`

1. 複製 URL 並將其貼入客服的瀏覽器中。

1. 我們建議為所有客服將此 URL 加上書籤。這使得未來只要按一下已加上書籤的連結，客服即可輕鬆存取。

### 搭配 SSO 型登入使用
<a name="with-sso"></a>

1. 如果您使用 SSO 直接登入 Amazon Connect 代理程式工作區，則需要變更 SSO 設定的轉送狀態 URL，以附加 VDI 查詢參數。請完成下列步驟以執行此動作：

   1. 複製並貼上您用來在身分提供者 (IdP) 轉送狀態下存取客服人員工作區的轉送狀態。

   1. 請參閱[轉送狀態 URL 的範例](configure-saml.md#destination-relay)。在範例中，``%2Fagent-app-v2`` 是目的地。

   1. 將具有適當值的 `VDIPlatform` 參數新增至此轉送狀態。使用來自上述連結的範例，Amazon Connect 客服人員工作區的完整轉送狀態 URL 將如下所示：

      1. 在 Citrix 桌面中

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

      1. 在 Amazon WorkSpaces 中

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

      1. 在 Omnissa 中

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

1. 在轉送狀態 URL `VDIPlatform` 中設定 會自動為正在使用的特定 VDI 環境，在客服人員工作區中設定音訊最佳化。

   1. 從您的 IdP 登入，並確認 ``VDIPlatform`` 以查詢參數的形式存在。