This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
统一通信 SDK 优化
Introduction
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 虚拟桌面部署。
- 降低企业的总拥有成本,因为优化的端点延长了传统虚拟桌面的使用寿命并减少了主机基础设施需求,从而随着时间的推移降低了资本支出和运营成本。
- Support for Windows, Mac, Linux, ChromeOS, and HTML5 endpoint platforms.
使用场景
UCSDK 专为优化遵循 WebRTC 标准的实时通信应用程序而构建。以下是可以使用/已经使用 UCSDK 的关键场景和基于 WebRTC 的应用程序类型。
-
联络中心即服务 (CCaaS) / 云联络中心平台: 主要管理跨多个渠道的客户交互,优化座席工作流程。
- Examples: Amazon Connect, Twilio, Avaya Experience Platform, Talkdesk, Content Guru
-
统一通信即服务 (UCaaS) / 云业务通信: 集成语音、视频、团队消息和状态,实现全面的业务通信。
- Examples: Ring Central, 8x8, Intermedia, Alcatel-Lucent Rainbow
-
通信平台即服务 (CPaaS): 提供 API,用于将实时通信功能直接嵌入到自定义应用程序中。
- 以下是一些在统一通信SDK优化领域中值得关注的示例公司,例如:Twilio、Ribbon Communications
-
企业视频会议和协作: 专用于高质量视频会议、会议和高级协作功能的平台。
- 一个示例是:Pexip
-
金融交易通信: 专为满足金融市场独特、高性能和合规的通信需求而设计。
- Example: IPC Unigy
-
虚拟学习和培训平台: 专为交互式、高质量的虚拟课堂和培训体验而设计。
- Example: Vitero
Citrix UCSDK 的底层 WebRTC 基础意味着其优化功能可以扩展到任何基于 WebRTC 的通信应用程序。这为优化利用 WebRTC 进行实时交互的各种应用程序打开了大门,即使这些应用程序目前尚未列为通过 UCSDK 优化的应用程序。我们鼓励客户就他们希望优化的任何用例或应用程序联系 Citrix。
统一通信SDK 架构

