Microsoft Teamsの最適化

Citrix Virtual Apps and DesktopsまたはCitrix DaaS、およびCitrix Workspaceアプリを通じたデスクトップベースのMicrosoft Teamsの最適化です。Microsoft Teamsの最適化は、Microsoft Skype for BusinessのHDX RealTimeの最適化に似ています。両者の違いは、Microsoft Teams最適化で必要となるすべてのコンポーネントはVDAとLinux向けCitrix Workspaceアプリに付属しているという点にあります。

Linux向けCitrix Workspaceアプリは、Microsoft Teams最適化でオーディオ、ビデオ、画面共有機能をサポートします。

注:

  • Microsoft Teamsの最適化は、Ubuntu 20.04以降でのみサポートされています。
  • Microsoftの最適化は、Citrix Virtual Apps and DesktopsとCitrix DaaSの両方でサポートされています。
  • Dell Wyseを使用するシンクライアントの場合、Citrix構成エディターを使用して/var/.config/citrix/hdx_rtc_engine/config.jsonファイルのパラメーターを編集します。詳しくは、Dellのドキュメントを参照してください。

ログの収集を有効にする方法については、「Microsoft Teamsのログ収集」に記載されている手順に従ってください。

システム要件については、「Microsoft Teamsの最適化」を参照してください。

詳しくは、「Microsoft Teamsの最適化」と「Microsoft Teamsリダイレクト」を参照してください。

オーディオ構成の機能強化

Microsoft Teamsが自動利得制御とノイズ抑制のオプションを構成する場合、CitrixリダイレクトのMicrosoft Teamsは構成された値を優先します。それ以外の場合、これらのオプションはデフォルトで有効になっています。ただし、Citrix Workspaceアプリ2104以降、デフォルトではエコーキャンセルオプションは無効になっています。オーディオの問題の例には、ロボットのような音声、CPUの使用率が高いために音声が途切れるなどがあります。Citrix Workspaceアプリ2112以降、管理者は以下を実行してデフォルト設定を変更し、オーディオの問題のトラブルシューティングを行うことができます:

  1. /var/.config/citrix/hdx_rtc_engine/config.jsonファイルに移動します。
  2. 次のオプションを設定します。
    • EnableAECの値を1に設定してエコーキャンセルを有効にする、または0に設定して無効にする
    • EnableAGCの値を1に設定して自動利得制御を有効にする、または0に設定して無効にする
    • EnableNSの値を1に設定してノイズ抑制を有効にする、または0に設定して無効にする
mkdir -p /var/.config/citrix/hdx_rtc_engine

vim /var/.config/citrix/hdx_rtc_engine/config.json

{

      "EnableAEC":1,"EnableAGC":1,"EnableNS":1

}
<!--NeedCopy-->

通話が確立されたら、webrpcログ(/tmp/webrpc/<current date>/)で次のエントリを監視して、変更が有効になったことを確認します:

/tmp/webrpc/Wed_Feb__2_14_56_33_2022/webrpc.log:[040.025] Feb 02 14:57:13.220 webrtcapi.NavigatorUserMedia Info: getUserMedia. audio constraints, aec=1, agc=1, ns=1
<!--NeedCopy-->

Microsoft Teamsでのエンコーダーのパフォーマンス見積もりツール

HdxRtcEngineはMicrosoft Teamsのリダイレクトを処理するCitrix Workspaceアプリに組み込まれたWebRTCメディアエンジンです。HdxRtcEngine.exeは、エンドポイントのCPUが過負荷状態になることなく維持できる最適な送信ビデオ(エンコーディング)の解像度を見積もることができます。使用できる値は、240p、360p、720p、1080pです。

パフォーマンス見積もりプロセスでは、特定のエンドポイントで達成できる最適な解像度を決定するためにマクロブロックコードを利用します。通話のセットアップ中のコーデックネゴシエーションには、可能な限り高い解像度が使用されます。コーデックネゴシエーションは、ピア間、またはピアと会議サーバー間で行われることがあります。

次の表に、エンドポイントの4つのパフォーマンスカテゴリを示します。各カテゴリに使用可能な最大解像度が指定されています:

エンドポイントのパフォーマンス 最大解像度 レジストリキー値
Fast 1080p(1920x1080 16:9 @ 30fps) 3
720p(1280x720 16:9 @ 30fps) 2
低速 360p(640x360 16:9 @ 30fpsまたは640x480 4:3 @ 30fpsのいずれか) 1
Very slow 240p(320x180 16:9 @ 30fpsまたは320x240 4:3 @ 30fpsのいずれか) 0

たとえば、発信ビデオ(エンコーディング)の解像度値を360pに設定するには、ターミナルから次のコマンドを実行します:

