Connect a gamepad to a cloud computer-Alibaba Cloud Workspace Terminal(Alibaba Cloud Workspace Terminal)-阿里云帮助中心

You can use a game controller to play games on Elastic Desktop Service. This article explains how administrators can configure peripheral policies, and how end users can connect, use, and troubleshoot a game controller.

Background information

Prerequisites

To use a game controller with your cloud computer, ensure the following requirements are met:

Image version: 2.2.13-R-20240829.224040 or later.

Check and update image version

Log in to the EDS client. On the cloud computer card, click Manage in the lower-right corner. On the Information tab, view the current image version number.

If the image version number is earlier than 2.2.13-R-20240829.224040, you must update the image. For more information, see Manage and maintain cloud computers.
Driver: If you use an Xbox 360 controller, you must install the Xbox 360 controller driver.
Client version:
- Windows client: V7.5 or later.
- macOS client: V7.5 or later.
- Android client: V7.4 or later.
- Wuying Cloud Box: V7.5.2 or later.

Controller compatibility

Protocol type: PlayStation, Switch, and Xbox controllers are supported.
Note
- Xbox controllers are supported only on the Windows client because they require the Xbox driver.
- For third-party controllers, the system identifies the protocol type based on whether the controller's name contains Xbox, PS, Switch, or dualsense. If the name lacks these keywords, the controller defaults to the Xbox protocol on the Windows client and the Switch protocol on the macOS client.
Connection method: Bluetooth, USB, and 2.4G connections are supported. Supported connection methods may vary by controller model.
Button mapping: Only the Xbox 360 button mapping is supported.
Multi-controller: Not currently supported.

Compatible controllers

The following controller models passed our compatibility tests. We recommend using these controllers for the best experience.

Legend:

The icon indicates that the controller passed the compatibility test.
The icon indicates that the controller failed the compatibility test. Do not use this controller.
No icon indicates the controller has not been tested. We recommend against using these controllers.

Note

In the following list, compatibility testing for the Android client covers only cloud gaming. For all other clients, testing covers both cloud computers and cloud gaming.

Controller model	Connection method	Windows client	macOS client	Android client	Wuying Cloud Box
GameSir-T4n Lite	2.4G/Bluetooth/USB
Sony PS5	2.4G/Bluetooth/USB
Sony PS4	Bluetooth/USB
Betop Spartan 3	2.4G/Bluetooth/USB
ThundeRobot G50S (Pro-HD)	2.4G/Bluetooth/USB
Flydigi Direwolf 2	2.4G/Bluetooth/USB
Machenike G5 Pro Max	2.4G/Bluetooth/USB
ThundeRobot G30	USB
MOBAPAD CHITU PRO-HD	2.4G/Bluetooth/USB
Xbox One Controller	Bluetooth/USB
8BitDo	2.4G/Bluetooth/USB
Nintendo Switch Pro Controller	Bluetooth/USB
Flydigi Vader 4 Pro	2.4G/Bluetooth/USB

Get peripheral information

For USB peripherals, you need the Vendor Identifier (VID) and Product Identifier (PID) to configure peripheral policies. The VID and PID are hexadecimal strings, such as 0xa12c. The 0x prefix can typically be omitted. You can find the VID and PID of a connected USB peripheral in several ways.

Important

Multiple factors affect the availability of peripherals in a cloud computer. These factors include the type and version of the Alibaba Cloud Workspace terminal and client, the cloud computer image, the local device that runs the client, and the brand and model of the peripheral. You can check the compatibility of a specific peripheral with cloud computers on the Peripheral Compatibility Query page. The data on this page comes from laboratory tests and is for reference only. Actual results may vary.

Workspace terminal

Open and log on to the Alibaba Cloud Workspace client.
In the upper-right corner of the client, click the icon and select Settings.
In the left navigation pane of the Settings window, click Peripherals. In the Local USB Peripherals panel, you can view the VID and PID of your USB peripheral.

Manually on your computer

You can find the VID and PID of a peripheral in your computer's device management information.

Windows

From the Start menu, search for and open Device Manager.
In the Device Manager window, expand and double-click the target USB device.
Go to the Details tab. From the Property drop-down list, select Hardware Ids. The VID and PID are displayed in the Value text box below.

macOS

From the Apple menu bar, choose . In the pop-up window, click More Info.
At the bottom of the About panel, click System Report.
In the left navigation pane of the new window, select Hardware > USB. Select the target USB device on the right to view its VID and PID in the details section below.

Using a third-party tool