-
供应商应用程序:这可以是任何集成了 UCSDK 的基于桌面或基于浏览器的第三方实时通信应用程序。
-
UCSDK JS:UCSDK JS 提供 API,供供应商应用程序用于将音频/视频卸载到端点。
-
HdxRtcEngine:这是 Citrix Workspace App 中嵌入的 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 组件版本如下:
- 思杰虚拟应用™ 和桌面: 2603
- 思杰 工作区 应用 Windows: 2603
- 思杰 工作区应用 Mac: 待发布
- 思杰 工作区应用 Linux: 2603
- 思杰工作区应用 ChromeOS/HTML5: 待发布
注意:
UCSDK 优化支持所有端点平台:Windows、Mac、Linux、ChromeOS 和 HTML5。如果上述列表显示某个特定端点平台为“待发布”,则表示尚未发布与最新 UCSDK 功能完全兼容的版本。因此,即使使用较新的 UCSDK,客户仍然可以使用旧版本的 Citrix Workspace 应用程序来继续使用现有功能。
配置说明
UCSDK 功能取决于三个因素:供应商集成的 UCSDK 版本和供应商启用的功能、Citrix Virtual Apps and Desktops 以及正在使用的 Citrix Workspace 应用程序版本。
在 Citrix 方面,请确保已配置以下内容,以便允许优化应用程序:
- 确保 Microsoft Teams 重定向策略已开启。有关更多信息,请参阅多媒体策略设置。请注意,此策略默认处于开启状态。
- 默认情况下,不支持使用
CitrixWebrtc.jsSDK 的第三方 Electron 或基于浏览器的应用程序。CtxHdxWebSocketService(WebSocketService.exe) 不允许来自不在允许列表中的应用程序的连接。所需的应用程序二进制可执行文件名称必须添加到白名单注册表项中。
注意:
从 CVAD 2603 开始,使用 Citrix 统一通信 SDK (UCSDK) 的应用程序优化不再依赖于 Microsoft Teams 重定向策略。管理员现在可以禁用 Microsoft Teams 优化,而不会影响其他集成 UCSDK 的应用程序。要使用此分离,供应商应用程序必须结合 CVAD 2603 使用 Bootstrap 方法(首次在 UCSDK 4.0 中引入)。有关更多详细信息,请参阅统一通信 SDK 文档。
在 VDA 上
- 创建密钥路径:
HKLM\Software\WOW6432Node\Citrix\WebSocketService - 密钥名称:
ProcessWhitelist - 类型:
MULTISZ - 密钥值:
Mytestapp.exe
如果您有多个应用程序,请在新行中键入每个应用程序。请勿从文本文件复制粘贴或插入逗号。请确保提供的名称与应用程序的可执行文件名称匹配。此注册表值不区分大小写。
如果应用程序是通过浏览器而不是功能齐全的桌面应用程序访问的,则需要在注册表值中允许,例如 chrome.exe。
成功配置上述注册表后,重新启动 VDA 或重新启动 CtxHdxWebSocketService 以完成白名单设置。
在客户端上
无需配置。只需安装 Citrix Workspace 应用程序。
每个供应商可能都有一个非常具体的应用程序名称。因此,请参阅 Current Vendor Support 部分中链接的供应商文档,以确定 WebSocketService 中必须允许哪些应用程序名称。
功能参考资料
通过 Smart Sync 增强呼叫连接时间
Smart Sync 功能在 UCSDK 5.0.0 中引入,通过简化 VDA 和客户端端点之间的通信来加速呼叫连接时间。此增强功能全面提供更快的呼叫设置,为高延迟网络环境提供最显著的性能改进。
Citrix 建议客户联系其应用程序供应商,升级到 UCSDK 5.0.0 以利用此功能。
注意:
此功能仅依赖于 UCSDK 5.0.0 和 Citrix Workspace 应用程序。有关确切的客户端版本,请参阅版本和功能矩阵。没有 VDA 版本依赖性,因此仍可使用较旧的支持的 VDA。
解耦 UCSDK 和 HDX 微软团队优化
此功能将统一通信 SDK (UCSDK) 的优化逻辑与 Microsoft Teams 优化策略分离。以前,“Microsoft Teams 重定向”策略充当主开关;为 Teams 禁用它会无意中强制所有其他基于 UCSDK 的应用程序回退到服务器端渲染。
借助此增强功能,无论 Teams 策略状态如何,WebRTC 重定向所需的虚拟通道仍可用于第三方应用程序。
-
优势
-
精细控制:管理员可以有选择地管理 Microsoft Teams 优化策略,而不会影响 Amazon Connect、Five9、RingCentral 或其他 UCSDK 集成应用程序等关键业务应用程序的优化。
-
操作稳定性:通过防止 UCSDK 优化应用程序中出现意外的性能下降来确保业务连续性。管理员可以出于故障排除或合规性原因禁用 HDX Teams 优化,而不会破坏其主要业务工具的高清音频/视频体验。
-
-
要求
-
VDA 要求:Citrix 虚拟应用和桌面 2603 或更高版本
-
应用程序兼容性:第三方应用程序必须使用 UCSDK 引导初始化方法
-
注意:
此功能不影响 Microsoft Teams SlimCore 优化。SlimCore 优化使用微软专有虚拟通道独立运行,并且不依赖于 Citrix CTXMTOP 虚拟通道。
要利用此功能,第三方应用程序必须使用 UCSDK 4.0 或更高版本构建。客户应与应用程序供应商(例如 Amazon Connect、Five9、RingCentral)确认其特定版本是否使用引导初始化。
Microsoft Teams 优化的显式服务依赖性
从 Citrix 虚拟应用和桌面 2603 开始,Citrix HDX 团队重定向服务(由 HDX 优化型 微软团队 和 UCSDK 优化型应用程序使用)现在明确声明依赖于 Citrix HDX HTML5 视频重定向服务 (WebSocketService)。
此更新确保当 Teams 服务启动时,HTML5 服务会自动验证并启动,从而防止在服务严格受控的环境中,Microsoft Teams 和 UCSDK 集成应用程序出现优化失败。

