マイクロソフトチームズ (クラシック) の最適化

注:

新しいMicrosoft Teams 2.1は現在、VDAで一般提供されています。このMicrosoft Teamsバージョンは、WebRTC (VDI 1.0) を使用したCitrix Microsoft Teams最適化と互換性があります。

Citrix Virtual Apps and Desktops 2402以降、msedgewebview2.exe レジストリエントリを手動で構成する必要はありません。デフォルトで許可リストに登録されているためです。

新しいMicrosoft Teamsで公開アプリケーションがサポートされるようになりました。

シトリックスは、Citrix Virtual Apps and Desktops™ および Citrix Workspace™ アプリを使用して、デスクトップベースのマイクロソフトチームズの最適化を提供します。デフォルトでは、必要なすべてのコンポーネントが Citrix Workspace アプリと Virtual Delivery Agent (VDA) にバンドルされています。

Microsoft Teamsの最適化には、VDA側のHDX™サービスと、Microsoft Teamsホスト型アプリと連携してコマンドを受信するAPIが含まれています。これらのコンポーネントは、Citrix Workspaceアプリ側のメディアエンジンへの制御仮想チャネル (CTXMTOP) を開きます。エンドポイントはマルチメディアをローカルでデコードして提供し、Citrix WorkspaceアプリのウィンドウをホストされているMicrosoft Teamsアプリに戻します。

認証とシグナリングは、他のMicrosoft Teamsサービス (チャットやコラボレーションなど) と同様に、Microsoft Teamsホスト型アプリでネイティブに実行されます。オーディオ/ビデオのリダイレクトはこれらに影響しません。

CTXMTOP はコマンドおよび制御仮想チャネルです。これは、Citrix WorkspaceアプリとVDAの間でメディアが交換されないことを意味します。

クライアントフェッチ/クライアントレンダリングのみが利用可能です。

このビデオデモンストレーションでは、Citrix仮想環境でMicrosoft Teamsがどのように機能するかを理解できます。

マイクロソフト チームズ のインストール

CitrixとMicrosoftは、Microsoft Teamsの最新バージョンを利用し、常に最新の状態に保つことを推奨しています。 リリース日が現在のバージョンのリリース日より90日以上古いMicrosoft Teamsデスクトップアプリのバージョンはサポートされていません。 サポートされていないMicrosoft Teamsデスクトップアプリのバージョンは、ユーザーにブロックページを表示し、アプリの更新を要求します。

最新の利用可能なバージョンについては、Microsoft Teamsアプリ (デスクトップおよびMac) の更新履歴を参照してください。

「Microsoft Teams のマシン全体へのインストールガイドライン に従うことをお勧めします。AppData に Microsoft Teams をインストールする .exe インストーラーの使用は避けてください。代わりに、コマンドラインから ALLUSER=1 フラグを使用して C:\Program Files (x86)\Microsoft\Teams にインストールしてください。」

msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSER=1 ALLUSERS=1

この例では、ALLUSERS=1 パラメーターも使用しています。このパラメーターを設定すると、Microsoft Teams Machine-Wide Installer が コントロールパネル の プログラムと機能 に表示されます。また、コンピューターのすべてのユーザーの Windows 設定の アプリと機能 にも表示されます。管理者権限を持つすべてのユーザーは、Microsoft Teams をアンインストールできます。

ALLUSERS=1 と ALLUSER=1 の違いを理解することが重要です。ALLUSERS=1 パラメーターは、非 VDI 環境と VDI 環境の両方で使用できます。ALLUSER=1 パラメーターは、VDI 環境でのみ使用して、マシンごとのインストールを指定します。

ALLUSER=1 モードでは、新しいバージョンがリリースされても Microsoft Teams アプリケーションは自動更新されません。このモードは、Windows Server または Windows 10 のランダム/プールされたカタログからのホスト型共有アプリやデスクトップなど、非永続的な環境に推奨されます。詳細については、MSI を使用した Microsoft Teams のインストール (VDI インストールセクション) を参照してください。

Windows 10 の専用永続 VDI 環境があるとします。Microsoft Teams アプリケーションを自動更新し、Appdata/Local の下にユーザーごとに Microsoft Teams をインストールすることを希望する場合、.exe インストーラーまたは ALLUSER=1 なしの MSI を使用します。

注:

Citrix は、ゴールデンイメージに Microsoft Teams をインストールする前に VDA をインストールすることを推奨します。このインストール順序は、ALLUSER=1 フラグを有効にするために必要です。VDA をインストールする前に仮想マシンに Microsoft Teams をインストールした場合は、Microsoft Teams をアンインストールして再インストールしてください。

リモート PC アクセスの場合

Citrix は、VDA のインストール後に Microsoft Teams バージョン 1.4.00.22472 以降をインストールすることを推奨します。そうしないと、Microsoft Teams が VDA を期待どおりに検出するために、サインアウトして再度サインインする必要があります。バージョン 1.4.00.22472 以降には、Microsoft Teams の起動時およびサインイン時に実行される VDA 検出のための拡張ロジックが含まれています。これらのバージョンには、アクティブなセッションタイプ識別 (HDX、RDP、またはクライアントマシンにローカル接続) も含まれています。ローカル接続の場合、以前のバージョンの Microsoft Teams は、特定の機能や UI 要素 (ブレイクアウトルーム、会議やチャットのポップアウトウィンドウ、会議のリアクションなど) を検出して無効にできない場合があります。

重要:

ローカルセッションから HDX セッションにローミングし、Microsoft Teams がバックグラウンドで開いたまま実行されている場合、HDX で正しく最適化するには、Microsoft Teams を終了して再起動する必要があります。 逆に、最適化された HDX セッションを介して Microsoft Teams をリモートで使用している場合、HDX セッションを切断し、デバイスで同じ Windows セッションにローカルで再接続します。オフィスで作業している場合、Microsoft Teams がリモート PC アクセス状態 (HDX またはローカル) を正しく検出できるように、Microsoft Teams を再起動する必要があります。これは、Microsoft Teams が VDI モードを評価できるのはアプリの起動時のみであり、バックグラウンドで既に実行されている間は評価できないためです。再起動しないと、Microsoft Teams はポップアウトウィンドウ、ブレイクアウトルーム、会議のリアクションなどの機能をロードできない場合があります。

アップレイヤリングの場合

Citrix App Layering を使用して VDA と Microsoft Teams のインストールを異なるレイヤーで管理する場合、コマンドラインから ALLUSER=1 フラグを使用して Microsoft Teams をインストールする前に、Windows VDA 上にレジストリキーを作成する必要があります。詳細については、マルチメディア の Citrix App Layering を使用した Microsoft Teams の最適化 セクションを参照してください。

プロファイル管理の推奨事項

Windows ServerおよびプールされたVDI Windows 10環境には、マシン全体のインストーラーを使用することをお勧めします。

コマンドラインからMSIにALLUSER=1フラグが渡されると（マシン全体のインストーラー）、Microsoft TeamsアプリはC:\Program Files (x86)（約300 MB）にインストールされます。このアプリは、ログにAppData\Local\Microsoft\TeamsMeetingAddinを、ユーザー固有の設定、ユーザーインターフェイスの要素のキャッシュなどにAppData\Roaming\Microsoft\Teams（約600～700 MB）を使用します。

重要:

ALLUSER=1フラグを渡さない場合、MSIはTeams.exeインストーラーとsetup.jsonをC:\Program Files (x86)\Teams Installerに配置します。レジストリキー（TeamsMachineInstaller）はHKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Runの下に追加されます。

その後、ユーザーがログオンすると、代わりにAppDataに最終インストールがトリガーされます。

マシン全体のインストーラー

以下は、Windows Server 64ビットVMにMicrosoft Teamsマシン全体のインストーラーをインストールすることによって作成されるフォルダー、デスクトップショートカット、およびレジストリの例です。

フォルダー:

• C:\Program Files (x86)\Microsoft\Teams
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

デスクトップショートカット:

C:\Program Files (x86)\Microsoft\Teams\current\Teams.exe

レジストリ:

• HKEY_LOCAL_MACHINE \SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run
• HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows\CurrentVersion\Run
• HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run
• 名前: Teams
• 種類: REG_SZ
• 値: C:\Program Files (x86)\Microsoft\Teams\current\Teams.exe

注:

レジストリの場所は、基盤となるオペレーティングシステムとビット数によって異なります。

推奨事項

• Microsoft Teamsのレジストリキーを削除して自動起動を無効にすることをお勧めします。これにより、同時に発生する多数のログオン（たとえば、勤務開始時など）によるVMのCPU使用率の急上昇を防ぐことができます。
• 仮想デスクトップにGPU/vGPUがない場合、パフォーマンスを向上させるために、Microsoft Teamsの設定でGPUハードウェアアクセラレーションを無効にするを設定することをお勧めします。この設定 ("disableGpu":true) は、desktop-config.json の %Appdata%\Microsoft\Teams に保存されます。ログオンスクリプトを使用してそのファイルを編集し、値を true に設定できます。
• Citrix Workspace Environment Management™ (WEM) を使用している場合は、Microsoft Teams のプロセッサ消費を管理するために CPUスパイク保護 を有効にしてください。

