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 优化
简介
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) / 云联络中心平台: 主要管理跨多个渠道的客户交互,优化座席工作流。
- 示例:Amazon Connect、Twilio、Avaya Experience Platform、Talkdesk、Content Guru
-
统一通信即服务 (UCaaS) / 云商务通信: 集成语音、视频、团队消息和状态,实现全面的业务通信。
- 示例:Ring Central、8x8、Intermedia、Alcatel-Lucent Rainbow
-
通信平台即服务 (CPaaS): 提供 API,用于将实时通信功能直接嵌入到自定义应用程序中。
- 示例:特威利奥、锐滨通信
-
企业视频会议和协作: 专用于高质量视频会议、会议和高级协作功能的平台。
- 示例:Pexip
-
金融交易通信: 专为满足金融市场独特、高性能和合规的通信需求而设计。
- 示例:IPC Unigy
-
虚拟学习和培训平台: 专为交互式、高质量的虚拟课堂和培训体验而设计。
- 示例:Vitero
Citrix UCSDK 的底层 WebRTC 基础意味着其优化功能可以扩展到任何基于 WebRTC 的通信应用程序。这为优化利用 WebRTC 进行实时交互的各种应用程序打开了大门,即使它们目前未列为通过 UCSDK 优化。我们鼓励客户就他们希望优化的任何用例或应用程序联系 Citrix。
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 - 5.0.0 配合所需的 Citrix 组件的各种版本。有关旧版本 SDK 的兼容性详细信息和特定功能要求,请参阅下面的 版本和功能矩阵 表。
注意:
客户若要使用添加到 UCSDK 的任何功能,请确保供应商应用程序已集成相应的 UCSDK 版本并启用了该功能,并在您的环境中使用相应的 VDA 和 CWA 版本。
完全兼容的版本
完全兼容的版本表示,通过将这些版本的 Citrix 组件与最新版本的 UCSDK 结合使用,客户可以利用所有可用功能。对于当前最新版本的 UCSDK – 5.0.0,完全兼容的 Citrix 组件版本如下:
- 思杰虚拟应用™ 和 桌面: 2603
- Citrix Workspace 应用程序 Windows 版: 2603
- Citrix Workspace App Mac 版:待发布
- Citrix Workspace 应用程序 Linux:2603
- Citrix Workspace 应用程序 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 Unified Communications 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 应用程序。
每个供应商可能都有一个非常特定的应用程序名称。因此,请参阅 当前供应商支持 部分中链接的供应商文档,以确定 WebSocketService 中必须允许哪个应用程序名称。
功能参考
通过智能同步缩短呼叫连接时间
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 2603 或更高版本
-
应用程序兼容性: 第三方应用程序必须使用 UCSDK 引导初始化方法
-
注意:
此功能不影响 Microsoft Teams SlimCore 优化。SlimCore 优化使用 Microsoft 专有虚拟通道独立运行,并且不依赖于 Citrix CTXMTOP 虚拟通道。
要利用此功能,第三方应用程序必须使用 UCSDK 4.0 或更高版本构建。客户应与应用程序供应商(例如 Amazon Connect、Five9、RingCentral)核实其特定版本是否使用引导初始化。
针对 Microsoft Teams 优化的显式服务依赖性
从 Citrix Virtual Apps / Desktops 2603 开始,Citrix HDX Teams 重定向服务(由 HDX 优化型 Microsoft Teams 和 UCSDK 优化型应用程序使用)现在明确声明依赖于 Citrix HDX HTML5 视频重定向服务 (WebSocketService)。
此更新可确保在 Teams 服务启动时自动验证并启动 HTML5 服务,从而防止在服务严格受控的环境中 Microsoft Teams 和 UCSDK 集成应用程序出现优化失败。

优化叠加层剪裁以增强性能和用户体验
从 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 |
| Web 音频 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 | 2603 | N/A | 2604 | N/A |
注意:
我们引入了屏幕录制的新策略,因此您需要 delivery controller™ 的 2503 版本,该版本随附 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 版的集成 |
| 康腾古鲁 | 康腾古鲁 思杰 集成 |
| Ribbon 通信 | 锐滨通信 Citrix WebRTC SDK |
| 英特媒体 | 在 Citrix 虚拟应用和桌面 上安装 英特媒体优耐特 |
| 阿尔卡特-朗讯 Rainbow | Citrix 对 Rainbow 桌面应用程序的优化 |
| 托克台 Talkdesk | Talkdesk 坐席工作区 VDI 连接 |
| IPC | IPC Unigy 软客户端 Citrix VDI |
| 维特罗 | 适用于 Citrix VDI 的 Vitero Inspire |
| 佩克西普 | 在 Citrix Pexip Infinity Docs 中部署 Connect 桌面应用程序 |
| Zoom Web 应用 | 为 Zoom Web App 配置 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.