USB人类接口设备（HID）支持

早期访问功能

USB HID支持是一个早期访问功能

除了鼠标和键盘之外，帧现在支持连接到本地端点的10个USB HID设备（3D小鼠，游戏机和操纵杆）。本指南旨在通过USB HID的设置和配置步行管理员。

笔记

帧应用程序在Windows，MacOS和Linux端点上完全支持USB HID，而框架终端（HTML5浏览器）此时仅支持MacOS和Linux Chrome浏览器上的USB HID。

要求

  • 管理员必须访问帐户的沙箱。

  • 管理员需要在沙盒上安装Nutanix Frame Virtual USB驱动程序。要获取此驱动程序，请创建一个支持案件并包括您使用的帧服务器的版本。

设置

  1. 首先导航到您想要使用USB HID支持配置的帐户的沙箱。如果尚未运行，则在沙箱上电。

. . / _images / hid_1.png

  1. 一旦你进入沙盒，使用虚拟USB驱动程序在上述要求部分提及。运行安装程序。

  2. 安装完成后，重新启动沙箱以确保帧访客代理检测到虚拟USB驱动程序。

  3. 您可以通过导航到Sandbox的设备管理器来验证虚拟USB驱动程序是否已经安装。您应该在列表的底部看到“XiFrame虚拟设备”。

../_images/hid_dev_mgmt.png.

  1. 一旦你验证了Virtual USB 1.0驱动程序已经安装，关闭Sandbox会话并导航到帐户仪表盘的“设置”页面。

  2. 在“Session”选项卡下，向下滚动到“Advanced options”部分。输入USB在“高级终端参数”字段下，如下所示。单击“保存”。

../_images/hid_arg.png.

  1. 一旦您已准备就可以向用户提供USB HID支持，请发布沙箱以确保Nutanix Frame Virtual USB驱动程序在您的生产工作负载VM上。

最终用户配置

根据访问帧的方式的组合，可能需要其他配置。以下部分详细介绍最终用户的其他设置说明。

Mac OS或Linux上的Chrome

最终用户可能需要一些附加配置，具体取决于它们是访问其帧会话的方式。如果您的用户通过Web浏览器访问帧，则必须在MacOS或基于Linux的操作系统上使用Chrome。最终用户应按照以下步骤完成USB HID支持的配置。Chrome用户必须在Chrome浏览器中启用“实验网络平台功能”，因为Google仍认为USB HID和WebUSB支持是一个实验功能。

  1. 在新的Chrome浏览器选项卡中，在地址栏中输入以下内容：

Chrome：//标志/＃eneratival-experish-platform-platform  - 功能

  1. 在页面顶部，您将看到“实验网络平台功能”选项。使用下拉菜单启用此功能。

../_images/hid_eu11.png.

  1. 一旦出现在页面底部以应用更改后，单击“重新启动”按钮。

. . / _images / hid_eu21.png

Mac OS上的帧应用程序

如果您计划在MacoS 10.15或更高版本上使用帧应用中使用USB功能，则需要调整本地安全设置。只需导航到系统首选项>安全性和隐私>输入监视。从那里，将帧应用程序添加到列表中。

../_images/usb_mac1.png

Linux框架应用

对于用户希望访问的设备，audev.必须创建规则。

  1. 创建一个文件50-USBDEVICE.RULES.在/etc/udev/rules.d

  2. 对于每个设备，添加一行如下:

    子系统=="usb"， ATTRS{idVendor}=="046d"， ATTRS{idProduct}=="c626"， MODE="0664"， GROUP="plugdev"

    取代Idvendor.价值和IdProduct.具有实际值的值。在上面的示例中，该规则是为设备编写的Idvendor = 046d.和IDProduct = C626.（值为十六进制）。

笔记

用户运行帧应用程序必须是“PlugDev”组的一部分。

故障排除

如果帧状态栏右下角的USB图标是红色的，则将悬停在其中以查看显示的错误。以下是不同情景的一些例子及其含义。

  • 工具提示信息“不支持”:服务器不支持USB功能。需要更新框架客户代理或需要安装虚拟USB驱动程序。请注意，驱动程序可能已经安装，但是Frame Guest Agent可能需要升级到驱动程序的新版本，以便USB功能能够正常工作。

  • 工具提示消息“无法从主机获取设备”:应用程序访问主机(应用程序安装并运行的机器)上的USB设备有问题。

  • 错误消息“无法插入设备”：单击USB设备列表中的设备后，您可能会看到此消息。这意味着帧平台无法与USB设备通信。我们推荐创建支持案例进一步评估。

  • 您的设备未列出：如果您发现USB设备未显示为设备列表中的选项，则帧平台无法识别您的设备。我们推荐创建支持案例进一步评估。

  • 错误消息“无法打开与设备连接：访问被拒绝”：单击USB设备以“插入”到远程会话时，该平台无法打开与设备的连接，因为操作系统阻止了连接。

    • 如果Frame App在Linux上运行，请验证udev规则是否应用于本地Linux端点。如果udev规则对Linux有效，或者应用程序运行在Windows或macOS上，那么您本地端点上的操作系统正在阻塞连接，需要进一步调查。

测试USB设备

您可以在帧会话中打开浏览器并访问诸如此类资源之类的在线资源https://gamepad-tester.com/测试USB HID设备。USB HID支持是一个早期访问功能。虽然我们已经过测试并验证了许多类型和品牌的USB HID设备，但我们始终开放到我们的早期访问功能的反馈。如果您想提交反馈，请创建一个支持案例。