多媒体策略设置

多媒体部分包含用于管理用户会话中流式 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 虚拟应用和桌面™ 服务器向用户交付 HTML5 多媒体 Web 内容的方式。

默认情况下，此设置为禁用状态。

在此版本中，此功能仅适用于受控网页。它要求在提供 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 重定向。此策略对于服务器提取客户端渲染是强制性的，对于客户端提取是必需的。客户端提取反过来也要求允许 Windows Media 客户端内容提取。

Microsoft Edge 浏览器不支持此功能。

HdxVideo.js 将浏览器 HTML5 播放器控件替换为自己的控件。要检查 HTML5 视频重定向策略是否在特定网站上生效，请将播放器控件与 HTML5 视频重定向策略被禁止的场景进行比较：

（策略允许时为 Citrix 自定义控件）

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

以下是受支持的视频控件：

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

您可以查看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 正在监听 IP 地址 127.0.0.1 上的 9001 端口，用于处理传入的连接请求。

限制视频质量

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

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

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

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

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

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

微软团队重定向

此设置可实现基于 HDX 技术的 Microsoft Teams 优化。

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

HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream

Name: MSTeamsRedirSupport

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

注意：

假设您正在使用版本 1906.2 或更高版本的 VDA 以及较旧版本的 Controller，这些 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 内容在 WAN 上的交付已优化。

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

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

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

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

注意：GPU 转码仅在 NVIDIA GPU 上受支持。

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

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

• Windows 媒体重定向
• 针对 WAN 上 Windows Media 多媒体重定向的优化设置

Windows 媒体回退阻止

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

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

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

要配置此设置，请选择以下选项之一：

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

当内容不播放时，播放器窗口中会显示以下错误消息（默认持续时间为 5 秒）：

“公司因资源不足而阻止了视频”

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

注册表路径因 VDA 的体系结构而异：

\HKLM\SOFTWARE\Wow6432Node\Citrix\HdxMediastream

或

\HKLM\SOFTWARE\Citrix\HdxMediastream

注册表项：

Name: VideoLoadManagementErrDuration

数据类型：DWORD

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

单位: 秒

Windows Media 在客户端进行内容获取

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

虚拟通道插件管理器策略

虚拟通道插件管理器部分包含用于配置此功能的策略设置。

虚拟通道插件管理器旨在为某些指定应用程序在客户端端点上部署插件。插件管理器会检测在 VDA 上运行的特定应用程序，并提示用户在端点上安装插件，以在使用应用程序时获得最佳体验。

• 管理员可以利用此策略，并指定需要在其所有端点上安装该插件的应用程序。
• 应用程序名称应与策略说明中“支持的应用程序”中提及的名称相同。
• 默认情况下，此策略处于禁用状态。
• 当前支持的应用程序
  • “微软团队”
• 在未来，预计将支持更多的应用程序。