优化叠加层剪裁,以提升性能和用户体验
从 CVAD 2511 开始,用于处理 HDX Microsoft Teams 优化和 UCSDK 优化等功能中重定向视频叠加层的机制已重新设计,以改善用户体验和服务器性能。
核心的优势
-
提高视觉准确性: 此增强功能解决了视觉故障,即应用程序元素(例如弹出菜单或通知)会错误地出现在视频内容后面。新的逻辑确保所有组件都以正确的顺序呈现,从而提供更无缝和可预测的体验。
-
增强性能: 此优化显著降低了虚拟投递代理上的 CPU 利用率。通过用更高效的基于图形的方法取代旧的、资源密集型轮询方法,此更改提高了服务器可伸缩性并允许更高的用户密度。
注意:
The functionality depends on a future version of Microsoft Teams (or other UCSDK partner application) and requires Citrix Workspace App for Windows 2511.
版本和功能矩阵
由于版本更新频繁,请参阅 Citrix Virtual Apps and Desktops 和 Citrix Workspace app 产品生命周期页面,以确保支持特定版本。对于许多旧功能,表中提到的版本是撰写本文时支持的最新当前版本 (CR)。
| 功能 | 统一通信 SDK 版本 | VDA | CWA 视窗 | CWA 苹果电脑 | CWA Linux | CWA 克罗米操作系统/HTML5 |
|---|---|---|---|---|---|---|
| 音频/视频(点对点和会议) | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| 屏幕共享 | 3.1.0 | 2203 长期服务版本 最新累积更新 / 2311 当前版本 | 2402 长期服务版本 最新累积更新 / 2311 当前版本 | 2311 | 2311 | 2312 |
| 双音多频 | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| 代理服务器支持 | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| 应用共享 | 3.1.0 | 2203 长期服务版本 最新累积更新 / 2311 当前版本 | 2402 长期服务版本 最新累积更新 / 2311 当前版本 | 2311 | 2311 | N/A |
| 动态 e911 | 3.1.0 | 2203 长期服务版本 最新累积更新 / 2311 当前版本 | 2402 长期服务版本 最新累积更新 / 2311 当前版本 | 2311 | 2311 | 2312 |
| 多窗口 | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| SDP 统一计划支持 | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| 流分辨率 / 同步广播 | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2312 |
| 远程音频(带循环) | 3.1.0 | 2203 LTSR 最新累积更新 / 2311 CR | 2402 LTSR 最新累积更新 / 2311 CR | 2311 | 2311 | 2405 |
| 基于浏览器的 UCSDK(引导支持) | 4.0.2 | 2407 CR | 2402 LTSR 最新累积更新 / 2311 当前版本 | 2311 | 2311 | 2312 |
| 网络 HID 应用程序接口 | 4.0.2 | 2203 LTSR 最新累积更新 / 2311 当前版本 | 2409.10 | 2411 | 2411 | 2505 |
| 网络音频 API | 4.0.2 | 2203 LTSR 最新累积更新 / 2311 当前版本 | 2405 | 2405 | 2405 | N/A |
| 重新启动 ICE | 4.1.0 | 2203 LTSR 最新累积更新 / 2311 当前版本 | 2503.2 | 2503 | 2503 | 2502.10 |
| 屏幕录制 (预览)¹ | 4.1.0 | 2503 | 2503.2 | N/A | N/A | N/A |
| 智能同步 | 5.0.0 | 2203 LTSR 最新累积更新 / 2311 当前版本 | 2603 | N/A | 2604 | N/A |
注意:
我们引入了一项新的屏幕录制策略,因此您需要交付控制器™的 2503 版本,该版本随附 CVAD 2503。
当前供应商支持
多家第三方供应商已将统一通信 SDK 集成到其产品中。以下列出了当前的供应商及其支持文档:
| 供应商 | 说明文档 |
|---|---|
| 斯普林克勒 | 适用于语音呼叫的 Citrix 媒体卸载 - Sprinklr |
| 微软动态 365 | Dynamics 365 联络中心文档 |
| 亚马逊连接 | 优化 Citrix 云桌面上的亚马逊连接音频 |
| 优悦通 | 在 Citrix VDI 环境中使用铃盛 |
| 五九 | 五九 WebRTC 在 思杰 环境中 |
| 特威利奥 | 思杰 虚拟桌面基础架构 上的 特威利奥 灵动 |
| 亚美亚 | 适用于 思杰 的 亚美亚 体验平台 公有云 虚拟桌面基础架构 解决方案 |
| 8x8 | Citrix 虚拟桌面基础架构与 8x8 Work 桌面版和 Web 版的集成(https://support-portal.8x8.com/helpcenter/viewArticle.html?d=b9270b6e-d5ca-4515-98fc-5a0e0d86db8c) |
| 康腾古鲁 | 内容大师 思杰集成 |
| 瑞本通信公司 | 瑞邦通信 思杰 WebRTC 软件开发工具包 |
| 英特媒体 | 在 Citrix 虚拟应用和桌面 上安装 英特媒体统一 |
| 阿尔卡特朗讯 Rainbow | Citrix 对 Rainbow 桌面应用程序的优化 |
| 拓客台 | 拓客台座席工作区 VDI 连接 |
| IPC | IPC Unigy 软客户端 Citrix 虚拟桌面基础架构 |
| 维特罗 | 适用于 Citrix VDI 的 维特罗 因斯派尔 |
| 佩克西普 | 在 Citrix 佩克西普 Infinity 文档中部署 Connect 桌面应用程序 |
| 祖姆网络应用程序 | 配置适用于祖姆网络应用程序的 WebRTC 重定向 |
故障排除
有关故障排除信息,请参阅 针对使用 Citrix 统一通信 SDK 优化的应用程序的故障排除指南。
已知问题和限制
本节将记录当前已知的、并根据识别情况而确定的问题和限制。
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.