SDK

HDX™ 软件开发工具包

Citrix Workspace 应用程序通过允许您通过您的网站自定义 Citrix 托管应用程序和桌面的交付模型，增强了对 HDX 和 SDK 会话的支持。

此功能对于在您的企业门户中构建丰富的应用程序体验以及为用户提供服务很有用。当您在自己的 Web 服务器上托管适用于 HTML5 的 Citrix Workspace 应用程序，同时从您的网站启动 Citrix 托管的应用程序和桌面时，即可提供这种体验。

有关适用于 HTML5 的 Citrix Workspace 应用程序的 HDX 软件开发工具包文档，请参阅 适用于 HTML5 的 HDX 软件开发工具包。

有关 HDX SDK 示例，请参阅 Citrix 下载 页面。

使用适用于 HTML5 的 HDX SDK 为适用于 HTML5 的 Citrix Workspace 应用程序提供自动更新支持

适用于 HTML5 的 Citrix HDX SDK 增强了 setPath API，以使用 CDN 中适用于 HTML5 的 Citrix Workspace 应用程序的最新版本。此增强功能使适用于 HTML5 的 Citrix Workspace 应用程序能够无缝运行最新版本。对于现有的适用于 HTML5 的 HDX SDK 用户，请更改客户代码中的 citrix.receiver.setPath 以使用 CDN 中的最新版本。对于新用户，setPath API 默认提供此选项。

CDN 作为默认选项提供。如果 CDN 出现任何问题，托管位置将提供回退路径。有关详细信息，请参阅 适用于 HTML5 的 HDX SDK。

适用于 HTML5 的 Citrix HDX 开发工具包 最新版本

请验证您是否使用适用于 HTML5 的 Citrix HDX SDK 的最新版本以启动会话。否则，会话可能无法启动。

有关详细信息，请参阅 适用于 HTML5 的 Citrix Workspace 应用程序 HDX 开发工具包。

虚拟通道 SDK 支持

Citrix 虚拟通道 (VC) SDK 支持使用 ICA 协议编写服务器端应用程序和客户端驱动程序。服务器端虚拟通道应用程序位于 Citrix Virtual Apps and Desktops 服务器上。

VC SDK 支持编写新的虚拟通道，并且适用于 HTML5 的 Citrix Workspace 应用程序最多可支持 20 个自定义虚拟通道。

此功能的已知限制

• 如果虚拟通道的配置不正确，您可能会观察到 30 秒的延迟。
• 创建自定义 VC 时，请使用除“CTX”以外的任何内容作为“streamName”的开头。

有关详细信息，请参阅 适用于 HTML5 的 Citrix Workspace 应用程序的 Citrix 虚拟通道 SDK。

虚拟通道 SDK 的增强功能

从 2305 版本开始，适用于 HTML5 的 Citrix Workspace 应用程序支持虚拟通道 SDK 中的窗口管理 API。Web API 使 IT 管理员能够创建交互式应用程序并为最终用户自定义这些应用程序。

支持统一通信 (UC) SDK

Citrix 统一通信 SDK 允许统一通信供应商、云联络中心提供商、通信平台即服务 (CPaaS) 提供商或任何基于 WebRTC 的通信供应商与基于 Electron 的桌面或基于浏览器的应用程序无缝集成。

有关详细信息，请参阅 统一通信 (UC) SDK，这是一篇技术区文章。

WebHID 应用程序接口的重定向

适用于 HTML5 的 Citrix Workspace™ 应用程序的统一通信 SDK 实现了 Citrix-WebRTC 中定义的 WebHID API 重定向，但存在某些已知限制。它们是：

• 如果存在多个相同类型的 HID 设备，用户无法选择特定设备进行测试。
• 在 Mac 计算机上，当您使用适用于 HTML5 的 Citrix Workspace 应用程序时，该应用程序可能无法在新连接的媒体设备准备就绪之前检索自定义“compositeId”。
• 在 Windows 和 Mac 系统上，使用适用于 HTML5 的 Citrix Workspace 应用程序时，用户可能需要重新授予重新连接设备的访问权限。此过程包括使用无线键盘或鼠标 USB 接收器的设备。需要重新授予权限是由于缺少连接事件。

注意：

此功能默认情况下处于禁用状态。

如何配置

您可以通过以下方式启用此功能：

• 配置.js
• 全局应用程序配置服务

配置.js

在适用于 HTML5 的 Citrix Workspace 应用程序中，configuration.js 文件位于 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 文件夹下。编辑此文件以启用该功能。

注意：

• Citrix 建议您在修改 configuration.js 文件之前对其进行备份。
• 编辑 configuration.js 文件需要管理员级别的凭据。

要启用此功能：

1. 请您前往 HTML5Client 文件夹，并定位到其中的 configuration.js 配置文件。

2. 确保将属性 webHID 设置为 true。以下是 JSON 数据示例：

   'features' : {
       'msTeamsOptimization' : {
           'webHID' : true
           }
           }
   <!--NeedCopy-->
   

3. 使用正确的格式设置属性 hidDeviceBlockList。如果要阻止某些 HID 设备，以下是 JSON 数据示例：

   'features' : {
   'msTeamsOptimization' : {
       // The format of the blocklist is ["VID:PID", "VID:PID", "VID:PID", ...]
       // Each VID and PID is an up to 4-digit hexadecimal number with an optional "0x" prefix.
       // The VID is a required field. The PID is optional, so the colon and PID can be omitted.
       // example ["35ab:21ff", "45ac", "0x567:123a", "0x1234:0x5678"]
       'hidDeviceBlockList' : []
       }
   }
   <!--NeedCopy-->
   

4. 保存更改。

全局应用配置服务

管理员可以通过导航到 工作区配置 > 应用配置 > HDX 和多媒体 > MS Teams > 启用 webHID 重定向 和 HID 设备阻止列表 来启用此功能。选中复选框和相应的切换按钮以启用此功能。