Peripheral FAQs
This topic answers frequently asked questions about peripherals for personal edition cloud computers.
Contents
General
Supported USB peripherals
Cloud computers provide a USB redirection feature that supports a wide range of devices, such as printers, USB flash drives, drawing tablets, and webcams.
Keyboards, mice, and game controllers
Erratic mouse cursor
Enable the capture cursor feature in the cloud computer to use the mouse normally.
Connect to your cloud computer.
On the cloud computer desktop, click the floating ball and select Manage.
Go to Manage > Preferences > Controls and enable cursor capture. When enabled, the cursor is confined to the cloud computer window, which ensures that in-game camera rotation works as expected.
Abnormal external mouse behavior on iPad
Symptoms
Pointer style: The mouse pointer in the cloud computer overlaps with the native iPadOS pointer, which appears as a semi-transparent gray circle.
Excel operation issues:
You cannot select multiple columns with the mouse.
After selecting a single column, you cannot select a cell in that column with a single left-click. You must double-click to select it.
Cause
This occurs because the Perform Touch Gestures feature is enabled on the iPad. As a result, the native iPadOS pointer cannot be hidden within the cloud computer, causing the two pointers to overlap. When this feature is enabled, mouse operations are mapped to touch actions. This causes operational issues in Excel and other applications.
Solution
Follow these steps to turn off Perform Touch Gestures.
On your iPad, open the Settings app.
Go to Accessibility > Touch > AssistiveTouch, and then turn off Perform Touch Gestures.
Game controller not recognized
If your game controller is not working, follow these troubleshooting steps:
Step | Check item | Resolution |
A | Verify that your Wuying client type supports game controllers. Supported Wuying client types include:
Other types of Wuying clients do not support game controllers. | If your current Wuying client does not support game controllers, go to the Wuying Client Download page to download a supported client, or switch to a supported hardware terminal. |
B | Verify that your Wuying client version supports game controllers. Version requirements:
| If your Wuying client is outdated, update the client. For more information, see Upgrade the client. |
C | Verify that your game controller is on the list of supported models:
| If your game controller is not on the supported list, switch to a supported model. |
E | Verify that the game controller is correctly connected to your local device. Windows
macOSOpen System Settings, find the Game Controllers option, and verify that the game controller is connected. |
|
F | If the previous steps do not resolve the issue and you are using a USB connection, check if the game controller is disabled in the USB peripheral list:
| Try resetting the game controller's status in the client:
|
USB flash drives and UKeys
Using UKey devices
Common USB UKey devices fall into three categories: HID, MASSSTORAGE, and composite (HID and MASSSTORAGE). This section describes how to use each type of UKey device with a cloud computer.
HID-type UKey devices
HID-type UKey devices use USB redirection by default in a cloud computer and should work without any extra configuration.
For some UKey devices, the cloud computer may not be able to retrieve the device name. Such devices might be on the blocklist by default. This means the device will not appear in the peripheral management list in the cloud computer. In this case, you need to add the device to the allowlist as described below.
NoteThe following steps use the Windows client v6.0 as an example. The actual UI may vary depending on your client and its version.
On the card display page of the Windows client, click the
icon and select Settings.In the Preference Settings panel, select Peripheral Management.
In the Local Peripherals section, find the device and in the USB Redirection Allowlist/Blocklist Settings column, select Allowlist.
Disconnect and reconnect the UKey device, or reconnect to the cloud computer.
MASSSTORAGE and composite HID and MASSSTORAGE UKey devices
For MASSSTORAGE and composite (HID and MASSSTORAGE) UKey devices, the system cannot distinguish them from other storage devices by their appearance. Therefore, by default, these UKey devices use device redirection, just like other storage devices. However, UKey devices will not function correctly with device redirection. To resolve this issue, follow these steps:
In the cloud computer, activate the floating ball and click Peripherals.
In the Peripherals dialog box, click Advanced Peripheral Management.
In the Advanced Peripheral Management dialog box, click Unknown Device Type.
Find the corresponding UKey device and select USB Redirection.
Disconnect and reconnect the UKey device.
UKey not in peripheral list
Symptoms
USB redirection is enabled in the console, but after you insert a UKey device, it does not appear in the cloud computer's peripheral list.
Cause
The cloud computer may be unable to retrieve the names of some UKey devices. These devices might be on the blocklist by default. Blocklisted devices do not appear in the peripheral list.
Resolution
On the client's card display page, click the
icon and select Settings.In the Preference Settings panel, select Peripheral Management.
In the peripheral management settings, find the device and add it to the allowlist.
Disconnect and reconnect the device, or reconnect to the cloud computer.
UKey listed but unusable
If USB redirection is enabled in the console and an inserted UKey device appears in the peripherals list as available but does not work in the cloud computer, you can try the following solutions:
Change the UKey device's redirection mode to USB redirection.
In the cloud computer, open the DesktopAssistant and click Peripherals.
In the Peripherals dialog box, click Advanced Peripheral Settings.
In the Advanced Peripheral Settings dialog box, click Unknown Device.
Find the corresponding UKey device and select USB Redirection.
Unplug and replug the UKey device.
Install the required driver.
For many UKey devices to function correctly after being connected via USB redirection, you must install a corresponding driver on the cloud computer. If the UKey device appears in the peripherals list but is unusable, you must install its corresponding driver.