システム要件 VDI プラットフォームパラメータを設定するローカルデバイスと Connect Customer 間のメディアフローを確認する制限事項

Azure Virtual Desktop と Windows 365 の Connect Customer オーディオを最適化する

Connect Customer は、Azure Virtual Desktop (AVD) または Windows 365 クラウド PC を使用するエージェントに高品質の音声エクスペリエンスを提供します。Microsoft Multimedia Redirection (MMR) を使用すると、エージェントはオーディオ処理をローカルデバイスにオフロードし、オーディオを Connect Customer に直接リダイレクトして、困難なネットワークよりもオーディオ品質を向上させます。

開始するには、エージェントワークスペース、または GitHub ウェブサイトの Connect Customer オープンソース Streams ライブラリを使用して、カスタム問い合わせコントロールパネル (CCP) などの新しいエージェントユーザーインターフェイスを作成したり、既存のエージェントユーザーインターフェイスを更新したりできます。

システム要件

このセクションでは、Connect Customer で Microsoft Multimedia Redirection (MMR) を使用するためのシステム要件について説明します。Microsoft の要件の完全なセットについては、Microsoft ドキュメントの「マルチメディアリダイレクトの前提条件」を参照してください。

エージェントローカルデバイス

サポートされている次のいずれかのアプリからリモートセッションに接続します。Windows バージョン 2.0.297.0 以降の Windows アプリ、または Windows バージョン 1.2.5709 以降のリモートデスクトップアプリ。
Microsoft Visual C++ 再頒布可能バージョン 14.32.31332.0 以降。

Azure セッションホスト (AVD または Windows 365)

セッションホストにインストールされたマルチメディアリダイレクト。手順については、Microsoft ドキュメントの「セッションホストにマルチメディアリダイレクトをインストールする」を参照してください。
Microsoft Visual C++ 再頒布可能バージョン 14.32.31332.0 以降。

ブラウザのサポート

セッションホストの Google Chrome または Microsoft Edge の最新バージョン。MMR コールリダイレクトは、他のブラウザをサポートしていません。

MMR ブラウザ拡張機能

Microsoft Edge または Google Chrome のセッションホストにインストールされている Multimedia Redirection ブラウザ拡張機能バージョン 1.0.2605.29004 以降。リモートデスクトップマルチメディアリダイレクトサービスをインストールする単一のインストーラもブラウザ拡張機能をインストールします。インストール後、拡張機能を有効にします。手順については、Microsoft ドキュメントの「セッションホストにマルチメディアリダイレクトをインストールする」を参照してください。
プレリリース MMR 機能を使用してテストおよび検証する場合は、MMR Insider 拡張機能を設定できます。詳細については、Microsoft ドキュメントの「マルチメディアリダイレクト拡張機能のインサイダーバージョンをデプロイする」を参照してください。

リダイレクト許可リストを呼び出す

MMR 拡張機能は、AllowedCallRedirectionSitesポリシー許可リストのドメインの呼び出しのみをリダイレクトします。

