统一通信 SDK 优化

Last published : Nov 13, 2026
Related information
多媒体

简介

Citrix Virtual Apps and Desktops 允许您将应用程序交付给各种终端设备上的用户。其中许多应用程序包含实时通信 (RTC) 功能，例如音频和视频会议。但是，在虚拟化环境中交付这些应用程序时可能会出现挑战。传统的交付方法会将媒体流（音频/视频）从客户端设备路由到数据中心内的 VDI 服务器，然后再将其发送回终端。这种“回传”会给服务器带来不必要的流量和处理开销，尤其是在带宽密集型音频和视频通话中。
Citrix 统一通信 SDK (UCSDK) 是一种技术，允许技术供应商优化这些 RTC 应用程序以在 Citrix 环境中使用。当应用程序经过优化后，它可以提供与在本地桌面上运行的应用程序相同甚至更好的用户体验。在当今世界，无缝的实时通信对于提高生产力和协作至关重要。在虚拟环境中使用应用程序时，音频和视频通话、屏幕共享和其他通信功能必须像在本地桌面上一样流畅运行。优化的应用程序可提供这种体验。
本产品文档详细介绍了 Citrix 客户学习和部署 UCSDK 优化应用程序所需的一切。

工作原理

Citrix 为 VDI 中的实时通信应用程序提供了一种优化的交付方法。此方法利用统一通信 SDK (UCSDK) 将虚拟化应用程序分为两部分：
  • 用户界面 (UI)： 用户界面保留在虚拟主机中，在虚拟桌面或应用程序窗口中无缝显示。
  • 媒体引擎： 媒体处理任务（音频和视频的编码/解码）被卸载到用户的本地设备。这最大限度地减少了服务器负载并优化了网络使用。
通常，Citrix 会向实时通信领域的技术供应商提供 UCSDK，并与他们合作将 UCSDK 集成到这些应用程序中。一旦集成，任何使用 UCSDK 优化应用程序的 Citrix 客户都将获得增强的体验。在构建自定义内部应用程序的情况下，Citrix 客户也可以使用 Citrix UCSDK。然而，在大多数情况下，客户不需要使用和开发 UCSDK – 他们只需要配置 Citrix 环境和应用程序即可获得优化的体验。
注意：
Citrix WebRTC SDK（或）HDX™ 优化应用程序的引用表示与 Citrix UCSDK 集成，并且可以互换使用。

主要优势

当您使用通过 Citrix UCSDK 优化的应用程序时，您可以期待：
  • 通过将处理器密集型媒体编码/解码从 Citrix Virtual Delivery Agent (VDA) 卸载到客户端终端，增强媒体处理性能，从而提高最终用户的整体响应能力。
  • 降低 Citrix VDA 上的 CPU 和带宽使用率，使 IT 部门能够支持每个主机更多的并发用户，并使企业能够经济高效地扩展 Citrix 虚拟桌面部署。
  • 降低企业的总拥有成本，因为优化的终端延长了旧版虚拟桌面的使用寿命并减少了主机基础设施需求，从而随着时间的推移降低了资本支出和运营成本。
  • 支持 Windows、Mac、Linux、ChromeOS 和 HTML5 终端平台。

用例

UCSDK 专为优化遵循 WebRTC 标准的实时通信应用程序而构建。以下是可以使用/已经使用 UCSDK 的关键场景和基于 WebRTC 的应用程序类型。
  • 联络中心即服务 (CCaaS) / 云联络中心平台： 主要管理跨多个渠道的客户交互，优化座席工作流程。
    • 示例：亚马逊连接、Twilio、Avaya 体验平台、Talkdesk、内容大师
  • 统一通信即服务 (UCaaS) / 云业务通信： 集成语音、视频、团队消息和状态，实现全面的业务通信。
    • 示例：Ring Central、8x8、Intermedia、阿尔卡特-朗讯彩虹
  • 通信平台即服务 (CPaaS)： 提供 API，用于将实时通信功能直接嵌入到自定义应用程序中。
    • 示例：Twilio、Ribbon Communications 等公司
  • 企业视频会议和协作： 专为高质量视频会议、电话会议和高级协作功能而设计的平台。
    • 示例：Pexip
  • 金融交易通信： 专为满足金融市场独特、高性能和合规的通信需求而设计。
    • 示例：IPC Unigy
  • 虚拟学习和培训平台： 专为交互式、高质量的虚拟课堂和培训体验而设计。
    • 示例：Vitero
