リファレンス

マルチメディアポリシー設定

マルチメディアセクションには、ユーザーセッションでのストリーミングHTML5およびWindowsオーディオとビデオを管理するためのポリシー設定が含まれています。

警告

レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrix®は、レジストリエディターの誤った使用によって生じる問題が解決されることを保証できません。レジストリエディターは自己責任で使用してください。編集する前に必ずレジストリをバックアップしてください。

マルチメディアポリシー

デフォルトでは、Delivery Controller™で設定されたすべてのマルチメディアポリシーは、次のレジストリに保存されます。

マシンポリシー:

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\MultimediaPolicies

ユーザーポリシー:

HKEY_LOCAL_MACHINE\Software\Policies\Citrix{User Session ID}\User\MultimediaPolicies

現在のユーザーセッションIDを見つけるには、Windowsコマンドラインでqwinstaコマンドを発行します。

HTML5ビデオのリダイレクト

Citrix Virtual Apps and Desktops™サーバーがHTML5マルチメディアWebコンテンツをユーザーに配信する方法を制御および最適化します。

デフォルトでは、この設定は無効になっています。

HTML5リダイレクトグラフィックイメージ

このリリースでは、この機能は管理対象のWebページでのみ利用可能です。HTML5マルチメディアコンテンツ(例えば、社内トレーニングサイトのビデオなど)が利用可能なWebページにJavaScriptを追加する必要があります。

HTML5ビデオリダイレクトを構成するには:

  1. Copy the file, HdxVideo.js, from %Program Files%/Citrix/ICA Service/HTML5 Video Redirection on the VDA install to the location of your internal webpage.
  2. この行をWebページに挿入します(Webページに他のスクリプトがある場合は、それらのスクリプトの前にHdxVideo.jsを含めます)。 <script src="HdxVideo.js" type="text/javascript"\></script>

注: HdxVideo.jsがWebページと同じ場所にない場合は、src属性を使用してそのフルパスを指定してください。

JavaScriptが管理対象のWebページに追加されておらず、ユーザーがHTML5ビデオを再生する場合を考えてみましょう。この場合、Citrix Virtual Apps and Desktopsはデフォルトでサーバー側レンダリングになります。

HTML5ビデオのリダイレクトを機能させるためには、Windows Media Redirectionを許可する必要があります。このポリシーは、Server Fetch Client Renderにおいては必須であり、Client Side Fetchingにおいても必要です。Client Side Fetchingを機能させるには、さらにWindows Media client-side content fetchingが許可されていることも求められます。

Microsoft Edgeはこの機能をサポートしていません。

HdxVideo.jsは、ブラウザのHTML5プレーヤーコントロールを独自のコントロールに置き換えます。特定のWebサイトでHTML5ビデオリダイレクトポリシーが有効になっていることを確認するには、プレーヤーコントロールをHTML5ビデオリダイレクトポリシーが禁止されているシナリオと比較します。

(ポリシーが許可されている場合のCitrixカスタムコントロール)

HTML5リダイレクトオーディオ画像

(ポリシーが禁止されているか、構成されていない場合のネイティブWebページコントロール)

HTML5リダイレクトビデオ画像

以下のビデオコントロールがサポートされています。

  • 再生
  • 一時停止
  • シーク
  • リピート
  • オーディオ
  • 全画面表示

HTML5ビデオリダイレクトテストページを表示できます。

TLS、HTML5ビデオリダイレクト、およびブラウザコンテンツリダイレクト

HTML5ビデオリダイレクトは、次の目的で使用できます。

  • HTTPS Webサイトからのビデオのリダイレクト
  • または
  • Webサイト全体をリダイレクトするためのブラウザコンテンツリダイレクト

The JavaScript injected into those websites must establish a TLS connection to the Citrix HDX HTML5 Video Redirection Service (WebSocketService.exe) running on the VDA. Citrix HDX HTML5 Video Redirection Service in the certificate store on the VDA generates two custom certificates to:

  • ビデオのリダイレクトを実現する
  • WebページのTLS整合性を維持する

HdxVideo.jsは、Secure WebSocketsを使用して、VDAで実行されているWebSocketService.exeと通信します。このプロセスはローカルシステムアカウントとして実行され、SSL終端とユーザーセッションマッピングを行います。

WebSocketService.exe は 127.0.0.1 のポート 9001 でリッスンしています。

ビデオ品質の制限

この設定は Windows Media にのみ適用され、HTML5 には適用されません。これには、WAN 経由の Windows Media マルチメディアリダイレクトの最適化を有効にする必要があります。

この設定は、HDX™ 接続で許可される最大ビデオ品質レベルを指定します。設定すると、最大ビデオ品質は指定された値に制限され、環境内でマルチメディアのサービス品質 (QoS) が維持されます。

デフォルトでは、この設定は構成されていません。

許可される最大ビデオ品質レベルを制限するには、次のいずれかのオプションを選択します。

  • 1080p、8.5mbps のビデオ品質
  • 720p、4.0mbps のビデオ品質
  • 480p/720kbps
  • 380ピクセル/400キロビット/秒
  • 240ピクセル/200キロビット/秒