エージェントが Connect Customer エージェントワークスペースまたは Connect Customer ドメインでホストされている CCP を使用している場合 (つまり、GitHub ウェブサイトで Connect Customer Streams JS を使用して CCP を初期化trueするときに allowFramedSoftphoneとして渡す場合）、アクションを実行する必要はありません。Connect Customer ドメインは、Microsoft MMR 拡張機能のデフォルトの許可リストに含まれています。
エージェントが独自のドメイン (つまり allowFramedSoftphone: false) でホストされているカスタム CCP を使用している場合、IT 管理者はグループポリシー、レジストリ、または Microsoft Intune を使用して、カスタム CCP をホストしているドメインをAllowedCallRedirectionSitesポリシーに追加する必要があります。手順とサポートされているドメイン形式については、Microsoft ドキュメントの「特定のドメインの呼び出しリダイレクトを有効にする」を参照してください。

ネットワークとファイアウォールの設定

セッションホスト設定: 次の図に示すドメインについて、Azure セッションホストが TCP/443 経由で Connect Customer に到達できるようにします。詳細については、「ネットワークをセットアップする」を参照してください。
エージェントローカルデバイス設定: このソリューションでは、エージェントのローカルデバイスと Connect Customer over Softphone Media UDP Port 3478 間のメディア接続が必要です。詳細については、「ネットワークをセットアップする」を参照してください。

Connect Customer MMR Call Redirection の Azure セッションホストとエージェントのローカルデバイスファイアウォール設定。

VDI プラットフォームパラメータを設定する

Azure VDI 環境で MMR コールリダイレクトを有効にするには、 VDIPlatformパラメータをに設定しますAZURE。このパラメータは、エージェントが CCP にアクセスする方法に応じて、次のいずれかの方法で設定できます。

エージェントワークスペース: URL にVDIPlatform=AZUREクエリパラメータを追加します。詳細については、「エージェントワークスペースでオーディオ最適化を使用する方法」を参照してください。
埋め込みまたはカスタム CCP: initCCP設定にパラメータを追加します。
```
softphone: {
    allowFramedSoftphone: true,
    VDIPlatform: "AZURE"
}
```

注記

VDIPlatform をに設定するとAZURE、CCP は Azure オーディオ最適化のみを使用し、標準のウェブブラウザオーディオにフォールバックしません。エージェントが、MMR 拡張機能がアクティブでサポートされているブラウザを使用して、適切に設定された Azure VDI 環境から CCP にアクセスしていることを確認します。

VDIPlatform パラメータを設定しない場合、Connect Customer は Azure オーディオ最適化を利用可能な場合に自動的に検出して有効にします。最適化されたオーディオパスが一貫して使用されるように、パラメータを明示的に設定することをお勧めします。

ローカルデバイスと Connect Customer 間のメディアフローを確認する

MMR ブラウザ拡張機能がインストールされ、アクティブであることを確認します。仮想デスクトップブラウザで、マルチメディアリダイレクト拡張機能アイコンを選択します。CCP が開いている場合、拡張ステータスはロード済み (強調表示されたアイコン) と表示され、呼び出しリダイレクトはアクティブであることを示すチェックマークを表示します。詳細については、Microsoft ドキュメントの「ブラウザ拡張機能のステータス」を参照してください。

拡張機能アイコンが変わり、リダイレクトステータスが示されます。次の表は、通話リダイレクトに関連するアイコンの状態を示しています。

アイコン	意味
	拡張機能がロードされ、ウェブサイトをリダイレクトできることを示します。
	拡張機能は現在通話をリダイレクトしています。
	拡張機能はロードされず、ウェブページのコンテンツがリダイレクトされないことを示します。
	拡張機能が正しくロードされませんでした。拡張機能またはリモートデスクトップマルチメディアリダイレクトサービスを再インストールしてから、もう一度試す必要がある場合があります。

通話リダイレクトが有効になっていることを確認します。ブラウザ開発者ツール (F12) を開き、コンソールで次のコマンドを実行します。期待される結果はですtrue。
```
navigator.mediaDevices.isCallRedirectionEnabled
```
メディアフローをテストします。仮想デスクトップブラウザで、CCP ドメインのマイクアクセス許可を無効にし、ページを更新します。Multimedia Redirection 拡張機能アイコンにロードされたステータスが表示されていることを確認します。

呼び出しを開始します。拡張機能アイコンに通話記号が表示されていることを確認します。マイクに話しかけ、相手に音声が聞こえることを確認します。エージェントのローカルデバイスは仮想デスクトップではなく音声を処理するため、仮想デスクトップブラウザでマイクが無効になっていても通話は機能します。

拡張機能が無効になっているか、通話リダイレクトが機能していない場合、エージェントにはマイクにアクセスできないことを示すエラーバナーが表示されます。

MMR デバッグログの収集

トラブルシューティングのために MMR ログを収集する必要がある場合は、ブラウザ拡張機能を使用してログをキャプチャします。

仮想デスクトップブラウザで、マルチメディアリダイレクト拡張機能アイコンを選択し、詳細設定の表示を選択します。
ログを収集 で、開始を選択します。
問題を再現し、拡張機能アイコンを再度選択してから、ログの収集で停止を選択します。ブラウザから 1 つ以上のログファイルをダウンロードするように求められます。

詳細については、Microsoft ドキュメントの「マルチメディアリダイレクトのトラブルシューティング」を参照してください。

注記

現在の MMR の既知の問題と制限については、Microsoft ドキュメントの「既知の問題と制限」を参照してください。

制限事項

政府のクラウド: Microsoft は、Azure Virtual Desktop for Azure US Government、または Windows 365 for GCC、GCC-High、DoD 環境では MMR をサポートしていません。
Voice Focus: VDI 環境はオーディオリダイレクトと互換性がないため、ノイズ抑制 (Voice Focus) をサポートしていません。
動画: Connect Customer は現在、動画の MMR コールリダイレクトをサポートしていません。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Omnissa クラウドデスクトップ

エージェントワークスペースを使用して Amazon WorkSpaces、、Citrix、OmnissaAzure Virtual Desktop、Windows 365クラウドデスクトップのオーディオを最適化する