ユーザーごとのインストーラー

.exe インストーラーを使用する場合、インストールプロセスが異なります。すべてのファイルはAppDataに配置されます。

フォルダー:

• C:\Users\<username>\AppData\Local\Microsoft\Teams
• C:\Users\<username>\AppData\Local\Microsoft\TeamsPresenceAddin
• C:\Users\<username>\AppData\Local\Microsoft\TeamsMeetingAddin
• C:\Users\<username>\AppData\Local\SquirrelTemp
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

デスクトップショートカット:

C:\Users\<username>\AppData\Local\Microsoft\Teams\Update.exe --processStart "Teams.exe"

レジストリ:

HKEY_CURRENT_USER \SOFTWARE\Microsoft\Windows\CurrentVersion\Run

ベストプラクティス

ベストプラクティスの推奨事項は、ユースケースシナリオに基づいています。 非永続的なセットアップでMicrosoft Teamsを使用する場合、効率的なMicrosoft Teamsランタイムデータ同期のためにプロファイルキャッシュマネージャーが必要です。プロファイルキャッシュマネージャーを使用すると、ユーザーセッション中に適切なユーザー固有の情報がキャッシュされます。たとえば、ユーザー固有の情報には、ユーザーデータ、プロファイル、設定が含まれます。これら2つのフォルダー内のデータを同期します。

• C:\Users\<username>\AppData\Local\Microsoft\IdentityCache
• C:\Users\<username>\AppData\Roaming\Microsoft\Teams

非永続的なセットアップのためのMicrosoft Teamsキャッシュコンテンツ除外リスト

Microsoftドキュメントに記載されているように、Microsoft Teamsキャッシュフォルダーからファイルとディレクトリを除外します。この操作は、ユーザーキャッシュサイズを削減し、非永続的なセットアップをさらに最適化するのに役立ちます。

ユースケース: シングルセッションシナリオ

このシナリオでは、エンドユーザーは一度に1つの場所でMicrosoft Teamsを使用します。同時に2つのWindowsセッションでMicrosoft Teamsを実行する必要はありません。一般的な仮想デスクトップ展開では、各ユーザーに1つのデスクトップが割り当てられ、Microsoft Teamsは仮想デスクトップに1つのアプリケーションとして展開されます。 Citrix Profileコンテナを有効にし、Per-user installerにリストされているユーザーごとのディレクトリをコンテナにリダイレクトすることをお勧めします。

1. ゴールデンイメージにMicrosoft Teamsの全ユーザー向けインストーラー（ALLUSER=1）を展開します。
2. Citrix Profile Managementを有効にし、適切な権限でユーザープロファイルストアを設定します。

3. 以下のProfile Managementポリシー設定を有効にします: ファイルシステム > 同期 > プロファイルコンテナ – プロファイルディスクに含めるフォルダーのリスト。

   プロファイルコンテナ(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/teams-profile-container.png)

   この構成内のすべてのユーザーごとのディレクトリをリストします。これらの設定は、Citrix Workspace Environment Management (WEM) サービスを使用して構成することもできます。

4. 設定を適切なデリバリーグループに適用します。
5. 展開を検証するためにログインします。

システム要件

推奨される最小バージョン - デリバリーコントローラー (DDCs) 1906.2

以前のバージョンを使用している場合は、Microsoft Teamsの最適化を有効にするを参照してください。

サポートされているオペレーティングシステム:

• Windows Server 2022、2019、2016、2012R2 スタンダードおよびデータセンターエディション、および Server Core オプション

最小バージョン - 仮想配信エージェント (VDA) 1906.2

サポートされているオペレーティングシステム:

• ウィンドウズ 11
• Windows 10 64ビット、バージョン1607以降。VMホスト型アプリは、Citrix Workspaceアプリ for Windows 2109.1以降でサポートされています。
• Windows Server 2022、2019、2016、および2012 R2 (標準およびデータセンターエディション)

必要な要件:

• BCR_x64.msi - Microsoft Teams最適化コードを含むMSIで、GUIから自動的に起動します。VDAインストールのコマンドラインインターフェイスを使用している場合でも、除外しないでください。

推奨バージョン: Windows向けCitrix Workspaceアプリの最新現行リリース、最小バージョン: Windows向けCitrix Workspaceアプリ1907

• Windows 11 が必要です。
• Windows 10 (32ビットおよび64ビットエディション、Embeddedエディションを含む) (Windows 7のサポートはバージョン2006で終了) (Windows 8.1のサポートはバージョン2204.1で終了)。
• Windows 10 IoT Enterprise エディションの 2016 LTSB (v1607) および 2019 LTSC (v1809) バージョンがサポートされています。
• サポートされるプロセッサ (CPU) アーキテクチャ: x86およびx64 (ARMはサポートされていません)。
• エンドポイント要件: ピアツーピアビデオ会議中に720p HD解像度をサポートできる約2.2～2.4 GHzのデュアルコアCPU。
• Intel Turbo BoostまたはAMD Turbo Coreを搭載し、少なくとも2.4 GHzまでブーストできる低速 (~1.5 GHz) のデュアルコアまたはクアッドコアCPU。
• 検証済みHPシンクライアント：t630/t640、t730/t740、mt44/mt45。
• 検証済みDellシンクライアント：5070、5470 Mobile TCおよびAIO。
• 10ZiG シンクライアント検証済み：4510および5810q。
• 検証済みエンドポイントの完全なリストについては、「Thin Clients」を参照してください。
• Citrix Workspaceアプリには、最低600 MBの空きディスク容量と1 GBのRAMが必要です。
• Microsoft .NET Frameworkの最小要件はバージョン4.8です。Citrix Workspaceアプリは、システムに.NET Frameworkが存在しない場合、自動的にダウンロードしてインストールします。

管理者は、Microsoft Teams Optimization policyを変更することで、最適化モードでMicrosoft Teamsを有効/無効にできます。Citrix Workspaceアプリで最適化モードを開始したユーザーは、Microsoft Teamsを無効にできません。

最小バージョン - Linux向けCitrix Workspaceアプリケーション 2006

詳細については、Citrix Workspaceアプリ for LinuxのドキュメントにあるMicrosoft Teamsの最適化を参照してください。

ソフトウェア:

• GStreamer 1.0以降、またはCairo 2
• libc++-9.0以降
• libgdk 3.22以降
• オープンSSL 1.1.1d
• libnsl
• Ubuntu 20.04 以降のバージョン

認証機能の強化:

• リブシークレットライブラリ
• libunwind-12 ライブラリ。詳細については、llvm-12 用の libunwind-12 ライブラリ依存関係の追加を参照してください。

ハードウェア:

• ピアツーピアのビデオ会議通話中に720p HD解像度をサポートできる最低1.8 GHzデュアルコアCPU
• ベース速度1.8 GHz、Intel Turbo Boostの高速が2.9 GHz以上のデュアルコアまたはクアッドコアCPU

検証済みエンドポイントの完全なリストについては、シンクライアントを参照してください。

詳細については、Citrix Workspaceアプリをインストールするための前提条件を参照してください。

/opt/Citrix/ICAClient/config/module.iniファイルでVDWEBRTCフィールドの値をOffに更新することで、Microsoft Teamsの最適化を無効にできます。デフォルトはVDWEBRTC=Onです。更新が完了したら、セッションを再起動してください。(ルート権限が必要です)。

最小バージョン — Mac用 シトリックス ワークスペース アプリ 2012

サポートされているオペレーティングシステム:

• マックオーエス カタリナ (10.15)。
• macOS Big Sur 11.0.1以降のオペレーティングシステム。
• macOS モントレー。

サポートされる機能:

• オーディオ
• ビデオ
• 画面共有の最適化 (送受信)

注:

Citrix Viewerアプリが画面共有を機能させるには、macOSの「セキュリティとプライバシー」設定へのアクセスが必要です。ユーザーは、Appleメニュー > システム環境設定 > セキュリティとプライバシー > プライバシー > 画面収録でこの設定を行い、Citrix Viewerを選択します。

Microsoft Teamsの最適化は、Citrix Workspaceアプリ2012以降およびmacOS 10.15でデフォルトで機能します。

Microsoft Teamsの最適化を無効にする場合は、ターミナルでこのコマンドを実行し、Citrix Workspaceアプリを再起動してください。

defaults write com.citrix.receiver.nomas mtopEnabled -bool NO

最小バージョン - ChromeOSの最新バージョンで実行されているChromeOS用Citrix Workspaceアプリの最新バージョン

ハードウェア:

• Intel i3、クアッドコア2.4 GHzと同等以上の性能を持つプロセッサ。

サポートされる機能:

• オーディオ
• ビデオ
• 画面共有の最適化（送受信） - デフォルトで無効になっています。有効にする方法については、これらの設定を参照してください。

シングルサーバーのスケーラビリティ

このセクションでは、単一の物理ホストでサポートできるユーザー数または仮想マシン（VM）数を推定するための推奨事項とガイダンスを提供します。これは一般にCitrix Virtual Apps and Desktopsのシングルサーバーのスケーラビリティ（SSS）と呼ばれます。Citrix Virtual Apps（CVA）またはセッション仮想化のコンテキストでは、ユーザー密度としても一般に知られています。その目的は、主要なハイパーバイザーを実行している単一のハードウェアで、いくつのユーザーまたはVMを実行できるかを明らかにすることです。