同じサーバーで複数のビデオを同時に再生すると、大量のリソースが消費され、サーバーのスケーラビリティに影響を与える可能性があります。

マイクロソフト チームズ の リダイレクト

この設定は、HDX テクノロジーに基づいた Microsoft Teams の最適化を有効にします。

このポリシーが有効で、サポートされているバージョンのCitrix Workspace™アプリを使用している場合、このレジストリキーはVDA上で1に設定されます。Microsoft Teamsアプリケーションは、VDIモードでロードするためにこのキーを読み取ります。 レジストリキーを手動で設定する必要はありません。

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

Name: MSTeamsRedirSupport

値: DWORD (1 - オン, 0 - オフ)

注:

Web Studioでポリシーが利用できない古いバージョンのControllerで、バージョン1906.2以降のVDAを使用している場合を考慮してください。Controllerの古いバージョンの例として、バージョン7.15があります。この場合、HDX最適化はVDAでデフォルトで有効になっています。Workspaceアプリのバージョンが1907以降の場合、Microsoft Teamsは最適化モードで起動します。7.15 LTSR ControllerとCR VDAの混在に関する注意点については、Knowledge Centerの記事CTX205549を参照してください。

この場合、特定のユーザーに対して機能を無効にするには、レジストリ設定を上書きできます。ユーザーの組織単位にログオンスクリプトを適用するグループポリシーを使用して、レジストリ設定を上書きします。

デフォルトでは、Microsoft Teamsリダイレクトは有効になっています。

マルチメディア会議

この設定は、ビデオ会議アプリケーションによる最適化されたWebカメラリダイレクト技術の使用を許可または禁止します。

デフォルトでは、ビデオ会議のサポートは許可されています。

この設定をポリシーに追加する際は、Windows Mediaリダイレクト設定が存在し、許可(デフォルト)に設定されていることを確認してください。

マルチメディア会議を使用する場合、以下の条件が満たされていることを確認してください。

  • マルチメディア会議に使用されるWebカメラ用のメーカー提供のドライバーがクライアントにインストールされていること。
  • ビデオ会議セッションを開始する前に、Webカメラをユーザーデバイスに接続します。サーバーは、一度に1つのインストールされたWebカメラのみを使用します。ユーザーデバイスに複数のWebカメラがインストールされている場合、サーバーは各Webカメラを順番に試行します。この試行は、ビデオ会議セッションが正常に作成されるまで続行されます。

ジェネリックUSBリダイレクトを使用してWebカメラをリダイレクトする場合、このポリシーは必要ありません。その場合、WebカメラドライバーをVDAにインストールします。

WAN経由のWindows Mediaマルチメディアリダイレクトの最適化

この設定はWindows Mediaにのみ適用され、HTML5には適用されません。この設定により、以下が可能になります。

  • リアルタイムマルチメディアトランスコーディング
  • 劣化しているネットワーク経由でモバイルデバイスへのオーディオおよびビデオメディアストリーミングを許可します
  • WAN経由でのWindows Mediaコンテンツの配信方法を改善することで、ユーザーエクスペリエンスを向上させます。

デフォルトでは、WAN経由でのWindows Mediaコンテンツの配信は最適化されています。

この設定をポリシーに追加する場合は、Windows Mediaリダイレクト設定が存在し、許可に設定されていることを確認してください。

この設定が有効になっている場合、メディアストリーミングを可能にするために、必要に応じてリアルタイムマルチメディアトランスコーディングが自動的に展開されます。また、極端なネットワーク条件下でもシームレスなユーザーエクスペリエンスを提供します。

WAN経由のWindows Mediaマルチメディアリダイレクトの最適化にGPUを使用する

この設定はWindows Mediaにのみ適用され、リアルタイムマルチメディアトランスコーディングをVirtual Delivery Agent (VDA) のグラフィック処理ユニット (GPU) で実行できるようにします。これにより、サーバーのスケーラビリティが向上します。GPUトランスコーディングは、VDAがハードウェアアクセラレーションをサポートするGPUを搭載している場合にのみ利用可能です。それ以外の場合、トランスコーディングはCPUにフォールバックします。

注: GPUトランスコーディングはNVIDIA GPUでのみサポートされています。

デフォルトでは、WAN経由でのWindows Mediaコンテンツの配信を最適化するためにVDA上のGPUを使用することは禁止されています。

この設定をポリシーに追加する場合は、以下の設定が存在し、許可に設定されていることを確認してください。

  • ウィンドウズ メディア リダイレクト
  • WAN経由のWindows Mediaマルチメディアリダイレクトの最適化設定

Windows Media フォールバック防止

この設定は、ブラウザコンテンツリダイレクト、HTML5、およびWindows Mediaに適用されます。HTML5をサポートするには、HTML5ビデオリダイレクトポリシーを許可に設定します。

管理者は、Windows Media フォールバック防止ポリシー設定を使用して、ストリーミングコンテンツをユーザーに配信するために試行される方法を指定できます。