Citrix UCSDK 的底层 WebRTC 基础意味着其优化功能可以扩展到任何基于 WebRTC 的通信应用程序。这为优化利用 WebRTC 进行实时交互的各种应用程序打开了大门，即使它们目前尚未列为通过 UCSDK 优化的应用程序。我们鼓励客户就他们希望优化的任何用例或应用程序联系 Citrix。

UCSDK 架构

UCSDK 架构(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/ucsdk-architecture.png)
  • 供应商应用程序：这可以是任何集成了 UCSDK 的第三方实时通信应用程序，可以是桌面版或基于浏览器的版本。
  • UCSDK JS：UCSDK JS 提供 API，供供应商应用程序用于将音频/视频卸载到端点。
  • HdxRtcEngine：这是 Citrix Workspace 应用程序中嵌入的 WebRTC 媒体引擎，用于处理和管理卸载的音频/视频通话。
SDK 加载并使用后，如果重定向成功，HdxRtcEngine.exe 进程将在客户端端点上启动。一旦 HdxRtcEngine.exe 在客户端端点上启动，任何信令和负载数据都会从 Citrix VDA 流向客户端端点，到达云端，再返回到客户端端点，然后转发到 VDA。例如，一个完整的往返流程可能是：
Vendor App -> CitrxWebrtc.js SDK -> Citrix VDA components -> Citrix Client Endpoint components -> Cloud -> Citrix Client Endpoint components -> Citrix VDA components -> CitrxWebrtc.js SDK -> Vendor App

系统要求

系统要求指出了与最新版 UCSDK - 5.0.0 配合使用的 Citrix 组件的各种版本。有关旧版 SDK 的兼容性详细信息和特定功能要求，请参阅下面的 版本和功能矩阵 表。
注意：
客户若要使用添加到 UCSDK 的任何功能，请确保供应商应用程序已集成相应的 UCSDK 版本并启用了该功能，并在您的环境中使用相应的 VDA 和 CWA 版本。

完全兼容的版本

完全兼容的版本表示，通过将这些版本的 Citrix 组件与最新版 UCSDK 结合使用，客户可以利用所有可用功能。对于当前最新版 UCSDK – 5.0.0，完全兼容的 Citrix 组件版本如下：
  • Citrix 虚拟应用和桌面™： 2607 LTSR
  • Citrix Workspace 应用程序 Windows： 2607 LTSR
  • Citrix Workspace 应用程序 Mac： 待发布
  • Citrix Workspace 应用程序 Linux： 2607 LTSR
  • Citrix Workspace 应用程序 ChromeOS/HTML5： 待发布
注意：
UCSDK 优化支持所有端点平台：Windows、Mac、Linux、ChromeOS 和 HTML5。如果上述列表显示某个特定端点平台“待发布”，则表示尚未发布与最新 UCSDK 功能完全兼容的版本。因此，即使使用较新的 UCSDK，客户仍然可以使用旧版本的 Citrix Workspace 应用程序来继续使用现有功能。

配置

UCSDK 功能取决于三个因素：供应商集成的 UCSDK 版本和供应商启用的功能、Citrix Virtual Apps and Desktops 以及正在使用的 Citrix Workspace 应用程序版本。
在 Citrix 端，请确保配置以下内容，以便允许优化应用程序：
  1. 确保 Microsoft Teams 重定向策略已开启。有关详细信息，请参阅 多媒体策略设置。请注意，此策略默认处于开启状态。
  2. 默认情况下，不支持使用 CitrixWebrtc.js SDK 的第三方 Electron 或基于浏览器的应用程序。CtxHdxWebSocketService (WebSocketService.exe) 不允许来自不在允许列表中的应用程序的连接。必须将所需的应用程序二进制可执行文件名称添加到白名单注册表项。
注意：
从 CVAD 2607 LTSR 开始，使用 Citrix 统一通信 SDK (UCSDK) 的应用程序的优化不再依赖于 Microsoft Teams 重定向策略。管理员现在可以禁用 Microsoft Teams 优化，而不会影响其他集成 UCSDK 的应用程序。要使用此分离，供应商应用程序必须与 CVAD 2607 LTSR 一起使用 Bootstrap 方法（首次在 UCSDK 4.0 中引入）。有关更多详细信息，请参阅 统一通信 SDK 文档。

