翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# VDI 環境での Amazon Connect の使用
仮想デスクトップインフラストラクチャ (VDI) 環境では、ソリューションが複雑になるため、POC の作業とパフォーマンステストを別々にして最適化する必要があります。他の WebRTC ベースのブラウザアプリケーションと同様に、 Contact Control Panel (CCP) は、シッククライアント、シンクライアント、ゼロクライアントの VDI 環境で動作し、VDI サポートチームによって適切に設定/サポート/最適化が行われます。以下は、VDI ベースの顧客に役立つ考慮事項とベストプラクティスをまとめたものです。
## スプリット CCP モデルを使用する
VDI 内で動作するメディアレス CCP と、ローカル PC 上でメディアを扱う CCP のスプリット CCP モデルを使用することをお勧めします。Amazon Connect Streams API を使用してカスタム CCP を構築するには、アプリケーションデータおよび呼び出し発信用のメディアを持たない 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/ja_jp/connect/latest/adminguide/images/use-split-ccp.png)
## クラウドデスクトップ
Citrix、Amazon WorkSpaces、または Omnissa クラウドデスクトップを使用している場合は、カスタム CCP などのエージェントユーザーインターフェイスを新規作成するか、既存のエージェントユーザーインターフェイスを更新して、音声処理をエージェントのローカルデバイスにオフロードし、音声を Amazon Connect に自動的にリダイレクトできます。これにより、エージェントエクスペリエンスが合理化され、課題が多いネットワークでの音質が向上します。開始するには、[Amazon Connect オープンソースライブラリ](https://github.com/amazon-connect/amazon-connect-streams)を使用して、カスタ CCP などのエージェントユーザーインターフェイスを新規作成することも、既存のエージェントユーザーインターフェイスを更新することもできます。
## VDI 環境を設計する際の考慮事項
+ **エージェントの場所** - エージェントが CCP を使用する場所と VDI ホストの場所との間の往復時間をできるだけ短くし、ホップ数を可能な限り少なくすることが理想的です。
+ **VDI ソリューションのホストの場所** - VDI ホストの場所が、エージェントと同じネットワークセグメントにあり、内部リソースとエッジルーターの両方のホップ数が可能な限り少ないことが理想的です。また、WebRTC と Amazon EC2 範囲の両方のエンドポイントにできるだけ小さい往復時間を設定することもできます。
+ **ネットワーク** - トラフィックがエンドポイント間を通過するホップによって、障害やレイテンシーが発生する可能性は高くなります。VDI 環境では、基本的なルートが最適化されていない場合や、パイプが十分に高速または広い場合でも、コール品質の問題が発生しやすくなります。 Direct Connect はエッジルーターから への通話品質を向上させることができますが AWS、内部ルーティングの問題には対応しません。コールオーディオの問題を回避するには、プライベート LAN/WAN をアップグレードまたは最適化するか、外部デバイスにリダイレクトする必要があります。ほとんどのシナリオでは、これが必要な場合、問題が発生しているアプリケーションは CCP だけではありません。
+ **専用リソース** - アクティビティ(例: バックアップ、大規模なファイル転送)から利用可能なエージェントリソースへの影響を回避するには、ネットワークレベルおよびデスクトップレベルで行うことが推奨されています 。リソース競合を防止するひとつの方法として、異なるリソースを使用する可能性のある他のビジネスユニットとリソースを共有するのではなく、環境を同じように使用する Amazon Connect ユーザーにデスクトップアクセスを制限します。
+ **リモート接続によるソフトフォンの使用** - VDI 環境ではオーディオ品質に影響を及ぼす可能性があります。
**ヒント**
エージェントがリモートエンドポイントに接続してその環境で動作する場合は、オーディオを外部 E.164 エンドポイントにルーティングするか、ローカルデバイスでメディアに接続してからリモート接続でシグナリングすることをお勧めします。
# Citrix クラウドデスクトップ向けの Amazon Connect 音声の最適化
Amazon Connect を使用すると、エージェントが Citrix Virtual Desktop Infrastructure (VDI) 環境を使用する際に、高品質の音声エクスペリエンスを簡単に提供できます。エージェントは、Citrix Workspaces などの Citrix リモートデスクトップアプリケーションを活用し、音声処理をローカルデバイスにオフロードして、音声を Amazon Connect に自動的にリダイレクトできます。これにより、課題が多いネットワークで音声品質が向上します。
開始するには、[Amazon Connect オープンソースライブラリ](https://github.com/amazon-connect/amazon-connect-streams)を使用して、カスタムコンタクトコントロールパネル (CCP) などのエージェントユーザーインターフェイスを新規作成することも、既存のエージェントユーザーインターフェイスを更新することもできます。
## システム要件
このセクションでは、Amazon Connect で Citrix Unified Communications SDK を使用するためのシステム要件について説明します。
+ **Citrix Workspace アプリケーションのバージョン**
最新バージョンの Citrix Workspace アプリケーションを使用することをお勧めします ([こちらのドキュメント](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/)を参照)。ただし、少なくとも CWA 2305 以降を使用する必要があります。
+ **Citrix サーバーのバージョン**
Citrix VDA (Virtual Delivery Agent) のバージョンは 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/ja_jp/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/ja_jp/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **サポートされていない CCP のデプロイ**
+ ネイティブ CCP
## 通話中のシンクライアントと Amazon Connect 間のメディアフローを確認する
+ **タスクマネージャー (Windows) を使用して確認する**
エージェントのシンクライアントで**[タスクマネージャー]** を起動し、HDX サービスが実行中かを確認します。実行中の場合は、メディアが想定どおりにリダイレクトされていることを意味します。
![\[Windows のタスクマネージャーを使用します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)
# Amazon WorkSpaces クラウドデスクトップ用の Amazon Connect 音声を最適化する
Amazon Connect では、Amazon WorkSpaces 仮想デスクトップインフラストラクチャ (VDI) 環境内で機能するエージェントに、高音質エクスペリエンスを簡単に提供できます。Amazon WorkSpaces の WebRTC リダイレクト機能を使用すると、エージェントは Amazon Connect 音声処理をローカルデバイスにリダイレクトできます。これにより、困難なネットワーク条件でも音質が向上します。この機能を使用するには、次が必要です。
+ [Amazon Connect オープンソースライブラリ](https://github.com/amazon-connect/amazon-connect-streams)を使用して、カスタムコンタクトコントロールパネル (CCP) などのエージェントユーザーインターフェイスを新規作成するか、既存のエージェントユーザーインターフェイスを更新する。
+ Amazon WorkSpaces の WebRTC リダイレクトを有効に設定する。
## システム要件
このセクションでは、Amazon Connect の WorkSpaces WebRTC リダイレクトを使用するためのシステム要件について説明します。
+ **WorkSpaces プロトコル**
WorkSpaces では Amazon DCV を使用する必要があります。詳細については、「[Amazon DCV とは](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/ja_jp/connect/latest/adminguide/images/vdi-workspaces.png)
+ **サポートされていない CCP のデプロイ**
+ ネイティブ CCP
## 通話中のエージェントマシンと Amazon Connect 間のメディアフローを確認する
+ DCV WebRTC ブラウザ拡張機能が有効で、準備完了状態であることを確認します。
# Omnissa クラウドデスクトップ用の Amazon Connect 音声を最適化する
Amazon Connect を使用すると、エージェントが Omnissa 仮想デスクトップインフラストラクチャ (VDI) 環境を使用する際に、高品質の音声エクスペリエンスを簡単に提供できます。エージェントは、Omnissa Horizon Client などの Omnissa リモートデスクトップアプリケーションを活用し、音声処理をエージェントのローカルデバイスにオフロードして、音声を Amazon Connect に自動的にリダイレクトできます。これにより、課題が多いネットワークで音声品質が向上します。
開始するには、[Amazon Connect オープンソースライブラリ](https://github.com/amazon-connect/amazon-connect-streams)を使用して、カスタムコンタクトコントロールパネル (CCP) などのエージェントユーザーインターフェイスを新規作成することも、既存のエージェントユーザーインターフェイスを更新することもできます。
## システム要件
このセクションでは、Amazon Connect で Omnissa Horizon SDK を使用するためのシステム要件について説明します。
+ **Omnissa Horizon Client のバージョン**
+ 必要な最小バージョン: エージェントとクライアントのどちらも 8.15.0 (Horizon 2503)
+ Omnissa は現在この機能について、Windows を実行しているエージェントワークステーションのみをサポートしています。
+ 最新の Omnissa クライアントをダウンロードすること
**重要**
ICE 再起動機能をサポートした最初のバージョンは 2503 リリースです。それ以前のバージョンでは、この機能はサポートされていません。
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 ウェブアプリは、拡張機能と SDK 8.15.0 以降をサポートします。
+ このブラウザ拡張機能により、Horizon Agent 内のウェブアプリで WebRTC SDK のサポートが有効になります。拡張機能は、[こちら](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/ja_jp/connect/latest/adminguide/images/omnissa-1.png)
次の図は、タスクマネージャーで実行されている wsnm.exe プロセスを示しています。
![\[wsnm.exe プロセスが実行されているタスクマネージャー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/omnissa-2.png)
+ **トラブルシューティング**
+ Omnissa ログファイルは次の場所にあります。
` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**注記**
`{pid}` は、タスクマネージャーにある Horizon クライアントの「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 の間のメディア接続が必要です。エージェントのマシンと Amazon Connect のソフトフォンメディア UDP ポート 3478 の間のトラフィックを許可するには、「[ネットワークをセットアップする](ccp-networking.md)」の手順に従います。
次の図は、UDP ポート 3478 の使用を示しています。
![\[UDP ポート 3478 の使用を示す図。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/omnissa-3.png)
## カスタム CCP で必要なコード変更
Omnissa VDI 環境で音声最適化を有効にするには、次の変更を加えてカスタム CCP を設定する必要があります。
1. CCP の初期化前に、次のコードスニペットを追加します。これは、エージェントが複数のウィンドウを開いている場合に特に重要な、CCP のウィンドウ識別を管理するのに役立ちます。タイムスタンプと「Active Softphone Tab」マーカーを追加して、アクティブな 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 が標準のウェブブラウザの音声にフォールバックすることはありません。つまり、次のようになります。
エージェントが Omnissa VM の外部で CCP にアクセスすると、通話は失敗します。
CCP 開発者は、このパラメータを設定する前に、CCP が Omnissa VM 内で実行されているかどうかを判断する必要があります。
**実装オプション**
Omnissa でのアクセスと Omnissa 以外でのアクセスに個別の URL パスを使用します。
URL パラメータを使用して環境を決定します。
API を実装して、ユーザーコンテキストに基づいて正しい設定を決定します。
## 通話中のシンクライアントと Amazon Connect の間のメディアフローを確認する方法
1. Omnissa Horizon WebRTC ブラウザ拡張機能が有効で、準備完了状態であることを確認します。
1. ブラウザツールバーの拡張機能アイコンを確認します。
1. 青いアイコンは、準備完了状態であり適切に機能することを示します。
1. グレーのアイコンは、準備中状態であり潜在的な問題があることを示します。
次の図は、Omnissa Horizon WebRTC ブラウザ拡張機能が有効で準備完了状態の場合を示しています。
![\[Omnissa Horizon WebRTC ブラウザ拡張機能が有効になっている場合。\]](http://docs.aws.amazon.com/ja_jp/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 をインストールしたら、シンクライアントで Wirehark を開き、ローカルネットワークのモニタリングを開始します。
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/ja_jp/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"
},
```
## 制限事項
以下の CCP 設定はサポートされていません。
+ ネイティブ CCP: ネイティブ CCP での音声最適化はサポートされていません。同じ設定を使用して処理された通話については、引き続きメディアが VM 内のブラウザを介して送信されます。
+ Salesforce CTI Adapter: VDI プラットフォームの検出をサポートしていないため、クライアント側で音声処理を最適化する代わりに、VM のブラウザを介してメディアがルーティングされます。
# エージェントワークスペースを使用して Citrix、Amazon WorkSpaces、および Omnissa クラウドデスクトップのオーディオを最適化する
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 にリダイレクトされます。これによりエージェントのエクスペリエンスが合理化されるとともに、ネットワークホップが減ることで音声品質も向上します。エージェントは、これらの音声最適化をエージェントワークスペースで活用できます。
## 重要事項
+ 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 環境内で進行中のコンタクトでは、エージェントが使用するメディアデバイスを 1 つにすることをお勧めします。メディアデバイス情報はコンタクトの開始時に中継されるため、エージェントがコンタクトの進行中にメディアデバイスを切り替えると、更新されたデバイスの音声にアクセスできなくなります。
## エージェントワークスペースでオーディオ最適化を使用する方法
エージェントワークスペースでオーディオ最適化を使用するには、ユーザーは URL に、エージェントワークスペースが使用される VDI 環境の値を持つクエリパラメータが必要です。このプロセスによって、その特定の VDI 環境からの通話については、エージェントが使用しているローカルデバイスへ WebRTC リダイレクトを実行するよう、コンタクトコントロールパネル (CCP) に通知されます。
VDI 環境のクエリパラメータを使用するには、次の手順を実行します。
### SSO ベースのログインではない場合
1. Amazon Connect エージェントワークスペースに移動し、エージェントワークスペースの URL をメモ帳にコピーします。
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 ベースのログインの場合
1. SSO を使用して Amazon Connect エージェントワークスペースに直接ログインする場合は、SSO セットアップのリレーステート URL を変更して VDI クエリパラメータを追加する必要があります。そのためには、以下の手順を実行します。
1. エージェントワークスペースにアクセスするために使用するリレー状態をコピーして、ID プロバイダー (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`` が存在することを確認します。