マルチメディアポリシー設定
「マルチメディア」セクションには、ユーザーセッションにおけるストリーミングHTML5およびWindowsのオーディオとビデオを管理するためのポリシー設定が含まれています。
警告
レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrix®は、レジストリエディターの誤った使用によって生じる問題が解決できることを保証できません。レジストリエディターの使用は自己責任で行ってください。編集する前に必ずレジストリをバックアップしてください。
マルチメディアポリシー
デフォルトでは、Delivery Controller™で設定されたすべてのマルチメディアポリシーは、以下のレジストリに保存されます。
マシンポリシー:
HKEY_LOCAL_MACHINE\Software\Policies\Citrix\MultimediaPolicies
ユーザーポリシー:
HKEY_LOCAL_MACHINE\Software\Policies\Citrix{ユーザーセッションID}\User\MultimediaPolicies
現在のユーザーセッションIDを見つけるには、Windowsコマンドラインでqwinstaコマンドを発行します。
HTML5ビデオリダイレクト
Citrix Virtual Apps and Desktops™サーバーがHTML5マルチメディアWebコンテンツをユーザーに配信する方法を制御し、最適化します。
デフォルトでは、この設定は無効になっています。
HTML5リダイレクト画像(/en-us/citrix-virtual-apps-desktops/2203-ltsr/media/redirection2.png)
HTML5リダイレクトのグラフィックイメージ
このリリースでは、この機能は制御されたWebページでのみ利用可能です。HTML5マルチメディアコンテンツが利用可能なWebページ(例: 社内トレーニングサイトのビデオ)にJavaScriptを追加する必要があります。
HTML5ビデオリダイレクトを構成するには:
-
VDAインストール時の%Program Files%/Citrix/ICA Service/HTML5 Video Redirectionから、ファイルHdxVideo.jsを社内Webページの場所にコピーします。
-
この行を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カスタムコントロール)
(ポリシーが禁止されているか、構成されていない場合のネイティブWebページコントロール)
以下のビデオコントロールがサポートされています。
-
再生
-
一時停止
-
シーク
-
繰り返し
-
オーディオ
-
全画面表示
HTML5ビデオリダイレクトテストページを表示できます。
TLS、HTML5ビデオリダイレクト、およびブラウザーコンテンツリダイレクト
HTML5ビデオリダイレクトは、次の目的で使用できます。
-
HTTPS Webサイトからのビデオのリダイレクト
-
または
-
Webサイト全体をリダイレクトするためのブラウザーコンテンツリダイレクト
これらのWebサイトに挿入されたJavaScriptは、VDAで実行されているCitrix HDX HTML5 Video Redirection Service (WebSocketService.exe) へのTLS接続を確立する必要があります。VDAの証明書ストアにあるCitrix HDX HTML5 Video Redirection Serviceは、次の目的で2つのカスタム証明書を生成します。
-
ビデオのリダイレクトを実現する
-
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
-
380p/400Kbps
-
240p/200Kbps
同じサーバーで複数のビデオを同時に再生すると、大量のリソースが消費され、サーバーのスケーラビリティに影響を与える可能性があります。
Microsoft Teamsのリダイレクト
この設定は、HDXテクノロジーに基づいてMicrosoft Teamsの最適化を有効にします。
Microsoft Teamsの最適化ポリシー(/en-us/citrix-virtual-apps-desktops/2203-ltsr/media/teams-policy.png)
このポリシーが有効で、サポートされているバージョンのCitrix Workspace™アプリを使用している場合、このレジストリキーはVDAで1に設定されます。Microsoft Teamsアプリケーションは、VDIモードでロードするためにこのキーを読み取ります。 レジストリキーを手動で設定する必要はありません。
HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream
名前: MSTeamsRedirSupport
値: DWORD (1 - オン, 0 - オフ)
注:
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 Redirection設定が存在し、Allowedに設定されていることを確認してください。
この設定が有効になっている場合、メディアストリーミングを可能にするために、必要に応じてリアルタイムのマルチメディアトランスコーディングが自動的に展開されます。また、極端なネットワーク条件下でもシームレスなユーザーエクスペリエンスを提供します。
WAN経由でのWindows Mediaマルチメディアリダイレクトの最適化にGPUを使用する
この設定はWindows Mediaにのみ適用され、リアルタイムのマルチメディアトランスコーディングをVirtual Delivery Agent (VDA) のグラフィックス処理ユニット (GPU) で実行できるようにします。これにより、サーバーのスケーラビリティが向上します。GPUトランスコーディングは、VDAがハードウェアアクセラレーションをサポートするGPUを搭載している場合にのみ利用可能です。そうでない場合、トランスコーディングはCPUにフォールバックします。
注: GPUトランスコーディングはNVIDIA GPUでのみサポートされています。
デフォルトでは、WAN経由でのWindows Mediaコンテンツの配信を最適化するためにVDA上のGPUを使用することは禁止されています。
この設定をポリシーに追加する際は、以下の設定が存在し、Allowedに設定されていることを確認してください。
-
Windows Mediaリダイレクト
-
WAN経由でのWindows Mediaマルチメディアリダイレクト設定の最適化
Windows Mediaフォールバック防止
この設定は、ブラウザコンテンツリダイレクト、HTML5、およびWindows Mediaに適用されます。HTML5をサポートするには、HTML5 video redirectionポリシーをAllowedに設定します。
管理者は、Windows Media fallback preventionポリシー設定を使用して、ストリーミングコンテンツをユーザーに配信するために試行される方法を指定できます。
デフォルトでは、この設定は構成されていません。設定が「構成されていません」に設定されている場合、動作はすべてのコンテンツを再生と同じになります。
この設定を構成するには、次のいずれかのオプションを選択します。
-
すべてのコンテンツを再生する。クライアント側でのコンテンツ取得を試行し、次にWindows Mediaリダイレクトを試行します。失敗した場合は、サーバーでコンテンツを再生します。
-
すべてのコンテンツをクライアントでのみ再生する。クライアント側での取得を試行し、次にWindows Mediaリダイレクトを試行します。失敗した場合、コンテンツは再生されません。
-
クライアントでクライアントがアクセス可能なコンテンツのみを再生する。クライアント側での取得のみを試行します。失敗した場合、コンテンツは再生されません。
コンテンツが再生されない場合、プレーヤーウィンドウに次のエラーメッセージが表示されます(デフォルトの表示時間は5秒)。
"Company has blocked video because of lack of resources"
このエラーメッセージの表示時間は、VDA上の次のレジストリキーでカスタマイズできます。レジストリエントリが存在しない場合、表示時間はデフォルトで5秒になります。
レジストリパスは、VDAのアーキテクチャによって異なります。
\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream
または
\HKLM\SOFTWARE\Citrix\HdxMediastream
レジストリキー:
名前: VideoLoadManagementErrDuration
種類: DWORD
範囲: 1 - DWORD制限まで(デフォルト = 5)
単位: 秒
Windows Mediaクライアント側コンテンツ取得
この設定はHTML5とWindows Mediaの両方に適用されます。この設定により、ユーザーデバイスは、XenAppまたはXenDesktop®ホストサーバーを介さずに、インターネットまたはイントラネット上のソースプロバイダーからマルチメディアファイルを直接ストリーミングできるようになります。
デフォルトでは、この設定は許可されています。この設定を許可すると、ネットワーク使用率とサーバーのスケーラビリティが向上します。この改善は、メディアに関するあらゆる処理をホストサーバーからユーザーデバイスに移動することで実現されます。また、Microsoft DirectShowやMedia Foundationなどの高度なマルチメディアフレームワークをユーザーデバイスにインストールする必要がなくなります。ユーザーデバイスには、URLからファイルを再生する機能のみが必要です。
この設定をポリシーに追加するときは、Windows Mediaリダイレクト設定が存在し、許可に設定されていることを確認してください。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 Redirection buffer size 設定で指定されたバッファサイズの使用を有効または無効にします。
デフォルトでは、指定されたバッファサイズは使用されません。
この設定が無効になっている場合、またはWindows Media Redirection buffer size 設定が構成されていない場合、サーバーはデフォルトのバッファサイズ値(5秒)を使用します。