HDX™ウェブカメラビデオ圧縮

最終公開日 : Nov 13, 2026
Related information
Linux VDA を構成する

概要

Linux VDAセッションで実行されているビデオ会議アプリケーションのユーザーは、HDXウェブカメラビデオ圧縮を使用してウェブカメラを利用できるようになりました。この機能はデフォルトで有効になっています。可能な場合は常にHDXウェブカメラビデオ圧縮を使用することをお勧めします。
HDXウェブカメラビデオ圧縮は、最適化されたウェブカメラモードとも呼ばれます。このタイプのウェブカメラビデオ圧縮は、H.264ビデオを仮想セッションで実行されているビデオ会議アプリケーションに直接送信します。HDXウェブカメラビデオ圧縮は、クライアントオペレーティングシステムの一部であるマルチメディアフレームワークテクノロジーを使用して、キャプチャデバイスからのビデオをインターセプトし、トランスコードして圧縮します。キャプチャデバイスの製造元は、OSカーネルストリーミングアーキテクチャに接続するドライバーを提供します。
クライアントはウェブカメラとの通信を処理します。その後、クライアントはビデオを適切に表示できるサーバーにのみ送信します。サーバーはウェブカメラを直接処理しませんが、その統合により、デスクトップで同じエクスペリエンスが得られます。Workspaceアプリは、帯域幅を節約し、WANシナリオでの回復力を向上させるためにビデオを圧縮します。
ウェブカメラ圧縮
注:
  • この機能は、Citrix WorkspaceアプリクライアントからのH.264ビデオのみをサポートします。
  • サポートされているウェブカメラの解像度は、48x32から1920x1080の範囲です。
  • ウェブカメラを使用しているときに、Citrix Workspace™アプリのツールバーから汎用USBデバイスを選択しないでください。そうしないと、予期しない問題が発生する可能性があります。
    汎用USBデバイス

サポートされているLinuxディストリビューション

  • RHEL 8.3/CentOS 8.3
  • RHEL 7.9/CentOS 7.9
  • ウブントゥ 20.04
  • ウブントゥ 18.04
  • ウブントゥ 16.04
  • デビアン 10

完全にテストされたウェブカメラ

ウェブカメラによってフレームレート、明るさ、コントラストのレベルが異なります。Citrix®は、初期機能検証のために以下のウェブカメラを使用しています。
  • ロジクール HD ウェブカメラ C270
  • ロジクール ウェブカメラ C930e
  • マイクロソフト ライフカム HD3000

構成

この機能はデフォルトで有効になっています。これを使用するには、以下の検証と構成を完了してください。
ヒント:
Citrix Workspaceアプリのユーザーは、Desktop ViewerのマイクとWebカメラ設定で、接続しないを選択することにより、デフォルト設定を上書きできます。 接続しない
  1. VDAのインストールが完了したら、VDAがDelivery Controller™に登録できること、および公開されたLinuxデスクトップセッションがWindows資格情報を使用して正常に起動できることを確認します。
  2. VDAがインターネットにアクセスできることを確認し、その後、sudo /opt/Citrix/VDA/sbin/ctxwcamcfg.shコマンドを実行してWebカメラの構成を完了します。VDAがインターネットにアクセスできない場合は、手順3に進んでください。
    VDAがDebian 10に展開されている場合は、最新のカーネルバージョンで実行されていることを確認してください。そうでない場合は、以下のコマンドを実行して最新のカーネルバージョンに更新してください。
    sudo apt-get update
    sudo apt-get dist-upgrade
    sudo reboot
    ctxwcamcfg.shスクリプトは、次のことを支援します。
    1. VDAにFFmpeg、kernel-devel、およびDynamic Kernel Module Support (DKMS) プログラムをインストールします。
      • FFmpegはビデオデコードに使用されます。
      • kernel-develは、対応するバージョンの仮想Webカメラカーネルモジュールを構築するために使用されます。
      • DKMSは、仮想Webカメラカーネルモジュールを動的に管理するために使用されます。
      注:
      RHELおよびCentOSに上記のプログラムをインストールする場合、ctxwcamcfg.shスクリプトは、VDAに以下のリポジトリをインストールして有効にします。
      • エンタープライズ Linux 用追加パッケージ (EPEL)
      • RPM フュージョン
    2. <https://github.com/umlaeute/v4l2loopback>からv4l2loopbackオープンソースコードをダウンロードし、DKMSを使用してv4l2loopbackを管理します。
      v4l2loopbackは、V4L2ループバックデバイスを作成できるカーネルモジュールです。
    3. sudo service ctxwcamsd restartコマンドを実行します。Linux VDAのWebカメラサービス（ctxwcamsd）が再起動し、HDX Webカメラビデオ圧縮機能のためにv4l2loopbackカーネルモジュールをロードします。
  3. VDAがインターネットにアクセスできない場合は、別のマシンでv4l2loopbackカーネルモジュールをビルドし、その後、VDAにコピーします。
    1. インターネットアクセスがあり、VDAと同じカーネルバージョンを持つビルドマシンを準備します。uname -rコマンドはカーネルバージョンを見つけるのに役立ちます。
    2. ビルドマシンで、sudo mkdir -p /var/xdlコマンドを実行します。
    3. VDAから/var/xdl/configure_*をビルドマシンの/var/xdl/にコピーします。
    4. ビルドマシンで、sudo /opt/Citrix/VDA/sbin/ctxwcamcfg.shコマンドを実行してカーネルモジュールをビルドします。コマンドが正常に実行されると、/var/lib/dkms/v4l2loopback/1.81b8df79107d1fbf392fdcbaa051bd227a9c94c1/$(uname -r)/x86_64/module/パスの下にv4l2loopback.koファイルが作成されます。ctxwcamcfg.shスクリプトの実行時に発生する可能性のあるエラーは無視してください。
    5. v4l2loopback.koをビルドマシンからVDAにコピーし、/opt/Citrix/VDA/lib64/の下に配置します。
    6. VDAで、sudo service ctxwcamsd restartコマンドを実行してWebカメラサービスを再起動し、v4l2loopbackカーネルモジュールをロードします。
    7. HDX Webカメラビデオ圧縮機能を使用する前に、VDAにFFmpegプログラムをインストールしてください。