多媒体策略设置
多媒体部分包含用于管理用户会话中流式 HTML5 和 Windows 音频和视频的策略设置。
HTML5 视频重定向
控制并优化 XenApp and XenDesktop® 服务器向用户交付 HTML5 多媒体 Web 内容的方式。
默认情况下,此设置为禁用。


在此版本中,此功能仅适用于受控网页。它要求在提供 HTML5 多媒体内容的网页中添加 JavaScript,例如内部培训站点上的视频。
要配置 HTML5 视频重定向,请执行以下操作:
- Copy the file, HdxVideo.js, from %Program Files%/Citrix/ICA Service/HTML5 Video Redirection on the VDA install to the location of your internal web page.
- 将此行插入到您的网页中(如果您的网页有其他脚本,请在这些脚本之前包含 HdxVideo.js):
<script src="HdxVideo.js" type="text/javascript"></script>
注意:如果 HdxVideo.js 与您的网页不在同一位置,请使用 src 属性指定其完整路径。
如果未将 JavaScript 添加到受控网页中,并且用户播放 HTML5 视频,则 XenApp® and XenDesktop 默认使用服务器端呈现。
要使 HTML5 视频重定向正常工作,请允许 Windows Media 重定向。此策略对于 Server Fetch Client Render 是强制性的,并且对于 Client Side Fetching 也是必需的(后者反过来也要求 Windows Media 客户端内容获取 处于“允许”状态)。
此功能在 Microsoft Edge 中不受支持。
HdxVideo.js 会将其自己的控件替换浏览器 HTML5 播放器控件。要检查 HTML5 视频重定向策略是否在某个网站上生效,请将播放器控件与 HTML5 视频重定向 策略被禁止的情况进行比较:
(策略允许时为 Citrix® 自定义控件)

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

