跳过主要内容

USB人界面设备支持

本指南旨在为希望将USB人接口设备（HID）设备的使用集成到其最终用户体验中的管理员。

框架now supports up to 10 USB HID input devices, such as 3D mice, game controllers, and joysticks, connected to the local endpoint, in addition to mouse and keyboard.

考虑因素
  • 在受支持的Web浏览器中运行的帧终端仅支持USB HID HID在Linux和MacOS Chrome浏览器上。
  • Frame App完全支持USB HID在Linux，MacOS和Windows端点上。

要求

为了使最终用户使用USB HID，管理员必须验证框架虚拟USB驱动程序是否已安装在沙盒上并发布。框架虚拟USB驱动程序包含在“框架访客代理安装程序”中，也可以使用Frame Agent设置工具（快速）下载。FGA和快速安装程序均可从中下载Nutanix Portal。您必须有一个我的Nutanix用户帐户才能访问Nutanix门户。

框架虚拟USB驱动程序

确认

首先验证您确实在沙箱中安装了虚拟USB驱动程序：

  1. 如果尚未运行，请在沙箱上电源。
  2. 进入沙箱后，请验证虚拟USB驱动程序是否已通过导航到Sandbox的设备管理器来安装。将有一个名为“帧虚拟设备”的设备。选择虚拟USB集线器并检查驱动程序详细信息将确认已安装和操作框架虚拟USB驱动程序。

装置经理

设备管理器 - 框架虚拟设备

安装

If the Frame virtual devices does not exist in the Device Manager, then:

  1. Download the Frame Agent Setup Tool from theNutanix Portal在沙箱内部并运行安装程序以安装虚拟USB驱动程序。
  2. 安装完成后，请重新启动沙箱，以确保框架来宾代理检测到虚拟USB驱动程序。
  3. 您可以按照上述步骤验证虚拟USB驱动程序是否已正确安装。

框架帐户配置

  1. 一旦您验证了已经安装了虚拟USB驱动程序，请关闭沙盒会话并导航到帐户仪表板中的“设置”页面。

  2. 在“会话”选项卡下，启用USB重定向切换。单击“保存”。

会话设置- USB Redirection

会话设置- USB Redirection
  1. You should now be able to test a USB Human Interface Device within your Sandbox.
  2. 一旦准备好使USB HID提供给用户可用的支持，请发布沙箱，以确保Nutanix框架虚拟USB驱动程序在您的生产工作负载VM上。
note

由于USB重定向设置在会话设置中，因此帧管理员可以在沙箱或特定的启动板上启用USB重定向策略，而不是在帧帐户级别启用USB HID功能。

最终用户配置

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

Chrome on macOS or Linux

For users on macOS or Linux endpoints, they must use Chrome on macOS or Linux-based operating systems in order to use USB Human Interface Devices. End users should follow the steps below to complete configuration of USB HID support. Chrome users must enable the “Experimental Web Platform features” within the Chrome browser, as Google still considers USB HID and WebUSB support to be an experimental feature.

  1. 在新的Chrome浏览器选项卡中，在地址栏中输入以下内容：
铬URL
chrome://标志/＃启用 - 实验 - 温布平台功能
  1. 在页面顶部，您将看到“实验Web平台功能”选项。使用下拉菜单启用此功能。

Chrome Experimental Web Platform features

Chrome Experimental Web Platform features
  1. Click the "Relaunch" button at the lower right corner of the browser once the button appears at the bottom of the page to apply your changes.

重新启动铬

重新启动铬

框架应用程序on Linux

对于用户想要访问的设备，udev必须创建规则。

  1. Create a file50-usbdevices.rules在/etc/udev/rules.d。
  2. For each device, add a line as follows:
子系统==“USB”，，，，attrs{idvendor}==“ 046D”，，，，attrs{iDproduct}=="c626"，，，，模式="0664"，，，，团体=“插件”

ReplaceidvendorandiDproduct具有USB HID设备的实际值的值。在上面的示例中，该规则是为设备编写的IDVENDOR = 046DandidProduct = C626(the values are hexadecimal).

note

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

故障排除

  • 您的设备未列出：：如果您发现您的USB设备未作为设备列表中的选项显示，则帧未识别您的设备。我们推荐creating a support case进行进一步评估。

  • Tooltip message “Not supported”: Server does not support USB functionality. Either the Frame Guest Agent needs to be updated or the virtual USB driver needs to be installed. Note that driver may be installed, but Frame Guest Agent may need to be upgraded to the newer version of driver in order for the USB functionality to work properly.

  • 工具提示消息“无法从主机获取设备”: The application is having trouble accessing USB devices on the host machine (the machine where the application is installed and running).

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

  • 错误消息“无法打开与设备的连接：访问拒绝”：当您单击列表中的USB设备以“插入”到远程会话时，帧无法打开与设备的连接，因为操作系统正在阻止连接。

    • If Frame App is running on Linux, verify that the udev rules are applied to the local Linux endpoint. If udev rules are valid for Linux or the application is running on Windows or macOS, the operating system on your local endpoint is blocking the connection and will require further investigation.

测试您的USB设备

您可以在框架会话中打开浏览器，并访问在线资源，例如https://gamepad-tester.com/to test your USB HID devices. While we have tested and validated many brands and types of USB HID devices, there may be USB devices that do not work yet with Frame. If you would like to submit feedback, please创建支持案例。

Baidu