デフォルトでは、この設定は構成されていません。設定が「未構成」の場合、動作はすべてのコンテンツを再生と同じになります。

この設定を構成するには、次のいずれかのオプションを選択します。

  • すべてのコンテンツを再生。クライアント側でのコンテンツ取得を試行し、次にWindows Mediaリダイレクトを試行します。失敗した場合は、サーバーでコンテンツを再生します。
  • すべてのコンテンツをクライアントでのみ再生。クライアント側での取得を試行し、次にWindows Mediaリダイレクトを試行します。失敗した場合、コンテンツは再生されません。
  • クライアントでクライアントアクセス可能なコンテンツのみを再生。クライアント側での取得のみを試行します。失敗した場合、コンテンツは再生されません。

コンテンツが再生されない場合、プレーヤーウィンドウに次のエラーメッセージが表示されます(デフォルトの表示時間は5秒)。

"Company has blocked video because of lack of resources"

Windows Media フォールバック防止の画像(/ja-jp/citrix-virtual-apps-desktops/2311/media/redirection5.png)

このエラーメッセージの表示時間は、VDA上の次のレジストリキーでカスタマイズできます。レジストリエントリが存在しない場合、表示時間はデフォルトで5秒になります。

レジストリパスは、VDAのアーキテクチャによって異なります。

\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream

または

\HKLM\SOFTWARE\Citrix\HdxMediastream

レジストリキー:

Name: VideoLoadManagementErrDuration

Type: DWORD

範囲: 1 - DWORD制限まで (デフォルト = 5)

単位: 秒

Windows Media クライアント側コンテンツフェッチ

この設定はHTML5とWindows Mediaの両方に適用されます。この設定により、ユーザーデバイスは、XenAppまたはXenDesktop®ホストサーバーを介するのではなく、インターネットまたはイントラネット上のソースプロバイダーからマルチメディアファイルを直接ストリーミングできるようになります。

デフォルトでは、この設定は許可されています。この設定を許可すると、ネットワーク使用量とサーバーのスケーラビリティが向上します。この改善は、メディアに関する処理をホストサーバーからユーザーデバイスに移動することで実現されます。また、Microsoft DirectShowやMedia Foundationのような高度なマルチメディアフレームワークがユーザーデバイスにインストールされているという要件もなくなります。ユーザーデバイスには、URLからファイルを再生する機能のみが必要です。

この設定をポリシーに追加する際は、Windows Mediaリダイレクト設定が存在し、許可に設定されていることを確認してください。Windows Mediaリダイレクトが無効になっている場合、ソースプロバイダーからユーザーデバイスへのマルチメディアファイルの直接ストリーミングも無効になります。

ウィンドウズ メディア リダイレクト

この設定はHTML5とWindows Mediaの両方に適用され、サーバーがストリーミングオーディオとビデオをユーザーに配信する方法を制御および最適化します。

デフォルトでは、この設定は許可されています。HTML5の場合、ポリシーHTML5ビデオリダイレクト禁止されていると、この設定は有効になりません。

この設定が有効になっている場合、サーバーからレンダリングされるオーディオとビデオの品質は、ユーザーデバイスでローカルに再生されるオーディオとビデオに匹敵するレベルに向上します。サーバーはマルチメディアを元の圧縮形式でクライアントにストリーミングし、ユーザーデバイスがメディアを解凍してレンダリングできるようにします。

Windows Mediaリダイレクトは、Microsoft DirectShow、DirectX Media Objects (DMO)、およびMedia Foundationの標準に準拠するコーデックでエンコードされたマルチメディアファイルを最適化します。特定のマルチメディアファイルを再生するには、そのマルチメディアファイルのエンコード形式と互換性のあるコーデックがユーザーデバイスに存在する必要があります。

デフォルトでは、Citrix Workspaceアプリでオーディオは無効になっています。ユーザーがICA®セッションでマルチメディアアプリケーションを実行できるようにするには、オーディオをオンにするか、Citrix Workspaceアプリのインターフェイスでオーディオをオンにする権限をユーザーに付与します。

Windows Mediaリダイレクトを使用してメディアを再生したときの表示が、基本的なICA圧縮と通常のオーディオを使用してレンダリングした場合よりも悪く見える場合にのみ、「禁止」を選択してください。この状況はまれですが、低帯域幅の条件下、たとえばキーフレームの頻度が低いメディアの場合に発生する可能性があります。

Windows Mediaリダイレクトバッファサイズ

この設定はレガシーであり、HTML5には適用されません。

この設定は、マルチメディアアクセラレーションのバッファサイズを1秒から10秒の間で指定します。

デフォルトでは、バッファサイズは5秒です。

Windows Mediaリダイレクトバッファサイズの使用

この設定はレガシーであり、HTML5には適用されません。

この設定は、「Windows Mediaリダイレクトバッファサイズ」設定で指定されたバッファサイズの使用を有効または無効にします。

デフォルトでは、指定されたバッファサイズは使用されません。

この設定が無効になっているか、「Windows Mediaリダイレクトバッファサイズ」設定が構成されていない場合、サーバーはデフォルトのバッファサイズ値(5秒)を使用します。