注:

このセクションでは、SSS を推定するためのガイダンスを説明します。このガイダンスは一般的なものであり、お客様固有の状況や環境に必ずしも特化したものではない場合があります。Citrix Virtual Apps and Desktops の SSS を真に理解する唯一の方法は、Login VSI などのスケーラビリティまたはロードテストツールを使用することです。Citrix は、SSS を迅速に推定するためだけに、このガイダンスとこれらの簡単なルールを使用することをお勧めします。ただし、ハードウェアを購入したり、財務上の決定を下したりする前に、Login VSI または選択したロードテストツールを使用して結果を検証することをお勧めします。

ハードウェア (テスト対象システム)

• デル パワーエッジ R740
• Intel Xeon (Gold) 6126 @ 2.60 GHz (最大ターボ 3.70 GHz)、ソケットあたり 12 コア、Hyperthreading 有効のデュアルソケット
• 382 GB のラム
• ローカル SSD RAID 0 ストレージ (11 ディスク) 6 TB

ソフトウェア

40個の論理プロセッサを搭載し、Windows 2019 (TSVDA)がインストールされ、Citrix Virtual Apps and Desktops 2106が稼働している単一の仮想マシン VMware ESXi 6.7

用語解説

• ナレッジワーカーのワークロード: アクロバットリーダー、Freemind/Java、フォトビューアー、エッジ、およびエクセル、アウトルック、パワーポイント、ワードなどのMS Officeアプリが含まれます。
• ベースライン: ナレッジワーカーのワークロード (Microsoft Teams なし) で実行されるサーバーのスケーラビリティテスト。
• Microsoft Teams ワークロード: ナレッジワーカーの一般的なワークロード + Microsoft Teams。

Microsoft Teams のストレステスト方法

• Microsoft Teams は HDX で最適化されています。そのため、すべてのマルチメディア処理はエンドポイントまたはクライアントにオフロードされ、測定の一部ではありません。
• ワークロードが開始される前に、すべての Microsoft Teams プロセスが停止または終了されます。
• マイクロソフトチームズを開く（コールドスタート）。
• Microsoft Teams がロードされ、Microsoft Teams のプライマリウィンドウにフォーカスが当たるまでの時間を測定します。
• キーボードショートカットを使用してチャットウィンドウに切り替えます。
• キーボードショートカットを使用してカレンダーウィンドウに切り替えます。
• キーボードショートカットを使用して、特定のユーザーにチャットメッセージを送信します。
• キーボードショートカットを使用して Microsoft Teams ウィンドウに切り替えます。

結果

• Microsoft Teams ワークロード（81ユーザー）では、ベースライン（137ユーザー）と比較して、スケーラビリティに40%の影響があります。
• サーバー容量を約40%（CPU）増やすと、ベースラインワークロードの場合と同じユーザー数に戻ります。
• Microsoft Teams ワークロードでは、ベースラインと比較して20%の追加メモリが必要です。
• ユーザーあたりのストレージサイズを512～1024 MB増やします。
• IOPS書き込みが約50%増加し、IOPS読み取りが約100%増加します。Microsoft Teams は、ストレージが遅い環境では大きな影響を与える可能性があります。

機能マトリックスとバージョンサポート

1. CD Viewer は全画面モードのみです。SHIFT+F2 はサポートされていません。
2. Negotiate/Kerberos、NTLM、ベーシック、およびダイジェスト。Pacファイルもサポートされています。
3. 匿名のみ。
4. VDAが2112以降の場合、ライブキャプションは、Citrix WorkspaceアプリのバージョンがMAC用2203.1、Linux用2203、またはWindows用2112の場合にのみ機能します。これは、Microsoft TeamsがシングルウィンドウUIモードまたはマルチウィンドウモードのどちらであるかによって、ライブキャプションの動作が異なるためです。
5. マルチウィンドウは2112 VDAで導入されましたが、VDA 1912 LTSR CU6リリースにバックポートされました。

注：

• シトリックス ワークスペース アプリ for Windows 1912 CU6 (またはそれ以降) に記載されているすべての機能は、シトリックス ワークスペース アプリ for Windows 2203.1 LTSR CU1 に適用されます。
• Microsoftは、Microsoft Teamsにおけるシングルウィンドウモードのサポートを非推奨としました。これに対応するため、VDAを1912 CU6+ LTSRに、Citrix Workspaceアプリを2203 CU2+以降にアップグレードする必要があります。これらはマルチウィンドウモードをサポートしています。

Microsoft Teamsの最適化を有効にする

Microsoft Teamsの最適化を有効にするには、Microsoft Teams redirectionポリシーに記載されている管理ポリシーを使用します。このポリシーはデフォルトでONです。このポリシーが有効になっていることに加え、HDXはCitrix Workspaceアプリのバージョンが最小要件バージョン以上であることを確認します。ポリシーを有効にし、Citrix Workspaceアプリのバージョンがサポートされている場合、VDA上でHKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupportが自動的に1に設定されます。Microsoft Teamsは、VDIモードでロードするためにこのキーを読み取ります。

注：

バージョン1906.2以降のVDAを使用している場合、または管理コンソール（Studio）でポリシーが利用できない古いコントローラーバージョン（例：バージョン7.15）を使用している場合でも、VDAは最適化できます。Microsoft TeamsのHDX最適化は、VDAでデフォルトで有効になっています。

「バージョン情報 > バージョン」をクリックすると、「Citrix HDX Optimized」の凡例が表示されます。

Citrix HDX Not Connectedと表示される場合、Citrix APIはMicrosoft Teamsにロードされています。APIのロードはリダイレクトへの最初のステップです。しかし、スタックの後続部分でエラーが発生しています。このエラーは、VDAサービスまたはCitrix Workspaceアプリにある可能性が最も高いです。

凡例が表示されない場合、Microsoft Teams は Citrix API の読み込みに失敗しています。通知領域のアイコンを右クリックして Microsoft Teams を終了し、再起動してください。管理ポリシーが Prohibited に設定されておらず、Citrix Workspace アプリのバージョンがサポートされていることを確認してください。

Citrix の凡例なし(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/teams-no-api.png)

重要: セッションの再接続

• 接続が変更された場合、HDX 最適化セッションを取得するために Microsoft Teams を再起動する必要がある場合があります。たとえば、サポートされていないエンドポイント（iOS、Android 用 Workspace アプリ、または Windows/Linux/Mac の古いバージョン）からサポートされているエンドポイント（Windows/Linux/Mac/ChromeOS/HTML5 用 Workspace アプリ）にローミングする場合、またはその逆の場合などです。
• VDA に Microsoft Teams の .exe インストーラーを使用してアプリをインストールした場合も、Microsoft Teams の再起動が必要です。.exe インストーラーは、永続的な VDI 展開に推奨されます。このような場合、HDX セッションが切断状態にある間に Microsoft Teams が自動更新されることがあります。そのため、HDX セッションに再接続するユーザーは、Microsoft Teams が最適化されて実行されていないことに気づきます。
• ローカルセッションから HDX セッションにローミングする場合、HDX で最適化するために Microsoft Teams を再起動する必要があります。この操作は、リモート PC アクセスシナリオで必要です。

ネットワーク要件

Microsoft Teams は、会議や多人数通話のために Microsoft 365 のメディアプロセッサーサーバーに依存しています。また、Microsoft Teams は、以下のシナリオで Microsoft 365 トランスポートリレーに依存しています。

• ポイントツーポイント通話の2つのピアが直接接続されていない場合
• 参加者がメディアプロセッサーに直接接続されていない場合。

したがって、ピアと Microsoft 365 クラウド間のネットワークの状態が通話のパフォーマンスを決定します。ネットワーク計画に関する詳細なガイドラインについては、Microsoft 365 ネットワーク接続の原則 を参照してください。

クラウド音声およびビデオ展開全体に影響を与える可能性のあるリスクと要件を特定するために、環境を評価することをお勧めします。 ネットワークが Microsoft Teams に対応しているかテストするには、Skype for Business ネットワーク評価ツール を使用してください。サポート情報については、サポート を参照してください。

リアルタイムプロトコル (RTP) トラフィックに関する主要なネットワーク推奨事項の概要

• 支社から Microsoft 365 ネットワークに可能な限り直接接続する。
• 支社で十分な帯域幅を計画し、提供する。
• 各支社のネットワーク接続と品質を確認します。
• 支社で以下のいずれかを使用する必要がある場合は、RTP/UDPトラフィック（Citrix WorkspaceアプリのHdxRtcEngine.exeによって処理されます）が妨げられないことを確認してください。
  • プロキシサーバーのバイパス
  • ネットワークSSLインターセプト
  • ディープパケットインスペクションデバイス
  • VPNヘアピン（可能であればスプリットトンネリングを使用）

重要: VPNスプリットトンネル構成

