リファレンス

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

マルチメディア」セクションには、ユーザーセッションでのストリーミング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リダイレクト画像

HTML5リダイレクトのグラフィック画像

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

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

  1. VDAがインストールされているシステム上の%Program Files%/Citrix/ICA Service/HTML5 Video Redirectionディレクトリから、HdxVideo.jsというファイルを、お客様の社内Webページが配置されている場所へコピーしてください。
  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を許可します。このポリシーは、サーバーフェッチクライアントレンダーには必須であり、クライアントサイドフェッチングには必要です。クライアントサイドフェッチングは、さらにWindows Media クライアント側コンテンツフェッチングが許可されていることも必要とします。

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

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

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

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

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

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

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

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

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

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

HTML5ビデオリダイレクトを使用して、次のことができます。

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

これらのWebサイトに挿入されたJavaScriptは、VDAで実行されているCitrix HDX HTML5ビデオリダイレクトサービス(WebSocketService.exe)へのTLS接続を確立する必要があります。VDAの証明書ストアにあるCitrix HDX HTML5ビデオリダイレクトサービスは、次の目的で2つのカスタム証明書を生成します。

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

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

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

ビデオ品質の制限

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

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

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

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

  • 1080p/8.5メガビット/秒
  • 720p/4.0メガビット/秒
  • 480p/720kbps
  • 380ピー/400キロビット/秒
  • 240ピー/200キロビット/秒

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

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

この設定により、HDX テクノロジーに基づいた Microsoft Teams の最適化が可能になります。

マイクロソフト Teams の最適化ポリシー(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/media/teams-policy.png)

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

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

Name: 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カメラ用のメーカー提供のドライバーがクライアントにインストールされていること。
  • ウェブカメラをユーザーデバイスに接続してからビデオ会議セッションを開始します。サーバーは、一度に1台のインストール済みウェブカメラのみを使用します。ユーザーデバイスに複数のウェブカメラがインストールされている場合、サーバーは各ウェブカメラを順番に試行します。この試行は、ビデオ会議セッションが正常に作成されるまで続行されます。

ジェネリックUSBリダイレクトを使用してウェブカメラをリダイレクトする場合、このポリシーは必要ありません。その場合は、ウェブカメラドライバーを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でのみサポートされています。

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

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

  • ウィンドウズメディア リダイレクト
  • 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フォールバック防止イメージ

このエラーメッセージの表示時間は、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秒)を使用します。