参考

多媒体策略设置

多媒体部分包含用于管理用户会话中流式 HTML5 和 Windows 音频及视频的策略设置。

警告

不正确地编辑注册表可能会导致严重问题,可能需要您重新安装操作系统。Citrix® 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。编辑注册表之前,请务必备份注册表。

多媒体策略

默认情况下,在 Delivery Controller™ 上设置的所有多媒体策略都存储在以下注册表中:

计算机策略:

HKEY_本地计算机\软件\策略\Citrix\多媒体策略

用户策略:

HKEY_本地计算机\软件\策略\Citrix{用户会话 ID}\用户\多媒体策略

要查找当前用户会话 ID,请在 Windows 命令行上发出 qwinsta 命令。

HTML5 视频重定向

控制并优化 Citrix Virtual Apps and Desktops™ 服务器向用户交付 HTML5 多媒体网络内容的方式。

默认情况下,此设置为禁用。

HTML5 重定向图形图像

在此版本中,此功能仅适用于受控网页。它要求在提供 HTML5 多媒体内容的网页(例如,内部培训网站上的视频)中添加 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. 将此行插入您的网页(如果您的网页有其他脚本,请在这些脚本之前包含 HdxVideo.js): <script src="HdxVideo.js" type="text/javascript"\></script>

注意: 如果 HdxVideo.js 与您的网页不在同一位置,请使用 src 属性指定其完整路径。

如果未将 JavaScript 添加到受控网页且用户播放 HTML5 视频,则 Citrix Virtual Apps and Desktops 默认使用服务器端渲染。

要使 HTML5 视频重定向正常工作,请允许 Windows Media Redirection。此策略对于 服务器获取客户端渲染 是强制性的,并且对于 客户端获取 也是必需的。客户端获取 反过来也要求允许 Windows Media client-side content fetching

微软 Edge 不支持此功能。

HdxVideo.js 会将其自身的控件替换浏览器 HTML5 播放器控件。要检查 HTML5 视频重定向策略是否在某个网站上生效,请将播放器控件与 HTML5 视频重定向策略被禁止的场景进行比较:

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

HTML5 重定向音频图像

(策略被禁止或未配置时为本机网页控件)

HTML5 重定向视频图像

系统支持以下视频控件:

  • 播放
  • 暂停
  • 查找
  • 重复
  • 音频
  • 全屏幕

您可以查看 HTML5 视频重定向测试页面

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

您可以使用 HTML5 视频重定向来:

  • 重定向来自 HTTPS 网站的视频
  • 或者
  • 浏览器内容重定向以重定向整个网站

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

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

HdxVideo.js 使用安全 WebSocket 与在 VDA 上运行的 WebSocketService.exe 进行通信。此进程作为本地系统帐户运行,并执行 SSL 终止和用户会话映射。

WebSocketService.exe is listening on 127.0.0.1 port 9001.

限制视频质量

此设置仅适用于 Windows Media,不适用于 HTML5。它要求您启用 通过 WAN 优化 Windows Media 多媒体重定向

此设置指定 HDX™ 连接允许的最大视频质量级别。配置后,最大视频质量将限制为指定值,从而确保在环境中保持多媒体服务质量 (QoS)。

默认情况下,此设置未配置。

要限制允许的最大视频质量级别,请选择以下选项之一:

  • 1080逐行扫描/8.5兆比特每秒
  • 720逐行扫描/4.0兆比特每秒
  • 480p/720千比特每秒
  • 380p/400千比特每秒
  • 240p/200kbps

在同一服务器上同时播放多个视频会消耗大量资源,并可能影响服务器的可伸缩性。

微软 Teams 重定向

此设置基于 HDX 技术启用 Microsoft Teams 的优化。

如果此策略已启用,并且您正在使用受支持的 Citrix Workspace™ 应用程序版本,则此注册表项在 VDA 上设置为 1。Microsoft Teams 应用程序会读取该项以在 VDI 模式下加载。 请注意,无需手动设置注册表项。

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