You can use the USB Device Tree Viewer tool to view peripheral information. This tool is available for Windows only.

Download the tool from https://www.uwe-sieber.de/usbtreeview_e.html#download.
Unzip the downloaded package and double-click UsbTreeView.exe to run it.
In the navigation tree on the left, select the target USB device. You can find the VID and PID in the Device ID section of the right-side panel.

Configure a peripheral policy

Peripheral control policies are part of cloud computer policies, which administrators must create and maintain in the console.

Note

By default, gamepads can be used directly in cloud computers without any configuration. If you encounter issues, an administrator can configure custom peripheral rules on the console to resolve them.

Note

The following procedure uses the Elastic Desktop Service (EDS) console for enterprises as an example. For the specific procedure for the business edition, see Manage policies.

Peripheral policy procedure

Create and bind policy

By default, a new cloud computer is bound to a system-generated default policy that cannot be modified. An administrator must create a custom cloud computer policy and bind it to the cloud computer.

Log on to the Elastic Desktop Service Enterprise console.
In the left navigation pane, choose Operation & Maintenance > Policies.
On the Policies page, click Create Policy.
On the Create Policy page, specify a Policy Name, configure the policy settings as needed, and then click OK.
After the policy is created, you can view it in the list on the Policies page.
In the left navigation pane, choose Resources > Cloud Computers - Enterprise Edition.
On the Cloud Computers - Enterprise Edition page, perform one of the following operations:
- To change the policy for a single cloud computer, find the target cloud computer, click More in the Actions column, and then select Change Policy.
- To change the policy for multiple cloud computers, select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.
In the Change Policy panel, on the Required Policy tab, click Change Policy. Select the new custom policy and click OK.
Note
If a cloud computer belongs to a resource group that already has an associated policy, you cannot change the policy for the cloud computer directly. You must either change the policy associated with the resource group or move the cloud computer out of the resource group before changing its policy.
At the bottom of the Change Policy panel, click OK, and then click Confirm Change.

Modify existing policy

If a cloud computer is already bound to a custom policy, the administrator can modify the policy directly in the console without re-binding it.

Log on to the Elastic Desktop Service Enterprise console.
In the left navigation pane, choose Operation & Maintenance > Policies.
On the Policies page, find the custom policy that you want to modify and click Modify Policy in the Actions column.
On the Modify Policy page, update the policy settings as needed and click OK.

Policy configuration

Configure custom peripheral rules

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

Configuration path: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.
Settings: Set device type to Gamepad, enter the device name, VID, and PID, and set redirection mode to Forbid.

Configure gamepad connections

Some gamepads require specific steps to connect to certain Wuying terminals. Follow the steps below.

GameSir-T4n Lite

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
Press the A+Logo keys to power on the gamepad, switch it to Android mode (the indicator light flashes yellow), and enter Bluetooth pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Connect the USB data cable.

A solid yellow center indicator light indicates the gamepad is in Android mode.

macOS client

Press the Y+HOME keys to switch to Switch mode, and then connect to your Mac via Bluetooth.

Sony PS5/PS4

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
Press and hold the Create button (①) and the PS button (②) simultaneously. The gamepad enters Bluetooth pairing mode when its light bar (③) starts flashing.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Connect the USB data cable.

Betop Spartan 3

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
Briefly press the LB+Logo keys. The gamepad enters Bluetooth pairing mode when the indicator light starts flashing blue.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Press and hold the center Logo button. The gamepad switches to Switch mode when the indicator starts flashing dark blue.
Connect the USB data cable.

macOS client

Press and hold the LB+Logo keys to power on the gamepad and enter Switch mode. Then, connect it to your Mac via Bluetooth.

ThundeRobot G50S (Pro-HD)

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
On the back of the gamepad, switch to S mode. Press and hold the Home button in the center of the front panel to enter Bluetooth pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Connect the USB data cable.

macOS client

Switch to Switch mode, then connect to your Mac via Bluetooth.

Flydigi Direwolf 2

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
On the back of the gamepad, switch to NS mode. Press and hold the Home button at the bottom of the front panel to enter Bluetooth pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

On the back of the gamepad, switch the mode to USB (the leftmost option).
Connect the USB data cable.
Connect to the cloud computer. When connecting for the first time, a dialog box appears. Click Connect Now.

macOS client

Ensure the gamepad has sufficient battery power.
On the back of the gamepad, switch to NS mode. Press and hold the Home button at the bottom of the front panel to enter Bluetooth pairing mode.
On your Mac, search for and connect to the Bluetooth device.

