产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

统一通信 SDK 优化

November 25, 2025
投稿者: 
C

简介

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 以及通过 UCSDK 进行开发 - 他们只需要配置 Citrix 环境和应用程序即可获得优化的体验。

注意：

Citrix WebRTC SDK（或）HDX™ 优化的应用程序的引用表明与 Citrix UCSDK 集成并且可以互换使用。

新增功能

UCSDK 4.1.0 是技术供应商可以集成的最新正式发布版本。 此外，还有两个受支持的版本 - UCSDK 4.0.2 和 UCSDK 3.1.0。 UCSDK 版本引入了新功能，技术供应商需要确保升级 SDK，以便客户能够获得这些功能。 这样，Citrix 客户只需专注于升级获取新功能所需的 Citrix 组件。

随着 UCSDK 4.1.0 的发布，我们推出了关键的用户体验增强功能和全新功能，这些功能将允许与合作伙伴的产品进行更深入的集成，为我们的客户带来了更多价值。

新增功能

  • UCSDK 端点屏幕录制（技术预览版）： 解决了合规性录制中的一个关键差距，即使应用程序在 VDI 中运行，新的 UCSDK API 现在也可以捕获端点上的内容。 此功能目前处于 Windows 端点预览阶段，允许技术供应商增强其应用程序以支持 Citrix 上的端点屏幕录制。 请注意，此功能专注于增强供应商应用程序，与 Citrix Session Recording 不同。
  • 会话重新连接处理： Bootstrap 的一项重要增强功能显著改进了浏览器应用程序体验，使其更接近基于 Electron 的桌面应用程序体验。 使用 Bootstrap 的基于浏览器的应用程序现在可以动态处理 Citrix 会话断开连接，为最终用户提供无缝用户体验。
  • 支持新方法： 增加了对重新启动 ICE 收集的支持以及对 RTCConfiguration 中的 iceCandidatePoolSize 的支持。
  • 更好的错误处理和合规性改进功能： 改进了 getUserMedia 对 WebRTC 规范的合规性。 改进了用于 CitrixPeerConnection、RtpSender 和 RtpReceiver 的 getStats()，以便在错误情况下返回空报告而非 void。

UCSDK 4.1.0 的完全兼容版本包括：

  • Citrix Virtual Apps and Desktops™ 2503
  • 适用于 Windows 的 Citrix Workspace™ 应用程序 2503
  • 适用于 Mac 的 Citrix Workspace 应用程序 2503
  • 适用于 Linux 的 Citrix Workspace 应用程序 2503
  • 最新的 ChromeOS/HTML5 版本。

注意：

Citrix 客户可以联系技术供应商来升级 SDK（或）添加对特定功能的支持，以防有使用新引入的功能可以实现的用例。

主要优点

使用通过 Citrix UCSDK 优化的应用程序时，您可以期待：

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

示例用法

UCSDK 专门用于优化符合 WebRTC 标准的实时通信应用程序。 下面是关键场景以及可以/已经使用 UCSDK 的基于 WebRTC 的应用程序类型。

  • Contact Center as a Service (CCaaS)/Cloud Contact Center 平台： 主要管理跨多个渠道的客户互动，优化代理工作流程。
    • 示例：Amazon Connect、Twilio、Avaya Experience Platform、Talkdesk、Content Guru
  • Unified Communications as a Service (UCaaS)/云业务通信： 集成语音、视频、团队消息和联机状态，实现全面的业务通信。
    • 例如：Ring Central、8x8、Intermedia、Alcatel-Lucent Rainbow
  • Communications Platform as a Service (CPaaS)： 提供用于将实时通信功能直接嵌入定制应用程序的 API。
    • 例如：Twilio、Ribbon Communications
  • 企业视频会议和协作： 用于高质量视频会议、会议和高级协作功能的专用平台。
    • 例如：Pexip
  • 金融交易通信： 专为满足金融市场独特、高性能和合规的通信需求而设计。
    • 例如：IPC Unigy
  • 虚拟学习和培训平台： 专为互动式、高质量虚拟课堂和培训体验而设计。
    • 例如：Vitero

Citrix UCSDK 的底层 WebRTC 基础意味着其优化功能可以扩展到任何基于 WebRTC 的通信应用程序。 这为优化利用 WebRTC 进行实时交互的各种应用程序打开了大门，即使其当前尚未列为使用 UCSDK 进行优化亦如此。 我们鼓励客户就其希望优化的任何用例或应用程序与 Citrix 联系。

UCSDK 体系结构

UCSDK 体系结构

  • 供应商应用程序：这可以是集成了 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（即 4.1.0）所需的各种版本的 Citrix 组件。 有关较旧版本的 SDK 的兼容性详细信息和特定功能要求，请参阅下面的版本和功能列表 表。

注意：

为了让客户使用添加到 UCSDK 的任何功能，请确保供应商应用程序已集成适当的 UCSDK 版本并启用该功能，并在您的环境中使用适当的 VDA 和 CWA 版本。

完全兼容版本

