Citrix Virtual Apps and Desktops

多媒体策略设置

多媒体部分包含用于管理用户会话中的流 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 重定向流程图

在此版本中,此功能仅用于受控 Web 页面。它要求向提供 HTML5 多媒体内容(例如,内部培训站点上的视频)的 Web 页面添加 JavaScript。

配置 HTML5 视频重定向:

  1. 将文件 HdxVideo.js 从 VDA 安装上的 %Program Files%/Citrix/ICA Service/HTML5 Video Redirection 复制到您的内部 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 重定向。此策略对于服务器提取客户端呈现是必需的,对于客户端提取也是必需的。相反,客户端提取还要求将 Windows Media 客户端内容提取设置为“允许”。

Microsoft Edge 不支持此功能。

HdxVideo.js 会将浏览器 HTML5 播放器控件替换为自己的控件。要检查 HTML5 视频重定向策略是否在某个特定 Web 站点上生效,请将播放器控件与禁止 HTML5 视频重定向策略的情况进行比较:

(允许该策略时的 Citrix 自定义控件)

HTML5 重定向音频图片

(禁止或未配置该策略时的原始 Web 页面控件)

HTML5 重定向视频图片

支持以下视频控制功能:

  • 播放
  • 暂停
  • 搜寻
  • 重复
  • 音频
  • 全屏

您可以在 https://www.citrix.com/virtualization/hdx/html5-redirect.html 上查看 HTML5 视频重定向测试页面。

TLS、HTML5 视频重定向和浏览器内容重定向

可以使用 HTML5 视频重定向执行以下操作:

  • 重定向来自 HTTPS Web 站点的视频
  • 浏览器内容重定向以重定向整个 Web 站点

注入到这些 Web 站点的 JavaScript 必须与 VDA 上运行的 Citrix HDX HTML5 视频重定向服务 (WebSocketService.exe) 建立 TLS 连接。VDA 上的证书存储中的 Citrix HDX HTML5 Video Redirection Service 会生成两个自定义证书,用于:

  • 实现视频重定向
  • 维护 Web 页面的 TLS 完整性

HdxVideo.js 使用安全的 WebSocket 与 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 优化。

如果启用了此策略,并且您使用的是 Citrix Workspace 应用程序的受支持版本,则在 VDA 上将此注册表项设置为 1。Microsoft Teams 应用程序读取要在 VDI 模式下加载的密钥。 请注意,不需要手动设置注册表项。

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

名称:MSTeamsRedirSupport

值:DWORD(1 - 开,0 - 关)

注意:

假设您正在将版本 1906.2 或更高版本的 VDA 与较早版本的 Controller 配合使用,这些版本在 Web Studio 中没有可用的策略。较早版本的 Controller 的示例是版本 7.15。在这种情况下,默认情况下会在 VDA 上启用 HDX 优化。如果 Workspace 应用程序版本为 1907 或更高版本,Microsoft Teams 将在优化模式下启动。有关混合 7.15 LTSR Controller 和 CR VDA 时的注意事项的信息,请参阅知识中心文章 CTX205549

在这种情况下,要为特定用户禁用该功能,您可以覆盖注册表设置。通过使用组策略将登录脚本应用到用户的组织单位来覆盖注册表设置。

默认情况下,启用 Microsoft Teams 重定向。

多媒体会议

此设置允许或阻止视频会议应用程序使用优化的网络摄像机重定向技术。

默认情况下,允许视频会议支持。

将此设置添加到某个策略时,请验证 Windows Media 重定向设置存在并设置为允许(默认设置)。

使用多媒体会议时,请验证是否满足以下条件:

  • 在客户端上安装了制造商为用于多媒体会议的网络摄像机提供的驱动程序。
  • 先将网络摄像机连接到用户设备,然后再启动视频会议会话。服务器在任何给定的时间只使用一个已安装的网络摄像机。如果用户设备上安装了多个网络摄像机,服务器会依次尝试使用每个网络摄像机。此尝试会一直持续到成功创建视频会议会话为止。

使用通用 USB 重定向对网络摄像机进行重定向时,不需要此策略。在这种情况下,请在 VDA 上安装网络摄像机驱动程序。

优化通过 WAN 进行的 Windows Media 多媒体重定向