HdxRtcEngine.exeのトラフィックはVPNトンネルから迂回させ、ユーザーのローカルインターネット接続を使用してサービスに直接接続できるようにする必要があります。これを実現する方法は、使用するVPN製品とマシンプラットフォームによって異なりますが、ほとんどのVPNソリューションでは、このロジックを適用するためのポリシーの簡単な構成が可能です。VPNプラットフォーム固有のスプリットトンネルガイダンスの詳細については、こちらのMicrosoft記事を参照してください。

WorkspaceアプリのWebRTCメディアエンジン（HdxRtcEngine.exe）は、クライアントにオフロードされるマルチメディアストリームにSecure Real-time Transport Protocol (SRTP) を使用します。SRTPはRTPに機密性と認証を提供します。この機能では、対称鍵（DTLSでネゴシエート）を使用して、AES暗号化方式でメディアと制御メッセージを暗号化します。

良好なユーザーエクスペリエンスのために、以下のメトリックが推奨されます。

詳細については、「Microsoft Teams 用に組織のネットワークを準備する」を参照してください。

帯域幅要件については、Microsoft Teams の最適化では、オーディオ (OPUS/G.722/PCM G711) およびビデオ (H264) にさまざまなコーデックを使用できます。

ピアは、セッション記述プロトコル (SDP) オファー/アンサーを使用して、通話確立プロセス中にこれらのコーデックをネゴシエートします。 ユーザーあたりのCitrixの最小推奨事項は次のとおりです。

* Opusは、6 kbpsから510 kbpsまでの固定ビットレートおよび可変ビットレートエンコーディングをサポートしています。

OpusとH264は、ピアツーピアおよび会議通話に推奨されるコーデックです。

重要:

パフォーマンスに関して、クライアントマシンでのCPU使用率では、デコードよりもエンコードの方がコストがかかります。LinuxおよびWindows版Citrix Workspaceアプリで、最大エンコード解像度をハードコードできます。詳細については、エンコーダーパフォーマンス見積もりおよびMicrosoft Teamsの最適化を参照してください。

プロキシサーバー

プロキシの場所に応じて、以下を考慮してください。

• VDAでのプロキシ構成:

  VDAで明示的なプロキシサーバーを構成し、localhostへの接続をプロキシ経由でルーティングすると、リダイレクトは失敗します。プロキシを正しく構成するには、インターネットオプション > 接続 > LAN設定 > プロキシサーバーでローカルアドレスにはプロキシサーバーを使用しない設定を選択し、127.0.0.1:9002をバイパスする必要があります。

  PACファイルを使用する場合、PACファイルからのVDAプロキシ構成スクリプトは、wss://127.0.0.1:9002に対してDIRECTを返す必要があります。そうでない場合、最適化は失敗します。スクリプトがDIRECTを返すことを確認するには、shExpMatch(url, "wss://127.0.0.1:9002/*")を使用します。

• Citrix Workspaceアプリでのプロキシ構成:

  支社がプロキシ経由でインターネットにアクセスするように構成されている場合、以下のバージョンはプロキシサーバーをサポートします:

  • Citrix Workspaceアプリ for Windows バージョン 2012 (Negotiate/Kerberos、NTLM、ベーシック、およびダイジェスト。Pacファイルもサポートされています)
  • Windows版 Citrix Workspaceアプリ バージョン 1912 CU5 (ネゴシエート/ケルベロス、NTLM、ベーシック、およびダイジェストに対応。Pacファイルもサポートされています)
  • リナックス版 Citrix Workspaceアプリ バージョン 2101 (匿名認証)
  • Citrix Workspaceアプリ Mac向け バージョン 2104 (匿名認証)

以前のバージョンのCitrix Workspaceアプリを使用しているクライアントデバイスは、プロキシ構成を読み取ることができません。これらのデバイスは、トラフィックをMicrosoft 365 TURNサーバーに直接送信します。

重要:

• クライアントデバイスがDNS解決を行うためにDNSサーバーに接続できることを確認してください。クライアントデバイスは、以下のMicrosoft TeamsリレーサーバーのFQDNを解決できる必要があります:
  • worldaz.relay.teams.microsoft.com
  • inaz.relay.teams.microsoft.com
  • uaeaz.relay.teams.microsoft.com
  • euaz.relay.teams.microsoft.com
  • usaz.relay.teams.microsoft.com
  • turn.dod.teams.microsoft.us
  • turn.gov.teams.microsoft.us

DNSリクエストが失敗した場合、外部ユーザーとのP2P通話およびメディア確立を伴う会議通話は失敗します。

• 会議サーバーの場所は、最初の参加者の仮想デスクトップの場所に基づいて選択されます (クライアントではありません)。

通話の確立とメディアフローパス

可能な場合、Citrix WorkspaceアプリのHDX WebRTCメディアエンジン (HdxRtcEngine.exe) は、ピアツーピア通話でUser Datagram Protocol (UDP) 経由の直接ネットワークSecure Real-time Transport Protocol (SRTP) 接続を確立しようとします。UDPハイポートがブロックされている場合、メディアエンジンはTCP/TLS 443にフォールバックします。

HDXメディアエンジンは、候補の検出と接続の確立のために、ICE、Session Traversal Utilities for NAT (STUN)、およびTraversal Using Relays around NAT (TURN) をサポートしています。このサポートは、エンドポイントがDNS解決を実行できる必要があることを意味します。

2つのピア間、またはピアと会議サーバー間に直接パスがなく、多人数通話または会議に参加しているシナリオを検討してください。HdxRtcEngine.exeは、Microsoft 365のMicrosoft Teamsトランスポートリレーサーバーを使用して、他のピアまたは会議がホストされているメディアプロセッサに到達します。クライアントマシンは、3つのMicrosoft 365サブネットIPアドレス範囲と4つのUDPポート (UDPがブロックされている場合はTCP/TLS 443をフォールバックとして) にアクセスできる必要があります。詳細については、通話設定 および Office 365 URLとIPアドレス範囲ID 11 のアーキテクチャ図を参照してください。

これらの範囲には、トランスポートリレーとメディアプロセッサの両方が含まれており、Azure Load Balancerによってフロントエンドされています。 Microsoft TeamsトランスポートリレーはSTUNおよびTURN機能を提供しますが、ICEエンドポイントではありません。また、Microsoft Teamsトランスポートリレーはメディア、TLSを終端したり、トランスコーディングを行ったりしません。他のピアまたはメディアプロセッサにトラフィックを転送する際、TCP (HdxRtcEngine.exeがTCPを使用する場合) をUDPにブリッジできます。

WorkspaceアプリのWebRTCメディアエンジンは、Microsoft 365クラウド内の最も近いMicrosoft Teamsトランスポートリレーに接続します。メディアエンジンは、フォールバックのためにエニーキャストIPとポート3478～3481 UDP（ワークロードごとに異なるUDPポートですが、多重化が発生する可能性があります）、または443 TCP/TLSを使用します。通話品質は、基盤となるネットワークプロトコルに依存します。UDPは常にTCPよりも推奨されるため、ブランチオフィスでUDPトラフィックに対応できるようにネットワークを設計することをお勧めします。

Microsoft Teamsが最適化モードでロードされ、HdxRtcEngine.exeがエンドポイントで実行されている場合、ICE障害により通話設定の失敗や片方向のみのオーディオ/ビデオが発生する可能性があります。通話が完了できない場合やメディアストリームが全二重でない場合は、まずエンドポイントでWiresharkトレースを確認してください。ICE候補収集プロセスに関する詳細については、Supportセクションの「ログの収集」を参照してください。

注:

エンドポイントがインターネットにアクセスできない場合でも、両方のユーザーが同じLAN上にいれば、ピアツーピア通話を行うことができる場合があります。会議は失敗します。この場合、通話設定が開始されるまでに30秒のタイムアウトがあります。

通話設定

このアーキテクチャ図を、通話フローシーケンスの視覚的な参照として使用してください。対応する手順は図に示されています。

アーキテクチャ

1. マイクロソフト チームズを起動します。
2. Microsoft TeamsはO365に対して認証を行います。テナントポリシーはMicrosoft Teamsクライアントにプッシュダウンされ、関連するTURNおよびシグナリングチャネル情報がアプリに中継されます。
3. マイクロソフト チームズはVDAで実行されていることを検出し、シトリックス JavaScript APIにAPI呼び出しを行います。
4. マイクロソフトチームズ内のシトリックスJavaScriptは、VDA上で稼働するWebSocketService.exeとの間にセキュアなWebSocket接続を確立し、ユーザーセッション内でWebSocketAgent.exeを生成します。
5. WebSocketAgent.exe は、シトリックスHDXマイクロソフトチームズリダイレクトサービス (CtxSvcHost.exe) を呼び出すことにより、汎用仮想チャネルをインスタンス化します。
6. Citrix Workspace アプリの wfica32.exe (HDX エンジン) は、HdxRtcEngine.exe と呼ばれる新しいプロセスを生成します。これは、Microsoft Teams の最適化に使用される新しい WebRTC エンジンです。

7. Citrix メディアエンジンと Teams.exe は双方向の仮想チャネルパスを持ち、マルチメディア要求の処理を開始できます。

   —–ユーザー通話——