Name: MSTeamsRedirSupport

值: DWORD (1 - 启用, 0 - 禁用)

注意:

假设您使用的是版本 1906.2 或更高版本的 VDA,以及没有在 Web Studio 中提供此策略的旧版本 Controller。旧版本 Controller 的一个示例是版本 7.15。在这种情况下,VDA 上默认启用 HDX 优化。如果 Workspace 应用程序版本为 1907 或更高版本,Microsoft Teams 将以优化模式启动。有关混合使用 7.15 LTSR 控制器和 CR VDA 的注意事项,请参阅知识中心文章 CTX205549

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

默认情况下,Microsoft Teams 重定向处于启用状态。

多媒体会议功能

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

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

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

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

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

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

用于通过 WAN 优化 Windows Media 多媒体重定向

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

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

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

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

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

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

此设置仅适用于 Windows Media,并支持在虚拟投递代理 (VDA) 上的图形处理单元 (GPU) 中进行实时多媒体转码。这提高了服务器可扩展性。仅当 VDA 具有受支持的 GPU 用于硬件加速时,GPU 转码才可用。否则,转码将回退到 CPU。

注意:图形处理器转码仅支持 NVIDIA 图形处理器。

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

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

  • Windows 媒体重定向
  • 用于通过 WAN 优化 Windows Media 多媒体重定向设置

Windows 媒体回退阻止

此设置适用于浏览器内容重定向、HTML5 和 Windows Media。为了支持 HTML5,请将 HTML5 视频重定向策略设置为允许

管理员可以使用 Windows Media 回退阻止策略设置来指定向用户交付流式内容的尝试方法。

默认情况下,此设置未配置。当设置配置为“未配置”时,其行为与播放所有内容相同。

要配置此设置,请选择以下选项之一:

  • 播放所有内容。尝试客户端内容获取,然后进行 Windows Media 重定向。如果不成功,则在服务器上播放内容。
  • 仅在客户端播放所有内容。尝试客户端获取,然后进行 Windows Media 重定向。如果不成功,则不播放内容。
  • 仅在客户端播放客户端可访问的内容。仅尝试客户端获取。如果不成功,则不播放内容。

当内容无法播放时,播放器窗口中会显示以下错误消息(默认持续时间为 5 秒):

"Company has blocked video because of lack of resources"

Windows 媒体回退阻止图像

此错误消息的持续时间可以通过 VDA 上的以下注册表项进行自定义。如果注册表项不存在,则持续时间默认为 5 秒。

注册表路径会根据 VDA 的架构而有所不同:

\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream

\HKLM\SOFTWARE\Citrix\HdxMediastream

注册表项:

Name: VideoLoadManagementErrDuration

数据类型: DWORD

范围: 1 - 直到 DWORD 限制 (默认值 = 5)

单位: 秒

Windows 媒体客户端内容获取

此设置适用于 HTML5 和 Windows Media。此设置允许用户设备直接从 Internet 或 Intranet 上的源提供程序流式传输多媒体文件,而不是通过 XenApp 或 XenDesktop® 主机服务器。

默认情况下,此设置为 允许。允许此设置可改善网络使用情况和服务器可伸缩性。此改进是通过将媒体上的任何处理从主机服务器转移到用户设备来实现的。它还消除了在用户设备上安装高级多媒体框架(例如 Microsoft DirectShow 或 Media Foundation)的要求。用户设备只需要能够从 URL 播放文件

将此设置添加到策略时,请确保 Windows Media 重定向 设置存在并设置为 允许。如果 Windows Media 重定向 被禁用,则直接从源提供程序向用户设备流式传输多媒体文件也将被禁用。

Windows 媒体重定向

此设置适用于 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 重定向缓冲区大小 设置未配置,则服务器将使用默认缓冲区大小值(五秒)。