在 VDA 上

  • 创建密钥路径：HKLM\Software\WOW6432Node\Citrix\WebSocketService
  • 密钥名称：ProcessWhitelist
  • 类型: MULTISZ
  • 密钥值：Mytestapp.exe
如果有多个应用程序，请在新行中键入每个应用程序。请勿从文本文件复制粘贴或插入逗号。确保提供的名称与应用程序的可执行文件名称匹配。此注册表值不区分大小写。
如果应用程序是通过浏览器而不是成熟的桌面应用程序访问的，则需要在注册表值中允许，例如 chrome.exe。
成功配置上述注册表后，重新启动 VDA 或重新启动 CtxHdxWebSocketService 以完成白名单设置。

在客户端上

无需配置。只需安装 Citrix Workspace 应用程序。
每个供应商可能都有一个非常具体的应用程序名称。因此，请参阅(/zh-cn/citrix-virtual-apps-desktops/2607-ltsr/policies/reference/ica-policy-settings/multimedia-policy-settings.html#microsoft-teams-redirection)部分中链接的供应商文档，以确定WebSocketService中必须允许哪个应用程序名称。

功能参考

在屏幕截图中捕获重定向内容

当经过UCSDK优化的应用程序涉及视频或共享屏幕叠加时，该内容会在端点上呈现，因此标准的会话内屏幕截图工具会将其捕获为空白区域。使用Citrix Snipping Tool将此内容包含在您的屏幕截图中。Citrix建议从Citrix Virtual Desktop Assistant启动它，以便于查找。有关更多信息，请参阅(/zh-cn/citrix-virtual-apps-desktops/2607-ltsr/manage-deployment/assistant-app.html#tools-page)。

通过智能同步缩短呼叫连接时间

Smart Sync 功能在 UCSDK 5.0.0 中引入，通过简化 VDA 和客户端端点之间的通信来缩短呼叫连接时间。此增强功能全面加快了呼叫设置速度，为高延迟网络环境提供了最显著的性能改进。
Citrix 建议客户联系其应用程序供应商，升级到 UCSDK 5.0.0 以利用此功能。
注意：
此功能仅依赖于 UCSDK 5.0.0 和 Citrix Workspace 应用程序。有关确切的客户端版本，请参阅版本和功能矩阵。没有 VDA 版本依赖性，因此仍可使用较旧的支持的 VDA。

解耦 UCSDK 和 HDX Microsoft Teams 优化

此功能将统一通信 SDK (UCSDK) 的优化逻辑与 Microsoft Teams 优化策略分离。以前，“Microsoft Teams 重定向”策略充当主开关；为 Teams 禁用它会无意中强制所有其他基于 UCSDK 的应用程序回退到服务器端渲染。
通过此增强功能，无论 Teams 策略状态如何，WebRTC 重定向所需的虚拟通道都可用于第三方应用程序。
  • 优势
    • 精细控制： 管理员可以有选择地管理 Microsoft Teams 优化策略，而不会影响 Amazon Connect、Five9、RingCentral 或其他 UCSDK 集成应用程序等关键业务应用程序的优化。
    • 操作稳定性： 通过防止 UCSDK 优化应用程序中意外的性能下降来确保业务连续性。管理员可以禁用 HDX Teams 优化以进行故障排除或合规性原因，而不会破坏其主要业务工具的高清音频/视频体验。
  • 要求
    • VDA 要求： Citrix Virtual Apps/Desktops 2607 LTSR 或更高版本
    • 应用程序兼容性： 第三方应用程序必须使用 UCSDK 引导初始化方法
注意：
  • 此功能不影响 Microsoft Teams SlimCore 优化。SlimCore 优化使用 Microsoft 专有虚拟通道独立运行，不依赖于 Citrix CTXMTOP 虚拟通道。
  • 要利用此功能，第三方应用程序必须使用 UCSDK 4.0 或更高版本构建。客户应向应用程序供应商（例如 Amazon Connect、Five9、RingCentral）核实其特定版本是否使用引导初始化。

Microsoft Teams 优化的显式服务依赖项

从 Citrix Virtual Apps / Desktops 2607 LTSR 开始，Citrix HDX Teams Redirection Service（由 HDX 优化 Microsoft Teams 和 UCSDK 优化应用程序使用）现在明确声明依赖于 Citrix HDX HTML5 Video Redirection Service (WebSocketService)。
此更新可确保在 Teams 服务启动时自动验证并启动 HTML5 服务，从而防止在服务严格管理的环境中 Microsoft Teams 和 UCSDK 集成应用程序的优化失败。
HDX 优化 1

优化叠加剪裁以增强性能和用户体验

从 CVAD 2511 开始，用于处理 HDX Microsoft Teams 优化和 UCSDK 优化等功能中重定向视频叠加的机制已重新设计，以改善用户体验和服务器性能。

主要优势

  • 改进的视觉准确性： 此增强功能解决了应用程序元素（例如弹出菜单或通知）错误地出现在视频内容后面的视觉故障。新逻辑确保所有组件都以正确的顺序呈现，从而提供更无缝和可预测的体验。
  • 增强的性能： 此优化显著降低了虚拟投递代理上的 CPU 利用率。通过用更高效的基于图形的方法取代旧的、资源密集型轮询方法，此更改提高了服务器可伸缩性并允许更高的用户密度。
注意：
此功能取决于未来版本的 Microsoft Teams（或其他 UCSDK 合作伙伴应用程序），并且需要 Citrix Workspace App for Windows 2511。

版本和功能矩阵

由于版本更新频繁，请参阅 Citrix Virtual Apps and Desktops 和 Citrix Workspace app 产品生命周期页面，以确保特定版本受支持。对于许多旧功能，表中提及的版本是撰写本文档时最后受支持的当前版本 (CR)。
功能 UCSDK 版本 VDA CWA Windows 客户端 CWA Mac CWA Linux 版 CWA ChromeOS/HTML5
音频/视频 (点对点和会议) 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
屏幕共享 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
DTMF 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
代理服务器支持 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
应用程序共享 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 N/A
动态 e911 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
多窗口 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
SDP 统一计划支持 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
流分辨率 / 同播 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
远程音频（带循环） 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2405
基于浏览器的 UCSDK（引导支持） 4.0.2 2407 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
Web HID API 4.0.2 2203 LTSR 最新 CU / 2311 CR 2409.10 2411 2411 2505
网络音频API 4.0.2 2203 LTSR 最新 CU / 2311 CR 2405 2405 2405 N/A
重新启动 ICE 4.1.0 2203 LTSR 最新 CU / 2311 CR 2503.2 2503 2503 2502.10
屏幕录制 (预览)¹ 4.1.0 2503 2503.2 N/A N/A N/A
智能同步 5.0.0 2203 LTSR 最新 CU / 2311 CR 2607 LTSR N/A 2604 N/A
注意：
我们为屏幕录制引入了一项新策略，因此您需要 2503 版本的 delivery controller™，它随附于 CVAD 2503。

当前供应商支持

许多第三方供应商已将统一通信 SDK 集成到其产品中。以下是当前供应商及其支持文档的列表：
供应商 文档
斯普林克勒 适用于语音呼叫的 Citrix 媒体卸载 - Sprinklr
微软 Dynamics 365 Dynamics 365 联络中心文档
亚马逊 Connect 为 Citrix 云桌面优化 Amazon Connect 音频
铃盛 在 Citrix VDI 环境中使用 RingCentral
福耐特 Citrix 环境中的 Five9 WebRTC
特威利奥 Citrix VDI 上的特威利奥 Flex
亚美亚 适用于 Citrix 的 Avaya Experience Platform 公有云 VDI 解决方案
8x8 Citrix VDI 与 8x8 Work 桌面版和 Web 版的集成
康腾古鲁 康腾古鲁 Citrix 集成
瑞本通信 瑞本通信 Citrix WebRTC SDK
英特媒体 在 Citrix Virtual Apps and Desktops 上安装英特媒体 Unite
阿尔卡特朗讯彩虹 针对 Rainbow 桌面应用程序的 Citrix 优化
拓客 Talkdesk 座席工作区 VDI 连接
IPC IPC Unigy 软客户端 Citrix VDI
维特罗 适用于 Citrix VDI 的 Vitero Inspire
佩克西普 在 Citrix Pexip Infinity Docs 中部署 Connect 桌面应用程序
Zoom Web 应用程序 为 Zoom Web 应用程序配置 WebRTC 重定向

故障排除

有关故障排除信息，请参阅 针对使用 Citrix 统一通信 SDK 优化的应用程序的故障排除指南。

已知问题和限制

本节将记录当前已识别的已知问题和限制。