8. ピア A が 通話 ボタンをクリックします。Teams.exe は Microsoft 365 の Microsoft Teams サービスと通信し、ピア B とのエンドツーエンドのシグナリングパスを確立します。Microsoft Teams は HdxRtcEngine に一連のサポートされている通話パラメーター (コーデック、解像度など。これらはセッション記述プロトコル (SDP) オファーとして知られています) を要求します。これらの通話パラメーターは、シグナリングパスを使用して Microsoft 365 の Microsoft Teams サービスに中継され、そこからもう一方のピアに中継されます。
9. SDP オファー/アンサー (シングルパスネゴシエーション) はシグナリングチャネルを介して行われ、ICE 接続チェック (STUN バインド要求を使用した NAT およびファイアウォールトラバーサル) が完了します。その後、Secure Real-time Transport Protocol (SRTP) メディアは HdxRtcEngine.exe ともう一方のピア (会議の場合は Microsoft 365 会議サーバー) の間で直接流れます。

マイクロソフト電話システム

Phone System は、Microsoft Teams を使用して Microsoft 365 クラウドで通話制御と PBX を可能にする Microsoft のテクノロジーです。Microsoft Teams の最適化は、Microsoft 365 Calling Plans または Direct Routing を使用して Phone System をサポートします。Direct Routing を使用すると、追加のオンプレミスソフトウェアなしで、サポートされている独自のセッションボーダーコントローラーを Microsoft Phone System に直接接続できます。 通話キュー、転送、転送、保留、ミュート、通話の再開がサポートされます。

ディーティーエムエフ

デュアルトーン多周波 (DTMF) 機能は、以下のバージョンの Citrix Workspace アプリ (およびそれ以降) でサポートされています。

• シトリックス ワークスペース アプリ Windows版 バージョン 2102
• シトリックス ワークスペース アプリ Windows版 LTSR 1912 CU5 (Windows 10 OS のみ)
• シトリックス ワークスペース アプリ Linux向け バージョン 2101
• シトリックス ワークスペース アプリ Mac向け バージョン 2101
• シトリックス ワークスペース アプリ (ChromeOS版) バージョン 2111.1

動的e911のサポート

バージョン2112以降、Citrix Workspaceアプリは動的緊急通報をサポートしています。Microsoft Calling Plans、Operator Connect、およびDirect Routingで使用する場合、次のことが可能になります。

• 緊急通報の設定とルーティング。
• セキュリティ担当者への通知。

通知は、VDAで実行されているMicrosoft Teamsクライアントではなく、エンドポイントで実行されているCitrix Workspaceアプリの現在の場所に基づいて提供されます。

Ray Baum法では、911通報者の派遣可能な位置情報を適切な公共安全応答拠点（PSAP）に送信することが義務付けられています。HDXによるMicrosoft Teamsの最適化は、以下のバージョンのCitrix Workspaceアプリで使用する場合、Ray Baum法に準拠しています。

• シトリックス ワークスペース アプリ (Windows版) バージョン 2112.1 以降
• リナックス版Citrix Workspaceアプリ バージョン2112以降
• マック版Citrix Workspaceアプリ バージョン2112以降
• ChromeOS向けCitrix Workspaceアプリ バージョン2112およびそれ以降

動的緊急通報を有効にするには、管理者はMicrosoft Teams管理センターを使用して、ネットワークまたは緊急ロケーションマップを作成するために以下を設定する必要があります。

• ネットワーク設定
• ロケーション情報サービス（LIS）

動的緊急通報の詳細については、Microsoftのドキュメントを参照してください。

Citrix WorkspaceアプリがMicrosoft Teamsに中継する派遣可能な位置情報は次のとおりです。

• シャーシID / ポートID (Link Layer Discovery Protocol (LLDP) を使用したイーサネット/スイッチ接続用)。イーサネット/スイッチ (LLDP) は以下でサポートされています。

  • Windows バージョン 8.1 および 10
  • macOS (LLDP 有効化ソフトウェアが必要)。LLDP 有効化ソフトウェアをダウンロードするには、www.microsoft.com にアクセスし、LLDP 有効化ソフトウェアを検索してください。
  • Linux (シンクライアントのオペレーティングシステム (OS) ディストリビューションに LLDP ライブラリを含める必要があります)。
• Citrix Workspace アプリがインストールされているエンドポイントの WLAN BBSID および {IPv4-IPv6; サブネット; MAC アドレス}。
  • サブネットおよび WiFi ベースの場所は、Windows、Linux、Mac 用 Workspace アプリでサポートされています。
• Citrix Workspace アプリがインストールされている OS レベルでユーザー権限が付与されている場合 (権限は HDX RTC Engine に設定されています) の緯度と経度。
  • すべての Workspace アプリプラットフォームでサポートされています。ただし、Citrix Workspace for Linux の場合、シンクライアントの OS ディストリビューションに libgps ライブラリを含める必要があります (>sudo apt-get install libgps23 gpsd lldpd)。

ファイアウォールの考慮事項

ユーザーが Microsoft Teams クライアントを使用して最適化された通話を初めて開始すると、Windows ファイアウォール設定に関する警告が表示されることがあります。この警告は、HdxTeams.exe または HdxRtcEngine.exe (HDX Overlay Microsoft Teams) の通信を許可するようユーザーに求めます。

ファイアウォールの警告 ](/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/firewall1.png)

Windows Defender ファイアウォール > 詳細設定コンソールの受信の規則の下に、次の4つのエントリが追加されます。必要に応じて、より制限の厳しい規則を適用できます。

ファイアウォールの受信の規則 ](/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/firewall2.png)

マイクロソフト チームズ と スカイプ フォー ビジネス の共存

Microsoft Teams と Skype for Business は、重複する機能を備えた2つの個別のソリューションとして並行して展開できます。 詳細については、「Microsoft Teams と Skype for Business の共存と相互運用性を理解する」を参照してください。

Citrix RealTime Optimization PackとMicrosoft Teamsマルチメディアエンジン用のHDX最適化は、環境で設定された構成を尊重します。例としては、アイランドモードや、Microsoft TeamsとのSkype for Businessコラボレーションなどがあります。また、Microsoft TeamsとのSkype for Businessコラボレーションと会議も含まれます。

周辺機器へのアクセスは、一度に1つのアプリケーションにのみ許可できます。たとえば、通話中にRealTime Media EngineがWebカメラにアクセスすると、通話中はイメージングデバイスがロックされます。デバイスが解放されると、Microsoft Teamsで利用可能になります。

マイクロソフト Teams と Skype の共存 ](/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/teams-coexist.png)

Citrix SD-WAN™: マイクロソフト Teams向けに最適化されたネットワーク接続

最適なオーディオおよびビデオ品質には、低遅延、低ジッター、低パケット損失のMicrosoft 365クラウドへのネットワーク接続が必要です。ブランチオフィス拠点のCitrix Workspaceアプリユーザーからデータセンターを経由してインターネットに接続するMicrosoft TeamsのオーディオビデオRTPトラフィックのバックホールは、過剰な遅延を引き起こす可能性があります。また、WANリンクで輻輳を引き起こす可能性もあります。Citrix SD-WANは、Microsoft 365のネットワーク接続原則に従ってMicrosoft Teamsの接続を最適化します。Citrix SD-WANは、Microsoft RESTベースのMicrosoft 365 IPアドレスとWebサービス、および近接DNSを使用して、Microsoft Teamsトラフィックを識別、分類、および誘導します。

多くの地域のビジネスブロードバンドインターネット接続は、断続的なパケット損失、過剰なジッター期間、および障害に悩まされています。

Citrix SD-WANは、ネットワークの状態が不安定または劣化している場合に、Microsoft Teamsのオーディオビデオ品質を維持するための2つのソリューションを提供します。

• Microsoft Azureを使用している場合、Azure VNETに展開されたCitrix SD-WAN仮想アプライアンス（VPX）は、シームレスなリンクフェイルオーバーやオーディオパケットレーシングなどの高度な接続最適化を提供します。
• Citrix SD-WANのお客様は、Citrix Cloud™ Directサービスを通じてMicrosoft 365に接続できます。このサービスは、すべてのインターネット向けトラフィックに対して信頼性の高い安全な配信を提供します。

ブランチオフィスのインターネット接続の品質が問題にならない場合は、遅延を最小限に抑えるだけで十分かもしれません。遅延を最小限に抑えるために、Citrix SD-WANブランチアプライアンスから最寄りのMicrosoft 365フロントドアにMicrosoft Teamsトラフィックを直接誘導します。詳細については、「Citrix SD-WAN Office 365最適化」を参照してください。

シトリックス SD-WAN ](/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/sd-wan.png)

複数ウィンドウの会議とチャット

WindowsでMicrosoft Teamsの複数の会議またはチャットウィンドウを使用できます。ポップアウト機能の詳細については、Microsoft 365サイトの「Microsoft Teams Pop-Out Windows for Chats and Meetings」を参照してください。

注:

この機能は、Citrix Workspaceアプリ for Windows 2112.1、Mac 2203、Linux 2203、ChromeOS 2303でサポートされています。VDA 2112以降が必要で、1912 CU6+ LTSRにバックポートされました。

背景のぼかしと背景効果

Windows、Mac、Linux、および ChromeOS/HTML5 用 Citrix Workspace アプリは、HDX を使用した Microsoft Teams の最適化において、背景のぼかしと背景効果をサポートしています。

