SDK

HDX SDK

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

此功能对在您的企业门户中构建富应用程序体验非常有用，同时对用户即服务也非常有用。 在从您的 Web 站点启动 Citrix 托管应用程序和桌面时，可以在 Web 服务器上托管适用于 HTML5 的 Citrix Workspace 应用程序时提供体验。

有关面向适用于 HTML5 的 Citrix Workspace 应用的 HDX SDK 文档，请参阅 HDX SDK for HTML5（面向 HTML5 的 HDX SDK）。

有关 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 SDK 的最新版本

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

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

虚拟通道 SDK 支持

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

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

该功能中的已知限制

• 如果虚拟通道的配置不正确，您可以观察到 30 秒的滞后。
• 创建自定义 VC 时，请使用“CTX”以外的任何对象启动“streamName”。

有关详细信息，请参阅 Citrix Virtual Channel SDK for Citrix Workspace app for HTML5（面向适用于 HTML5 的 Citrix Workspace 应用程序的 Citrix 虚拟通道 SDK）。

虚拟通道 SDK 的增强功能

自 2305 版本起，适用于 HTML5 的 Citrix Workspace 应用程序支持虚拟通道 SDK 中的窗口管理 API。 通过 Web API，IT 管理员可以创建交互式应用程序，并为最终用户对其进行自定义。

支持统一通信 (UC) SDK

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

有关详细信息，请参阅 Tech Zone 文章统一通信 (UC) SDK。

WebHID API 的重定向

适用于 HTML5 的 Citrix Workspace 应用程序的统一通信 SDK 实现了在 Citrix-WebRTC 中定义的 WebHID API 的重定向，但存在某些已知限制。 这些问题如下所示：

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

注意：

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

如何配置

可以使用以下方法启用该功能：

• Configuration.js
• Global App Configuration Service

Configuration.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. 保存更改。

Global App Configuration Service

管理员可以通过导航到 Workspace 配置 > 应用程序配置 > HDX 和多媒体 > MS Teams > 启用 webHID 重定向和 **HID 设备黑名单来启用该功能。 选择复选框和相应的切换按钮可启用该功能。</p>