mkdir -p /var/.config/citrix/hdx_rtc_engine

vim /var/.config/citrix/hdx_rtc_engine/config.json

{

    "OverridePerformance":1

}
<!--NeedCopy-->

Microsoft Teamsのログ収集

Microsoft Teamsのログ収集を有効にするには:

  1. /opt/Citrix/ICAClient/debug.iniファイルに移動します。
  2. 以下のように、[HDXTeams]セクションを変更します:

    [HDXTeams]
    ; Retail logging for HDXTeams 0/1 = disabled/enabled
    HDXTeamsLogSwitch = 1
    ; Debug logging; , It is in decreasing order
    ; LS_NONE = 4, LS_ERROR = 3, LS_WARNING = 2, LS_INFO = 1, LS_VERBOSE = 0
    WebrtcLogLevel = 0
    ; None = 5, Info = 4, Warning = 3, Error = 2, Debug = 1, Trace = 0
    WebrpcLogLevel = 0
    
    <!--NeedCopy-->
    

config.jsonファイルに次の行を追加してログ収集を有効にすることもできます:

{
"WebrpcLogLevel": 0,"WebrtcLogLevel": 0
}
<!--NeedCopy-->

llvm-12にlibunwind-12ライブラリの依存関係を追加

2111リリース以降、llvm-12にlibunwind-12ライブラリと呼ばれる新しい依存関係が追加されました。ただしこれは、デフォルトでは本来のリポジトリに存在しません。次の手順で、libunwind-12ライブラリをリポジトリに手動でインストールします:

  1. ターミナルを開きます。
  2. 次の行を入力して、llvmリポジトリキーファイルをインストールします:

    
     wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key|sudo apt-key add
    <!--NeedCopy-->
    
  3. 次の行を入力して、llvmリポジトリのソース一覧を構成します:

     sudo vim /etc/apt/sources.list
    <!--NeedCopy-->
    
  4. 次の行を追加します:

    deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-12 main
    deb-src http://apt.llvm.org/bionic/ llvm-toolchain-bionic-12 main
    <!--NeedCopy-->
    
  5. 次のコマンドを実行して、libunwind-12ライブラリをインストールします:

    sudo apt-get update -y
    sudo apt-get install libunwind-12
    <!--NeedCopy-->
    

優先ネットワークインターフェイスの構成

Citrix Workspaceアプリ2303バージョン以降、メディアトラフィックの優先ネットワークインターフェイスを構成できるようになりました。この機能強化により、複数のネットワーク接続があり、デフォルトのネットワークのパフォーマンスが弱い場合、別のネットワークに変更できます。この拡張機能を有効にするには:

  1. /var/.config/citrix/hdx_rtc_engine/config.jsonファイルに移動します。
  2. 以下のセクションに移動します:

           mkdir -p /var/.config/citrix/hdx_rtc_engine
    
            vim /var/.config/citrix/hdx_rtc_engine/config.json
    
           {
    
                ”NetworkPreference”:1
    
            }
    <!--NeedCopy-->
    
  3. “NetworkPreference:”の値を、必要に応じて以下のいずれかの値に更新します:

    • 1:イーサネット
    • 2:Wi-Fi
    • 3:携帯ネットワーク
    • 4:VPN
    • 5:ループバック
    • 6:任意

デフォルトかつ値が設定されていない場合、WebRTCメディアエンジンは利用可能な最適なルートを選択します。

Microsoft Teams最適化のためのUDPポート範囲の構成

2402リリースでは、Microsoft Teamsの最適化のためにUDPポートの最小範囲と最大範囲を指定できます。何らかの理由でUDPポートを割り当てることができない場合、WebRTCはTCPにフォールバックします。この機能を有効にするには、次の2つの新しい構成項目をクライアントデバイスの/var/.config/citrix/hdx_rtc_engine/config.json構成ファイルに追加します:

  • PortRangeMinは最小UDPポートを表します
  • PortRangeMaxは最大UDPポートを表します

この機能を有効にするには、次の2つの条件が満たされていることを確認してください:

  • UDPポートの最小値と最大値を設定する必要があります。
  • 最小ポートと最大ポートの間隔は10より大きい数値にする必要があります。

この機能を有効にするには、クライアントデバイスで次の手順を実行します:

  1. /var/.config/citrix/hdx_rtc_engine/config.json構成ファイルに移動します。
  2. PortRangeMinPortRangeMaxの数値を追加します。

    // config file /var/.config/citrix/hdx_rtc_engine/config.json
    
    {
        "PortRangeMin" : 30000,
        "PortRangeMax" : 31000
    }
    <!--NeedCopy-->
    