背景をぼかしたり、デフォルトの画像に置き換えたりすることで、シルエット（体と顔）に会話の焦点を合わせ、予期せぬ邪魔を避けることができます。この機能は、P2P または電話会議で使用できます。

注：

この機能は Microsoft Teams の UI/ボタンと統合されています。マルチウィンドウのサポートは、VDA を 2112 以降に更新する必要がある前提条件です。詳細については、「マルチウィンドウ会議とチャット」を参照してください。

背景のぼかしと効果に関する Microsoft Teams UI コントロールには、以下の最小バージョンが必要です。

• Windows 用 シトリックス ワークスペース アプリ 2207
• マック用 シトリックス ワークスペース アプリ 2301
• リナックス用 シトリックス ワークスペース アプリ 2307
• Chrome OS 向け シトリックス ワークスペース アプリ 2303

制限事項：

• 背景画像を Microsoft Teams のデフォルト画像に置き換えるには、クライアントがインターネットに接続されている必要があります。
• 管理者およびユーザー定義の背景画像の置き換えは、Microsoft Teams UI ではサポートされていません。カスタム背景画像は、画像がクライアントにも保存されている場合、クライアントの構成設定を使用して構成できます。

カスタム背景画像の設定

以下のレジストリキーは、Microsoft Teams UI を使用してこの機能を制御する予定がない場合、または管理者がデフォルトの動作を上書きしたい場合にのみ必要です。たとえば、エンドポイントの性能が十分でないため、背景のぼかしを無効にする場合などです。

ウィンドウズの場合

カスタム背景画像を設定するには、管理者またはエンドユーザーがクライアントまたはエンドポイントで次のレジストリキーを構成する必要があります。

場所: HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream

• Name: VideoBackgroundEffect
• Type: DWORD
• 値: 0 (無効)、1 (有効)、2 (背景画像の置き換え)

値が1に設定されている場合、背景がぼやけます。この値は、エンドユーザーまたは管理者が設定できます。

値が2に設定されている場合、VideoBackgroundImageキーも存在する必要があります。この値は管理者のみが設定できます。背景画像をぼかすのではなく置き換えたい場合にのみ、次のキーが必要です。

• 名前: ビデオバックグラウンドイメージ
• データ種類は REG_SZ です。
• Value: my_image_name.jpeg

ビデオの背景画像は、C:\Program Files (x86)\Citrix\ICA Clientディレクトリに存在する必要があります。

このレジストリ構成は、Microsoft Teams UIセレクターなしでCitrix Workspaceアプリ2206で背景のぼかしまたは画像の置き換えを有効にするためにも使用できます。つまり、環境またはVDAがマルチウィンドウをサポートしていない場合でも、Citrix Workspaceアプリ2206以降でHKCUレジストリの回避策を適用して同様の結果を得ることができますが、ユーザーはHDXセッションまたはMicrosoft Teams通話中に機能を制御することはできません。

レジストリキーの変更は、HDXセッションが接続されたときにのみ有効になります。

Macの場合

User downloaded picture location: /Users/username/Downloads/any_image.png

カスタム画像をデフォルト画像として設定するには、次のコマンドを実行します。

defaults write com.citrix.HdxRtcEngine VideoBackgroundEffect -int 2

defaults write com.citrix.HdxRtcEngine VideoBackgroundImage -string "/Users/username/Downloads/any_image.png"

Linux環境での設定

ユーザーがダウンロードした画像の保存場所は、通常、以下のパスになります: /home/username/Downloads/any_image.jpg

/var/.config/citrix/hdx_rtc_engine/config.json ファイルを作成し、JSON形式で以下の構成キーを追加します。以下に例を示します。

{

"VideoBackgroundEffect":2,

"VideoBackgroundImage":"/home/username/Downloads/any_image.jpg"

}

HTML5の場合

1. HTML5Client フォルダーにある configuration.js ファイルへ移動してください。

2. backgroundEffects 属性を追加し、その属性を true に設定します。例:

   'features' : {
       'msTeamsOptimization' :
       {
           'backgroundEffects' : true
       }
   }
   <!--NeedCopy-->
   

3. 変更を保存します。

クライアントCPU消費に関する考慮事項

ぼかし機能はCPUへの負荷が少ないですが、消費量の増加が予想されます。たとえば、4コア、1.5 GHz Intel® Pentium® Silverチップ（TurboBoostで最大2.8 GHz）を搭載したシンクライアントでは、背景のぼかしによりCPU使用率が約2%増加します。平均CPU使用率は20%未満です。

Microsoft Teamsのギャラリービューとアクティブスピーカー

Microsoft Teamsは、ギャラリー、大規模ギャラリー、Togetherモードのレイアウトをサポートしています。

Microsoft Teams は、4人の参加者のビデオストリームを2x2のグリッドで表示します（ギャラリーとして知られています）。この場合、Microsoft Teams はデコードのために4つのビデオストリームをクライアントデバイスに送信します。4人を超える参加者がビデオを共有する場合、画面には直近で最もアクティブな4人の発言者のみが表示されます。

Microsoft Teams は、最大7x7のグリッドを持つラージギャラリービューも提供します。その結果、Microsoft Teams 会議サーバーは単一のビデオフィードを合成し、デコードのためにクライアントデバイスに送信するため、CPU消費量が削減されます。この単一のマトリックス形式のフィードには、ユーザーのセルフプレビュービデオも含まれる場合があります。

最後に、Microsoft Teams は新しい会議エクスペリエンスの一部である Together モードをサポートしています。AIセグメンテーション技術を使用して参加者を共有背景にデジタル配置することで、Microsoft Teams はすべての参加者を同じ講堂に配置します。

ユーザーは、会議中に省略記号メニューで ギャラリー、ラージギャラリー、または Together モードのレイアウトを選択することで、これらのモードを制御できます。

ビデオレイアウト(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/teams-video-modes.png)

ビデオのアスペクト比の制約のサポート（ウィンドウズ向けCitrix Workspaceアプリ 2102、リナックス向けCitrix Workspaceアプリ 2106、マック向けCitrix Workspaceアプリ 2106以降）：

• オプション フレームに合わせる は、ギャラリー/ラージギャラリービューで利用できます。このオプションは、ビデオサイズをサブウィンドウに収まるようにトリミングします。一方、フレームに収める は、ビデオの側面に黒いバー（レターボックス）を表示するため、トリミングは行われません。

次の表は、ギャラリーとラージギャラリーのレイアウトの比較を示しています。

マイクロソフト チームズでの画面共有

Microsoft Teamsは、ビデオベースの画面共有（VBSS）に依存しており、H264などのビデオコーデックで共有されるデスクトップを効果的にエンコードし、高解像度ストリームを作成します。HDX最適化により、受信する画面共有はビデオストリームとして扱われます。

Windows、Linux、Mac向けのCitrix Workspaceアプリ2109以降、およびChromeOS向けのCitrix Workspaceアプリ2303以降では、ユーザーは画面とビデオカメラを同時に共有できます。

以前のバージョンでは、ビデオ通話中に相手がデスクトップの共有を開始すると、元のカメラビデオフィードは一時停止されます。代わりに、画面共有ビデオフィードが表示されます。その後、相手は手動でカメラ共有を再開する必要があります。

パワーポイント ライブに関する注意

PowerPoint Liveからコンテンツを共有している場合、この制限は存在しません。その場合、他の参加者は引き続きあなたのウェブカメラとコンテンツを見ることができ、他のスライドを確認するために前後に移動できます。このシナリオでは、スライドはVDAでレンダリングされます。PowerPoint Liveのスライドデッキにアクセスするには、「共有トレイ」ボタンをクリックして提案されたPowerPointスライドのいずれかを選択するか、「参照」をクリックしてコンピューターまたはOneDriveでPowerPointファイルを見つけます。

送信画面共有も最適化され、Citrix Workspaceアプリにオフロードされます。この場合、メディアエンジンはCitrix Desktop Viewer (CDViewer.exe) ウィンドウのみをキャプチャして送信し、その周囲に赤い枠線が描画されます。Desktop Viewerと重なるローカルアプリケーションはキャプチャされません。

注

画面共有を有効にするには、Mac版Citrix Workspaceアプリで特定の権限を設定します。詳細については、「システム要件」を参照してください。

既知の制限事項:

• Desktop Viewerが無効になっている場合、またはDesktop Lockが使用されている場合、Microsoft Teamsの画面ピッカーでマルチモニター選択は利用できません。Desktop Viewerは、.ICAファイルテンプレートを編集するか、StoreFront web.configによって無効にされることがあります。SHIFT+F2ホットキーはマルチモニター画面共有と互換性がありません。
• Workspaceアプリのバージョン2106より前では、プライマリモニターのみが共有されます。通話中の他の参加者に見えるように、仮想デスクトップ内のアプリケーションをプライマリモニターにドラッグしてください。
• Citrix Workspaceアプリを仮想モニターレイアウト機能（単一の物理モニターの論理パーティション）で構成した場合、マルチモニター画面共有が機能しない可能性があります。この場合、すべての仮想モニターは複合画像として共有されます。
• Citrix Workspaceアプリ for Windowsの古いバージョン（1907から2008まで）では、クライアントマシンで実行されているローカルアプリケーションも共有されます。この共有は、ローカルアプリがDesktop Viewerの上にオーバーレイされている場合にのみ可能です。この動作は、2009.6以降および1912 CU5以降で削除されました。
• 画面共有中に、ウィンドウモードから全画面表示に切り替えると、画面共有が停止します。画面共有を機能させるには、一度停止してから再度共有する必要があります。
• 最適化されたMicrosoft Teamsでは、共有コントロールを特定の場所にピン留めすることはできません。
• 最小化されたアプリを共有すると、アプリのタイトルバーも共有される場合があります。