Machenike G5 Pro Max

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
On the back of the gamepad, switch to NS mode. Press and hold the center Logo button on the front panel to enter Bluetooth pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

If the functions of the A and B keys or the X and Y keys are swapped, navigate to Settings > General > Diagnostic Tool > Start Test > Gamepad. Select the gamepad and switch it to the third mode.

USB connection

On the back of the gamepad, switch the mode to USB (the leftmost option).
Connect the USB data cable.
Connect to the cloud computer. When connecting for the first time, a dialog box appears. Click Connect Now.

macOS client

Switch to NS mode, then connect to your Mac via Bluetooth.

MOBAPAD CHITU PRO-HD

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
Press and hold the D-pad Left+Home keys to enter Android pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Connect the USB data cable.

macOS client

Connect to your Mac via Bluetooth.

Nintendo Switch Pro Controller

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
Press and hold the pairing button on the controller until the Pro Controller device appears in the list of available devices on your Wuying Magic Cube.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

Connect the USB data cable.

Flydigi Vader 4 Pro

Wuying Magic Cube

Bluetooth connection

Ensure the gamepad has sufficient battery power.
On the back of the gamepad, switch to NS mode. Press and hold the Home button at the bottom of the front panel to enter Bluetooth pairing mode.
On the Wuying Magic Cube, search for and connect to the Bluetooth device.

USB connection

On the back of the gamepad, switch the mode to USB (the leftmost option).
Connect the USB data cable.
Connect to the cloud computer. When connecting for the first time, a dialog box appears. Click Connect Now.

When you connect a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. You can select the device type, set it to connect automatically, and save the current configuration.

Troubleshoot game controller issues

If you encounter issues with a game controller, follow these steps to resolve them.

Step	Check	Resolution
A	Verify that your Wuying client type supports game controllers. Supported Wuying clients include: Windows client macOS client Android client Wuying Box Game controllers are not supported on other types of Wuying clients.	If your current Wuying client is not supported, 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 meets the requirements. Version requirements: Windows client/macOS client: V7.5 or later. Android client: V7.4 or later. Wuying Box: V7.5.2 or later.	If your Wuying client is outdated, update it. For more information, see Configure Desktop Client (desktop) Upgrade Client (mobile) Upgrade Terminal Version (hardware terminal)
C	Verify that your game controller is on the list of supported models: GameSir-T4n Lite Sony PS5 Sony PS4 Betop Spartan 3 ThundeRobot G50S (Pro-HD) Flydigi Direwolf 2 Machenike G5 Pro Max ThundeRobot G30 MOBAPAD CHITU PRO-HD Xbox One Controller 8BitDo Nintendo Switch Pro Controller Flydigi Vader 4 Pro	If your game controller is not on the list, switch to a supported model.
D	Verify that the cloud desktop image version supports game controllers. Game controllers are supported only on cloud desktop images of version `2.2.13-R-20240829.224040` or later.	If your cloud desktop image is outdated, update the image by following these steps: Check and update image version Log in to the EDS client. On the cloud computer card, click Manage in the lower-right corner. On the Information tab, view the current image version number. If the image version number is earlier than `2.2.13-R-20240829.224040`, you must update the image. For more information, see Manage and maintain cloud computers.
E	Verify that the game controller is connected correctly to your local device. Windows Press `Win`+`R` to open the Run dialog box. In the Run dialog box, enter `control printers` and click OK. In the Devices and Printers window, right-click the game controller icon and select Game Controller Settings. On the Test tab, verify that the buttons work as expected. macOS Open System Settings, find Game Controller, and verify that the game controller is connected.	If the game controller is not detected, the connection may be faulty. Disconnect and reconnect the cable. If reconnecting the cable does not resolve the issue, the cable may be damaged. Replace it. If the controller is connected but the buttons do not work on the test tab, the controller might be damaged. Please replace it.
F	If the issue persists and you are using a USB connection, follow these steps to check the game controller's status in the local USB peripheral list: Select an entry point based on your logon status: Before you log on: In the upper-right corner of the client logon page, click the icon and select Settings. After you log on: In the upper-right corner of the cloud resource list page, click the icon and select Settings. In the Settings window, click Peripherals. In the Local USB Peripheral List, find the game controller. If the entry is editable, it means the game controller is enabled.	Disable the game controller and verify the connection status: In the Local USB Peripheral List, select the game controller and click Disable. The button then changes to Enable. Disconnect and reconnect the game controller. Reconnect to the cloud desktop and follow Step E to verify that the cloud desktop correctly detects the game controller.

If the issue persists, submit a ticket for technical support.