以下视频控件功能受到支持:
- 播放
- 暂停
- 查找
- 重复
- 音频
- 全屏模式
您可以在 https://www.citrix.com/virtualization/hdx/html5-redirect.html 查看 HTML5 视频重定向测试页面。
TLS 和 HTML5 视频重定向
您可以使用 HTML5 视频重定向来重定向 HTTPS 网站。注入到这些网站中的 JavaScript 必须与在 VDA 上运行的 Citrix HDX HTML5 视频重定向服务 (WebSocketService.exe) 建立 TLS 连接。为了实现此重定向并保持网页的 TLS 完整性,Citrix HDX HTML5 视频重定向服务会在 VDA 上的证书存储中生成两个自定义证书。
HdxVideo.js 使用安全 Websockets 与在 VDA 上运行的 WebSocketService.exe 进行通信。此进程在本地系统上运行,并执行 SSL 终止和用户会话映射。
WebSocketService.exe is listening on 127.0.0.1 port 9001.
限制视频质量
此设置仅适用于 Windows Media,不适用于 HTML5。它要求您启用 通过 WAN 进行 Windows Media 多媒体重定向优化。
此设置指定 HDX™ 连接允许的最大视频质量级别。配置后,最大视频质量将限制为指定值,从而确保在环境中保持多媒体服务质量 (QoS)。
默认情况下,此设置未配置。
要限制允许的最大视频质量级别,请选择以下选项之一:
- 1080p/8.5兆比特每秒
- 720p/4.0兆比特每秒
- 480p/720千比特每秒
- 380p/400千比特每秒
- 240p/200千比特每秒
在同一服务器上同时播放多个视频会消耗大量资源,并可能影响服务器的可伸缩性。
多媒体会议设置
此设置允许或阻止视频会议应用程序使用优化的网络摄像头重定向技术。
默认情况下,允许视频会议支持。
将此设置添加到策略时,请确保 Windows Media 重定向设置存在并设置为“允许”(默认值)。
使用多媒体会议时,务必确保以下条件得到满足:
- 用于多媒体会议的摄像头制造商提供的驱动程序已安装在客户端上。
- 在启动视频会议会话之前,将摄像头连接到用户设备。服务器在任何给定时间只使用一个已安装的摄像头。如果用户设备上安装了多个摄像头,服务器会尝试依次使用每个摄像头,直到成功创建视频会议会话。
使用通用 USB 重定向来重定向摄像头时,不需要此策略。在这种情况下,请在 VDA 上安装摄像头驱动程序。
优化 WAN 上的 Windows Media 多媒体重定向
此设置仅适用于 Windows Media,不适用于 HTML5。该设置支持实时多媒体转码,允许通过降级网络将音频和视频媒体流式传输到移动设备,并通过改进 Windows Media 内容在 WAN 上的交付方式来增强用户体验。
默认情况下,Windows Media 内容在 WAN 上的交付已优化。
将此设置添加到策略时,请确保 Windows Media 重定向设置存在并设置为允许。
启用此设置后,实时多媒体转码会根据需要自动部署以实现媒体流式传输,即使在极端网络条件下也能提供无缝的用户体验。
使用 GPU 优化 WAN 上的 Windows Media 多媒体重定向
此设置仅适用于 Windows Media,并支持在虚拟投递代理 (VDA) 上的图形处理单元 (GPU) 中进行实时多媒体转码。这可以提高服务器可伸缩性。仅当 VDA 具有受支持的 GPU 用于硬件加速时,GPU 转码才可用。否则,转码将回退到 CPU。
注意: GPU 转码仅在 NVIDIA GPU 上受支持。
默认情况下,禁止使用 VDA 上的 GPU 优化 Windows Media 内容在 WAN 上的交付。
将此设置添加到策略时,请确保存在 Windows Media 重定向和通过 WAN 优化 Windows Media 多媒体重定向设置,并将其设置为“允许”。
Windows 媒体回退预防
此设置适用于 HTML5 和 Windows Media。要使其与 HTML5 配合使用,请将 HTML 视频重定向 策略设置为 允许。
管理员可以使用 Windows Media 回退预防策略设置来指定尝试向用户交付流式内容的各种方法。
默认情况下,此设置未配置。当此设置设为“未配置”时,其行为与“播放所有内容”相同。
要配置此设置,请选择以下选项之一:
- 播放所有内容。尝试客户端内容获取,然后进行 Windows Media 重定向。如果失败,则在服务器上播放内容。
- 仅在客户端播放所有内容。尝试客户端获取,然后进行 Windows Media 重定向。如果失败,则不播放内容。
- 仅在客户端播放客户端可访问的内容。仅尝试客户端获取。如果失败,则不播放内容。
当内容无法播放时,播放器窗口中会显示错误消息“公司因资源不足而阻止了视频”(默认持续时间为 5 秒)。

此错误消息的持续时间可以通过 VDA 上的以下注册表项进行自定义。如果注册表项不存在,则持续时间默认为 5 秒。
警告
不正确地编辑注册表可能会导致严重问题,可能需要重新安装操作系统。Citrix 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。编辑注册表之前,请务必备份注册表。
注册表路径因 VDA 架构而异:
\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream
或
\HKLM\SOFTWARE\Citrix\HdxMediastream
注册表项:
Name: VideoLoadManagementErrDuration
Type: 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 标准的编解码器编码的多媒体文件。要播放给定的多媒体文件,用户设备上必须存在与该多媒体文件的编码格式兼容的编解码器。
默认情况下,客户端上未配置 启用音频 策略。要允许用户在 ICA® 会话中运行多媒体应用程序,请打开音频或授予用户在其客户端界面中打开音频的权限。
仅当使用 Windows Media 重定向播放媒体的效果比使用基本 ICA 压缩和常规音频渲染的效果差时,才选择 禁止。这种情况很少见,但可能发生在低带宽条件下,例如,关键帧频率非常低的媒体。
Windows Media 重定向缓冲区大小
此设置是旧版设置,不适用于 HTML5。
此设置指定多媒体加速的缓冲区大小,范围为 1 到 10 秒。
默认情况下,缓冲区大小为 5 秒。
Windows Media 重定向缓冲区大小使用
此设置是旧版设置,不适用于 HTML5。
此设置启用或禁用使用 Windows Media 重定向缓冲区大小 设置中指定的缓冲区大小。
默认情况下,不使用指定的缓冲区大小。
如果此设置被禁用,或者未配置 Windows Media 重定向缓冲区大小设置,则服务器将使用默认缓冲区大小值(五秒)。