シームレスアプリケーションからの画面共有:

Microsoft Teamsをスタンドアロンのシームレスアプリケーションとして公開している場合、画面共有は物理エンドポイントのローカルデスクトップをキャプチャします。Citrix Workspaceアプリの最小バージョン1909が必要です。

アプリ共有

ウィンドウズ向けCitrix Workspaceアプリ 2112.1およびVDA 2112以降、マイクロソフトチームズはアプリ共有をサポートしています。

Citrix Workspaceアプリ for Windows 2109、Mac 2203、Linux 2209、およびVDA 2109以降、Microsoft Teamsは仮想セッションで実行されている特定のアプリの画面共有をサポートしています。最適化されたMicrosoft Teamsを使用して、Javaのようなカスタムの社内アプリケーションも共有できます。特定のアプリを共有するには:

1. リモートセッション内でMicrosoft Teamsアプリに移動します。
2. Microsoft Teams UIでコンテンツを共有をクリックします。
3. 会議で共有するアプリを選択します。選択したアプリの周囲に赤い枠が表示され、通話中の参加者は共有されたアプリを見ることができます。

別のアプリを共有するには、もう一度コンテンツを共有をクリックし、新しいアプリを選択します。

アプリ共有を無効にする場合は、HKLM\SOFTWARE\Citrix\GraphicsにあるVDAで次のレジストリキーを作成します。 名前: UseWsProvider 種類: DWORD 値: 0

注：

• アプリを最小化すると、Microsoft Teamsは共有アプリの最後の画像を表示します。画面共有を再開するには、ウィンドウを最大化できます。
• 画面共有は、VDA側でのウィンドウのキャプチャに依存します。その後、コンテンツは最大速度でCitrix Workspaceアプリに中継されます。最大速度は1秒あたり30フレームです。Citrix Workspaceアプリは、コンテンツをピアまたは会議サーバーに転送します。

特定のアプリの画面共有に関する既知の制限事項：

• アプリを画面共有しているとき、マウスポインターは表示されません。
• 共有中にアプリを最小化すると、画面ピッカーにはアプリのアイコンのみが表示されます。画面ピッカーでアプリのサムネイルはプレビューされません。アプリを最大化するまで、コンテンツを共有できず、赤い枠も表示されません。
• LAAアプリは、VDAの最適化されたMicrosoft Teamsでデスクトップアプリと共有できるアプリのリストを表示します。ただし、リストからアプリを選択しても、期待どおりの結果が得られない場合があります。

アプリ保護との互換性 特定のアプリの画面共有は、HDX最適化されたMicrosoft Teamsのアプリ保護機能と互換性があります。アプリ保護が有効になっているデリバリーグループからアプリまたはデスクトップを起動した場合、特定のアプリを画面共有できます。

Microsoft Teams UIでコンテンツを共有をクリックすると、画面ピッカーからデスクトップオプションが削除されます。開いているアプリを共有するには、ウィンドウオプションのみを選択できます。

注：

アプリ保護が有効になっているデリバリーグループからアプリまたはデスクトップを起動した場合、Citrix Workspaceアプリ for Windows 2202以前を使用していると、受信ビデオまたは画面共有を表示できません。

Microsoft Teamsで制御を付与および要求する

この機能は、Citrix Workspaceアプリの以下のバージョンでサポートされています（VDAバージョンやオペレーティングシステム、シングルセッションまたはマルチセッションには依存しません）。

• Windows向けCitrix Workspaceアプリケーション バージョン2112.1以降
• Mac向けシトリックス ワークスペースアプリ バージョン2203.1以降
• Linux向けシトリックス ワークスペースアプリ バージョン2203以降
• ChromeOS向けシトリックス ワークスペース アプリ バージョン2303以降

参加者が画面を共有しているMicrosoft Teams通話中に、制御を要求できます。制御を取得すると、共有画面に対して選択、編集、またはその他のキーボードおよびマウス操作を行うことができます。

画面が共有されているときに制御を取得するには、Microsoft Teams UIの[制御を要求]ボタンをクリックします。画面を共有している会議参加者は、あなたの要求を許可または拒否できます。

制御している間は、共有画面に対して選択、編集、その他の変更を行うことができます。これらの操作には、キーボードとマウスの両方を使用できます。完了したら、[制御を要求]をクリックします。

制限事項:

• ユーザーが単一のアプリ（アプリ共有とも呼ばれます）を共有している場合、制御の付与と要求は利用できません。デスクトップ全体またはモニターを共有する必要があります。
• コントロールバーを特定の場所に固定する機能は利用できません。

マイクロソフト チームズ の周辺機器

Microsoft Teamsの最適化がアクティブな場合、Citrix Workspaceアプリは周辺機器（ヘッドセット、マイク、カメラ、スピーカーなど）にアクセスします。その後、周辺機器はMicrosoft Teams UI（[設定] > [デバイス]）に適切に表示されます。

マイクロソフト Teams の最適化モード ](/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/teams-optimized-mode.png)

Microsoft Teamsはデバイスに直接アクセスしません。代わりに、メディアの取得、キャプチャ、処理のためにWorkspaceアプリのWebRTCメディアエンジンに依存します。Microsoft Teamsは、ユーザーが選択できるようにデバイスを一覧表示します。

Microsoft Teamsがアクティブなときに挿入された周辺機器は、デフォルトでは選択されません。Microsoft Teams UIの設定 > デバイス画面から、周辺機器を手動で選択する必要があります。周辺機器が選択されると、Microsoft Teamsはその周辺機器の情報をキャッシュします。その結果、同じエンドポイントからセッションに再接続すると、周辺機器が自動的に選択されます。

推奨事項:

• エコーキャンセレーション機能が内蔵されたMicrosoft Teams認定ヘッドセット。マイクとスピーカーが別々のデバイスにある追加の周辺機器を使用するセットアップでは、エコーが発生する可能性があります。例としては、マイク内蔵のWebカメラとスピーカー付きのモニターがあります。外部スピーカーを使用する場合は、マイクからできるだけ離して配置してください。また、音がマイクに屈折する可能性のある表面から離して配置してください。詳細については、www.microsoft.comにアクセスし、Microsoft Teams認定ヘッドセットを検索してください。
• マイクロソフト Teams 認定カメラ。ただし、Skype for Business 認定周辺機器はマイクロソフト Teams と互換性があります。詳細については、 にアクセスし、マイクロソフト Teams 認定カメラと Skype for Business 認定周辺機器を検索してください。
• Citrix Workspaceアプリのメディアエンジンは、オンボードH.264エンコーディング（UVC 1.1および1.5）を実行するWebカメラではCPUオフロードを利用できません。

注:

Windows用Workspaceアプリ2009.6では、24ビットまたは96 kHzを超える周波数のオーディオ形式を持つ周辺機器を取得できるようになりました。

HdxTeams.exe（Windows用Citrix Workspaceアプリ2009以前）は、以下の特定のオーディオデバイス形式（チャンネル、ビット深度、サンプルレート）のみをサポートします。

• 再生デバイス: 最大2チャンネル、16ビット、最大96,000 Hzの周波数
• 録音デバイス: 最大4チャンネル、16ビット、最大96,000 Hzの周波数

スピーカーまたはマイクのいずれかが予期される設定と一致しない場合でも、Microsoft Teamsでのデバイス列挙は失敗し、設定 > デバイスの下になしと表示されます。

HdxTeams.exeのWebrpcログには、この種類の情報が表示されます。

Mar 27 20:58:22.885 webrtcapi.WebRTCEngine Info: init. initializing...

Mar 27 20:58:23.190 webrtcapi.WebRTCEngine Error: init. couldn't create audio module!

回避策として、特定のデバイスを無効にするか、次のいずれかを実行します。

1. 「サウンドコントロールパネル (mmsys.cpl)」を開きます。
2. 再生デバイスまたは録音デバイスを選択します。
3. 「プロパティ > 詳細」に移動し、設定をサポートされているモードに変更します。

フォールバックモード

Microsoft Teamsが最適化されたVDIモードでロードに失敗した場合（Microsoft Teamsの[バージョン情報]で「Citrix HDX Not Connected」と表示される場合）、VDAはレガシーHDXテクノロジにフォールバックします。レガシーHDXテクノロジには、Webカメラのリダイレクト、クライアントオーディオのリダイレクト、マイクのリダイレクトなどがあります。Microsoft Teamsの最適化をサポートしていないWorkspaceアプリのバージョン/プラットフォームOSを使用している場合、フォールバックレジストリキーは適用されません。 フォールバックモードでは、周辺機器はVDAにマッピングされます。周辺機器は、仮想デスクトップにローカルで接続されているかのようにMicrosoft Teamsアプリに表示されます。