Microsoft Teams最適化の機能強化

  • Citrix Workspaceアプリのバージョン2101以降:
    • Citrix Workspaceアプリのインストーラーは、Microsoft Teamsの着信音をパッケージ化しています。
    • オーディオ出力は、新しく接続されたオーディオデバイスに自動的に切り替わり、適切な音量が設定されます。
    • HTTPプロキシで匿名認証をサポート。
  • Citrix Workspaceアプリのバージョン2103以降、VP9ビデオコーデックはデフォルトで無効になっています。

  • Citrix Workspaceアプリのバージョン2104以降、エコーキャンセル機能はデフォルトで無効になっています。内蔵スピーカーやマイクを通話に使用しないことをお勧めします。代わりにヘッドフォンを使用してください。この修正は、シンクライアントで音声が途切れる問題に対処することを目的としています。

  • Citrix Workspaceアプリのバージョン2106以降:

    • 以前は、[画面共有] をクリックすると、デフォルトまたはメインモニターのプレビューは画面共有でのみ使用できました。

      このバージョンでは、すべての画面のプレビューが画面選択メニューに表示されます。VDA環境で画面を共有するために任意の画面を選択できます。選択したモニターに赤い四角が表示され、選択した画面のコンテンツの小さな画像が画面選択メニューに表示されます。

      シームレスモードでは、すべての画面から1つを選択して共有できます。Desktop Viewerがウィンドウモードを変更(最大化、復元、または最小化)すると、画面共有が停止します。

  • Citrix Workspaceアプリのバージョン2112以降:

    注:

    次の機能は、Microsoft Teamsから今後の更新がロールアウトされてからのみ使用できます。Microsoftによって更新プログラムがロールアウトされたら、ドキュメントのアップデートおよび発表内容について、CTX253754を確認することができます。

    • Microsoft Teamsでの制御の要求

      このリリースでは、参加者が画面を共有している場合、Microsoft Teamsの通話中に制御を要求できます。制御できるようになると、共有画面に対して選択、編集、またはその他の変更を実行できます。

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

      制御中は、共有画面に対して選択、編集、その他の変更を実行できます。入力が完了したら、[制御を停止] をクリックします。

      制限事項:

      • Linuxクライアントのユーザーは、他のユーザーに制御を渡すことはできません。つまり、Linuxクライアントのユーザーがコンテンツの共有を開始した後、[制御を渡す] オプションは共有ツールバーに表示されません。これはMicrosoftの制限です。
      • [制御を要求] オプションは、最適化ユーザーと、エンドポイントで実行されているネイティブのMicrosoft Teamsデスクトップクライアントのユーザーとの間のピアツーピア通話では使用できません。この問題を回避するために、ユーザーは会議に参加して [制御を要求] オプションを使用することができます。
    • 動的緊急通報(Dynamic e911)のサポート

      このリリースのCitrix Workspaceアプリは、動的緊急通報をサポートしています。Microsoft Calling Plans、Operator Connect、およびDirect Routingで使用すると、次の機能が提供されます:

      • 緊急通報の構成とルーティング
      • セキュリティ担当者に通知する

      通知は、VDAで実行されているMicrosoft Teamsクライアントではなく、エンドポイントで実行されているCitrix Workspaceアプリの現在の場所に基づいて送信されます。 Ray Baum法では、緊急車両を派遣可能な911発信者の位置情報を、適切な公衆安全応答ポイント(PSAP)に送信する必要があります。Linux向けCitrix Workspaceアプリ2112以降、HDXを使用したMicrosoft Teamsの最適化はRay Baum法に準拠しています。この機能をサポートするには、LLDPライブラリがシンクライアントのオペレーティングシステムディストリビューションに含まれている必要があります。

  • Citrix Workspaceアプリのバージョン2203以降:

    Microsoft Teamsのマルチウィンドウチャットと会議

    このリリースでは、Citrix Virtual Apps and Desktops 2112以降でHDXによる最適化が行われた場合、Microsoft Teamsでチャットと会議に複数のウィンドウを使用できるようになりました。会話や会議をさまざまな方法でポップアウトできます。ポップアウトウィンドウ機能について詳しくは、「Microsoft Teams Pop-Out Windows for Chats and Meetings」を参照してください。

    古いバージョンのCitrix WorkspaceアプリまたはVirtual Delivery Agent(VDA)を使用している場合は、シングルウィンドウコードが今後Microsoftによって廃止されることに注意してください。ただし、この機能がGA(一般提供)されてから、複数のウィンドウをサポートするバージョンのVDAまたはCitrix Workspaceアプリ(2203以降)にアップグレードされるまでに、最低9か月かかります。

    注:

    この機能は、Microsoft Teamsから以降の更新がロールアウトされた後にのみ使用できます。Microsoftによって更新プログラムがロールアウトされたら、ドキュメントのアップデートおよび発表内容について、CTX253754を確認することができます。

  • Citrix Workspaceアプリのバージョン2207以降:

    • アプリ共有の有効化: Linux向けCitrix Workspaceアプリ2209およびCitrix Virtual Apps and Desktops 2109より、Microsoft Teamsの画面共有機能を使用してアプリを共有できます。
    • 高DPIサポートの機能強化: 高DPI機能が有効になっており、4Kモニターを使用している場合、Microsoft Teamsビデオのオーバーレイは目的の位置に適切なサイズで表示されます。単一モニターまたはマルチモニターの配置などのディスプレイ設定に関係なく、オーバーレイは常に正しく表示され、拡大されたり、目的の位置以外に表示されたりすることはありません。この強化機能を有効にするには、wfclient.ini構成ファイルのDPIMatchingEnabledパラメーターがTrueに設定されていることを確認してください。詳しくは、「DPIマッチングのサポート」を参照してください。
    • WebRTC SDKのアップグレード: 最適化されたMicrosoft Teamsで使用されるWebRTC SDKのバージョンは、バージョンM98にアップグレードされます。
  • Citrix Workspaceアプリのバージョン2305以降:

    • 最適化されたMicrosoft Teams通話のスリープモードの機能強化

      以前は、最適化されたMicrosoft Teams会議に参加しているときに、マウスまたはキーボードの操作がない場合、Citrix Workspaceアプリまたは最適化されたMicrosoft Teams画面がスリープモードになることがありました。

      2305リリース以降、最適化されたMicrosoft Teams会議中にマウスやキーボードの操作がない場合でも、Citrix Workspaceアプリまたは最適化されたMicrosoft Teams画面はスリープモードになりません。

    • 最適化されたMicrosoft Teamsビデオ会議通話のエクスペリエンスの向上

      2305リリース以降、最適化されたMicrosoft Teamsビデオ会議通話に対して、デフォルトでサイマルキャストサポートが有効になっています。このサポートにより、すべての発信者に最適な通話エクスペリエンスを提供できる適切な解像度に適応するため、さまざまなエンドポイントでのビデオ会議通話の品質とエクスペリエンスが向上します。

      この向上したエクスペリエンスにより、各ユーザーは、エンドポイントの機能、ネットワークの状態などのいくつかの要因に応じて、複数のビデオ ストリームを異なる解像度(720p、360pなど)で配信できます。次に、受信側のエンドポイントは、可能な範囲で最高品質の解像度を要求します。これにより、すべてのユーザーに最適なビデオ体験を提供できます。

  • Citrix Workspaceアプリのバージョン2307以降:

     **Background blurring and replacement for Citrix Optimized Microsoft Teams**
    
     **Prerequisite:**
    
     Ensure that you have installed the `wget`.
    
     Starting with version 2307 for Citrix Workspace app, Citrix Optimized Microsoft Teams in Citrix Workspace app for Linux now supports background blurring and background replacement. You can use this feature by selecting **More** > **Apply Background Effects** when you are in a meeting or in a P2P call.
    
     For more information, see [Background blurring and background effects](/ja-jp/citrix-virtual-apps-desktops/multimedia/opt-ms-teams#background-blurring-and-background-effects).
    
  • Citrix Workspaceアプリのバージョン2308以降:

    • セカンダリ呼び出しのサポート

      セカンダリ呼び出し機能を使用して、最適化されたMicrosoft Teamsで受信通知を受け取るセカンダリデバイスを選択できます。たとえば、スピーカーをセカンダリ呼び出し機器として設定し、エンドポイントがヘッドフォンに接続されているとします。この場合、ヘッドフォンが音声通話自体のプライマリの周辺機器であっても、Microsoft Teamsは受信信号をスピーカーに送信します。次の場合、セカンダリ呼び出しを設定することはできません:

      • 複数のオーディオデバイスが接続されていない場合
      • 周辺機器(Bluetoothヘッドセットなど)が利用できない場合
    • 最適化されたMicrosoft Teamsで短いトーンを再生するサポートを追加

      以前は、ビープ音や通知などの短いメロディやトーンが繰り返し再生されていました。たとえば、ゲストがMicrosoft Teams会議に参加するときのトーンが繰り返し再生されました。これを回避する唯一の方法は、Microsoft Teamsを終了して再起動することでした。この問題により、エンドユーザーエクスペリエンスが低下していました。

      2308リリースでは、Citrix Workspaceアプリが必要性に応じた短いトーンの再生をサポートします。このサポートでは、セカンダリ呼び出し機能も有効にすることができます。

      前提条件:

      Microsoft Teamsを最新バージョンに更新してください。

Microsoft Teamsの最適化