完全兼容版本表明，通过使用这些版本的 Citrix 组件以及最新版本的 UCSDK，客户可以利用所有可用的功能。 对于当前最新版本的 UCSDK（即 4.1.0），完全兼容的 Citrix 组件版本如下：

  • Citrix Virtual Apps and Desktops： 2503
  • Citrix Workspace 应用程序 Windows 版： 2503
  • Citrix Workspace 应用程序 Mac 版： 2503
  • Citrix Workspace 应用程序 Linux 版： 2503
  • Citrix Workspace App ChromeOS/HTML5 版： 最新版本

配置

UCSDK 功能取决于三个因素：供应商已集成的 UCSDK 版本和供应商已启用的功能、Citrix Virtual Apps and Desktops 以及正在使用的 Citrix Workspace 应用程序版本。

在 Citrix 端，请务必配置以下内容，以便允许对已优化的应用程序进行优化：

  1. 确保 Microsoft Teams 重定向策略已打开。 有关详细信息，请参阅多媒体策略设置。 请注意，此策略默认处于开启状态。
  2. 默认情况下不支持使用 CitrixWebrtc.js SDK 的第三方 Electron 或基于浏览器的应用程序。 CtxHdxWebSocketService (WebSocketService.exe) 将不允许来自不在允许列表中的应用程序的连接。 必须将所需的应用程序二进制可执行文件名称添加到白名单注册表项中。

在 VDA 上

  • 创建一个注册表项路径：HKLM\Software\WOW6432Node\Citrix\WebSocketService
  • 注册表项名称：ProcessWhitelist
  • 类型：MULTISZ
  • 注册表项值：Mytestapp.exe

如果有多个应用程序，请在新行中键入每个应用程序。 请不要从文本文件复制并粘贴或插入逗号。 请确保提供的名称与应用程序的可执行文件名称相匹配。 此注册表值不区分大小写。

如果通过浏览器而非完全合格的桌面应用程序访问应用程序，您需要允许在注册表值中使用 chrome.exe 等名称。

一旦上述注册表配置成功，请重新启动 VDA 或重新启动 CtxHdxWebSocketService 以完成白名单设置。

在客户端

无需配置。 只需安装 Citrix Workspace 应用程序。

每个供应商可能都有一个非常具体的应用程序名称。 因此，请参阅当前供应商支持部分中链接的供应商文档，以确定必需允许在 WebSocketService 中使用的应用程序名称。

版本和功能列表

由于版本更新频繁，请参阅 Citrix Virtual Apps and Desktops 和 Citrix Workspace app 产品生命周期页面，以确保支持特定版本。 对于许多较旧的功能，表中提到的版本是撰写本文档时最后支持的当前版本 (CR)。

功能 UCSDK 版本 VDA CWA Windows CWA Mac CWA Linux CWA ChromeOS/HTML5
音频/视频（p2p 和会议） 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 不适用
Dynamic 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
Web 音频 API 4.0.2 2203 LTSR 最新 CU/2311 CR 2405 2405 2405 不适用
重新启动 ICE 4.1.0 2203 LTSR 最新 CU/2311 CR 2503.2 2503 2503 2502.10
屏幕录制（预览版）¹ 4.1.0 2503 2503.2 不适用 不适用 不适用

注意：

我们引入了新的屏幕录制策略，因此您需要 CVAD 2503 附带的 2503 版本的 Delivery Controller™。

当前供应商支持

一些第三方供应商已将统一通信 SDK 集成到其产品中。 供应商及其支持文档的列表如下所示：

供应商 文档
Amazon Connect 针对 Citrix 云桌面优化 Amazon Connect 音频
Ring Central 在 Citrix VDI 环境中使用 RingCentral
Five9 Citrix 环境中的 Five9 WebRTC
Twilio Citrix VDI 上的 Twilio Flex
Avaya 适用于 Citrix 的 Avaya Experience Platform 公有云 VDI 解决方案
8x8 Citrix VDI 与 8x8 Work for Desktop & Web 集成
Content Guru Content Guru Citrix 集成
Ribbon Communications Ribbon Communications Citrix WebRTC SDK
Intermedia 在 Citrix Virtual Apps and Desktops 上安装 Intermedia Unite
Alcatel-Lucent Rainbow 适用于 Rainbow 桌面应用程序的 Citrix 优化
Talkdesk Talkdesk Agent Workspace VDI Connect
IPC IPC Unigy Soft Client Citrix VDI
Vitero 适用于 Citrix VDI 的 Vitero Inspire
Pexip 在 Citrix Pexip Infinity Docs 中部署 Connect 桌面应用程序

故障排除

有关故障排除信息，请参阅 Troubleshooting Guidance for Apps Optimized with Citrix Unified Communications SDK（通过 Citrix 统一通信 SDK 优化的应用程序故障排除指南）。

已知问题和限制

本部分内容将记录已识别的当前已知问题和限制。

统一通信 SDK 优化
November 25, 2025
投稿者: 
C
November 25, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.