VDAでレジストリキーを設定することにより、フォールバックメカニズムをきめ細かく制御できるようになりました。詳細については、レジストリで管理される機能のリストにあるMicrosoft Teamsフォールバックモードを参照してください。

この機能には、Microsoft Teamsバージョン1.3.0.13565以降が必要です。

Microsoft Teamsアプリの「設定 > デバイス」タブで、最適化モードか非最適化モードかを確認するには、カメラ名が主な違いとなります。Microsoft Teamsが非最適化モードでロードされると、レガシーHDXテクノロジが起動します。Webカメラ名には、次の図に示すように「Citrix HDX」というサフィックスが付きます。スピーカーとマイクのデバイス名は、最適化モードと比較してわずかに異なる（または切り詰められる）場合があります。

レガシーHDXテクノロジが使用されている場合、Microsoft Teamsはオーディオ、ビデオ、画面共有の処理をエンドポイントのCitrix WorkspaceアプリWebRTCメディアエンジンにオフロードしません。代わりに、HDXテクノロジはサーバー側レンダリングを使用します。ビデオをオンにすると、VDAで高いCPU消費が予想されます。リアルタイムオーディオのパフォーマンスは最適ではない可能性があります。

既知の制限事項

Citrixの制限事項

シトリックス Workspace アプリの制限事項:

• HIDボタン - 通話の応答と終了はサポートされていません。音量の上げ下げはサポートされています。
• Microsoft Teamsの管理センターにおけるQoS設定は、VDIユーザーには適用されません。
• VDA上でスニッピングツールを使用している間は、ユーザーはMicrosoft Teamsコンテンツのスクリーンショットを撮ることができません。ただし、クライアント側でスニッピングツールを使用した場合、コンテンツをキャプチャできます。

VDAに関する制限事項:

• Citrix Workspaceアプリの高DPI設定をYesに構成すると、リダイレクトされたビデオウィンドウがずれて表示されます。この制限は、モニターのDPIスケーリング係数が100%を超えて設定されている場合に発生します。

Citrix WorkspaceアプリとVDAに関する制限事項:

• 最適化された通話の音量は、VDA上ではなく、クライアントマシンの音量バーを使用してのみ制御できます。

サイマルキャスト

WindowsおよびMac上の最適化されたMicrosoft Teamsビデオ会議通話でサイマルキャストがサポートされています。Linuxについては、シンクライアントベンダーにお問い合わせください。 サイマルキャストにより、すべての発信者にとって最適な通話エクスペリエンスのために適切な解像度に調整することで、異なるエンドポイント間でのビデオ会議通話の品質とエクスペリエンスが向上します。

この改善されたエクスペリエンスにより、各ユーザーは、エンドポイントの機能、ネットワークの状態など、いくつかの要因に応じて、異なる解像度（例：720p、360pなど）で複数のビデオストリームを配信する場合があります。受信側エンドポイントは、処理できる最大品質の解像度を要求し、それによってすべてのユーザーに最適なビデオエクスペリエンスを提供します。

注:

この機能は、Microsoft Teamsからのアップデートが展開された後にのみ利用可能です。ETAに関する情報については、https://www.microsoft.com/にアクセスし、Microsoft 365ロードマップを検索してください。Microsoftによってアップデートが展開されたら、ドキュメントの更新と発表についてはCTX253754を確認してください。

マイクロソフトの制限事項

• 3x3ギャラリービューはサポートされていません。Microsoft Teamsの依存関係 – 3x3グリッドがいつ利用可能になるかについては、Microsoftにお問い合わせください。
• Skype for Businessとの相互運用性は、音声通話に限定されており、ビデオモダリティはありません。
• 送受信ビデオストリームの最大解像度は720pです。
• PSTN通話の呼び出し音はサポートされていません。
• Direct Routing のメディアバイパスはサポートされていません。
• ブロードキャストおよびライブイベントのプロデューサーとプレゼンターの役割はサポートされていません。参加者の役割はサポートされていますが、最適化されていません（代わりにVDAでレンダリングされます）。
• Microsoft Teams のズームイン/ズームアウト機能はサポートされていません。
• ロケーションベースルーティングとメディアバイパスはサポートされていません。
• 通話のマージはサポートされていません（ユーザーインターフェイスにオプションが表示されません）。

シトリックスとマイクロソフトの制限事項

• 画面共有を行う際、システムオーディオを含めるオプションは利用できません。
• ChromeOS ではサイマルキャストはサポートされていません。

今後の Microsoft Teams シングルウィンドウのEOL

2024年1月31日をもって、Microsoft は VDI Microsoft Teams の最適化を使用する際のシングルウィンドウ UI の Microsoft Teams サポートを終了し、マルチウィンドウエクスペリエンスのみをサポートします。Microsoft は、2023年9月8日に M365 管理センターでこの非推奨化について通知しました（投稿 ID: MC674419）。 マルチウィンドウ機能に関する公開されている詳細は、Tech Community の記事「New Meeting and Calling Experience in Microsoft Teams」で確認できます。

注：

Citrix は、ビデオおよび画面共有のために Microsoft Teams を最適化モードで引き続き使用するには、VDA および Citrix Workspace アプリをサポートされているバージョンにアップグレードすることを推奨します。インフラストラクチャとエンドポイントをアップグレードしてマルチウィンドウをサポートしない場合、通話、ビデオ通話、および画面共有は最適化されなくなります。これにより、通話品質の問題、レイテンシーの増加、およびサーバーへの負荷の増加が発生する可能性があります。

次の表は、Citrix VDI で Microsoft Teams の最適化された通話を継続して使用するために必要な VDA および Citrix Workspace アプリの最小バージョン、LTSR バージョン、および推奨バージョンを示しています。

注：

1. 最小バージョン: これは、マルチウィンドウが初めて導入されたバージョンです。ここに記載されている最小バージョンの一部は、サポート終了となっている場合があります。
2. LTSRサポートバージョン: これは、Citrixがマルチウィンドウ向けにサポートしているLTSRバージョンです。これらのLTSRリリースの古いバージョンは動作する可能性がありますが、新しいLTSR CUバージョンがリリースされると、それらのバージョンに対するサポートは利用できなくなります。LTSRサポートポリシーの詳細については、https://support.citrix.com/support-home/kbsearch/article?articleNumber=CTX205549/faq-citrix-virtual-apps-and-desktops-and-citrix-hypervisor-long-term-service-release-ltsrを参照してください。
3. 推奨バージョン: これは、ユーザー/顧客がソフトウェアのアップグレードを選択した場合にCitrixが推奨するソフトウェアのバージョンです。これらはすべてCRバージョンです。
4. VDAおよびCWAベースバージョンのバージョン2203 LTSRには、マルチウィンドウ機能が含まれています。これらのバージョンは、公式にサポートされている最新のCUに置き換えられています。お客様は、自己の裁量でこれらのサポートされていないバージョンを引き続き使用できます。Citrixは、LTSRリリースをご利用のお客様に最新のCUへのアップグレードを推奨します。

WebRTCからのSDP形式（プランB）の非推奨のお知らせ

Citrixは、今後のリリースでWebRTCからの現在のSDP形式（プランB）のサポートを非推奨にする予定です。最適化されたMicrosoft Teamsの機能に対応するには、WebRTCでUnified Planを使用する必要があります。

影響を受ける製品

Citrix Workspaceアプリの今後のリリースでは、Citrix Workspaceアプリの今後のリリースを使用するエンドポイントと、Citrix Workspaceアプリ2108以前のバージョンを使用するエンドポイント間の通話はサポートされません。この通話の非互換性には、1912 LTSR Citrix Workspaceアプリクライアント（CWA）が含まれます。影響を受けるCWAクライアントは次のとおりです。

• Citrix Workspace app for Windows
• リナックス向けCitrix Workspaceアプリケーション
• マック向けCitrix Workspaceアプリケーション
• クローム向けシトリックス ワークスペースアプリ

プランBの代替

Citrix Workspaceアプリのバージョン2109より古いバージョンを実行している場合は、サポートされているバージョン（できれば最新のCRリリース）にアップグレードする必要があります。そうしないと、今後のリリースまたは新しいエンドポイントとの通話は接続に失敗します。フェデレーションパートナーがCitrix Workspaceをアップグレードしていない場合、今後のリリースとフェデレーション通信パートナー間の通話も完了しない可能性があります。

Citrix Workspaceアプリバージョン2108は2023年3月にサポート期限を終了しており、新しいバージョンにアップグレードする必要があります。詳細については、Citrix Workspaceアプリのバージョンサポートに関するWorkspace Appを参照してください。

Plan B の廃止の詳細については、WebRTC ドキュメントを参照してください。

補足的な情報

• Microsoft Teams の監視、トラブルシューティング、サポート
• Microsoft Teams デスクトップアプリを VM に展開する
• MSI を使用して Microsoft Teams をインストールする (VDI インストールセクション)
• シンクライアント
• スカイプ フォー ビジネス ネットワーク評価ツール
• マイクロソフト チームズ と スカイプ フォー ビジネス の共存と相互運用性を理解する