此设置仅适用于 Windows Media,而不适用于 HTML5。该设置启用以下功能:

  • 实时多媒体转码
  • 允许通过降级网络将音频和视频媒体通过流技术传输到移动设备
  • 通过改进通过广域网传输 Windows Media 内容的方式来增强用户体验。

默认情况下,已优化通过 WAN 的 Windows Media 内容交付。

将此设置添加到策略时,请确保 Windows Media 重定向设置存在,且设置为允许

启用此设置后,将根据需要自动部署实时多媒体转码以启用媒体流。此外,即使在极端苛刻的网络条件下也可以提供无缝用户体验。

使用 GPU 优化通过 WAN 进行的 Windows Media 多媒体重定向

此设置仅适用于 Windows Media,并支持在 Virtual Delivery Agent (VDA) 上的图形处理器 (GPU) 中执行实时多媒体转码。这会改善服务器可扩展性。仅在 VDA 具有支持硬件加速的 GPU 时,GPU 转码才可用。否则,转码将回退到 CPU。

注意:只有 NVIDIA GPU 才支持 GPU 转码。

默认情况下,禁止使用 VDA 上的 GPU 通过 WAN 优化 Windows Media 内容交付。

将此设置添加到策略时,请确保存在以下设置并将其设置为“允许”:

  • Windows Media 重定向
  • 优化通过 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

注册表项:

名称:VideoLoadManagementErrDuration

类型:DWORD

范围︰ 1 - 最大 DWORD 限制(默认值 = 5)

单位:秒

Windows Media 客户端内容提取

此设置适用于 HTML5 和 Windows Media。该设置支持用户设备能够通过流技术直接从 Internet 或 Intranet 上的源提供程序推送多媒体文件,而非通过 XenApp 或 XenDesktop 主机服务器推送。

默认情况下,此设置为允许。允许此设置可提高网络使用率和服务器可扩展性。这种改进是通过将媒体上的所有处理从主机服务器移动到用户设备来实现的。此外,还不需要在用户设备上安装 Microsoft DirectShow 或媒体基础等高级多媒体框架。用户设备只需要从 URL 播放文件的能力

将此设置添加到策略时,请确保 Windows Media 重定向设置存在,且设置为允许。如果禁用 Windows Media 重定向,也会禁用通过流技术将多媒体文件直接从源提供程序推送到用户设备。

Windows Media 重定向

此设置适用于 HTML5 和 Windows Media,并可控制和优化服务器向用户交付流音频和视频的方式。

默认情况下,此设置为允许。对于 HTML5,如果策略 HTML5 视频重定向禁止,此设置将无法生效。

启用此设置后,从服务器呈现的音频和视频的质量将提高到可与在用户设备上本地播放的音频和视频质量相媲美的级别。服务器会将多媒体以原始压缩格式通过流技术推送到客户端,并允许用户设备解压缩和呈现该媒体。

Windows Media 重定向可优化使用编解码器编码的多媒体文件,这些编解码器遵循 Microsoft DirectShow、DirectX 媒体对象 (DMO) 和媒体基础标准。要播放给定的多媒体文件,用户设备上必须存在与多媒体文件的编码格式兼容的编解码器。

默认情况下,在 Citrix Workspace 应用程序上音频处于禁用状态。要允许用户在 ICA 会话中运行多媒体应用程序,请打开音频或授予用户在其 Citrix Workspace 应用程序界面上自行打开音频的权限。

仅当使用 Windows Media 重定向播放媒体的效果比使用基本 ICA 压缩和常规音频所呈现的效果差时,才选择已禁止。这种情况很少见,但在带宽较低的情况下可能会发生。例如,当播放关键帧的频率较低低的媒体时。

Windows Media 重定向缓冲区大小

此设置是一个旧设置,不适用于 HTML5。

此设置为多媒体加速指定 1 到 10 秒的缓冲区大小。

默认情况下,缓冲区大小为 5 秒。

Windows Media 重定向缓冲区大小的使用

此设置是一个旧设置,不适用于 HTML5。

该设置启用或禁用使用 Windows Media 重定向缓冲区大小设置中所指定的缓冲区大小。

默认情况下,不使用指定的缓冲区大小。

如果禁用此设置,或如果未配置 Windows Media 重定向缓冲区大小设置,服务器将使用默认缓冲区大小值(5 秒)。