DocsICP FilingConsole
Documentation
Home Page Elastic Desktop Service Personal User Guide Cloud gaming Configure a game controller

Use a game controller

Updated at:
Copy as MD
My Favorites

This topic describes how to use a game controller with a cloud computer. It covers how administrators can configure peripheral policies, how end users can connect and use a controller, and how to troubleshoot controller issues.

Background information

Environment requirements

To use a game controller with a cloud computer, ensure that your environment meets all the following requirements:

  • Cloud computer image version: 2.2.13-R-20240829.224040 or later.

    How to check and update the image version of your cloud computer

    After you log on to the Personal Edition client, click Manage on the cloud computer card. On the Information tab, view the current Image version number.

    If the image version is earlier than 2.2.13-R-20240829.224040, upgrade the image to the latest version by importing an image through a share code. For details, see Back up and restore data.

    Important

    If your current image version is earlier than 2.2.13-R-20240829.224040, you must re-import the image to upgrade, even if you have previously imported an image by using a share code.

  • 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 Box: V7.5.2 or later.

Supported controller types

  • Protocol types: PlayStation, Switch, and Xbox protocols are supported.

    Note

    • Because Xbox controllers rely on the Xbox driver, only the Windows client supports Xbox-protocol controllers.

    • For third-party controllers from other brands, the system identifies the protocol type by checking if the controller name contains keywords such as Xbox, PS, Switch, or dualsense. If the name does not contain these keywords, the Windows client defaults to Xbox controller support, and the macOS client defaults to Switch controller support.

  • Supported connection methods include Bluetooth, USB, and 2.4G. Specific methods vary by controller model.

  • Button layout support: Only the Xbox 360 button layout is supported.

  • Multiple controllers: Not supported.

Compatible controllers

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

Legend:

  • Supported indicates that the compatibility test passed.

  • Not supported indicates that the compatibility test failed. Do not use this controller.

  • A blank cell indicates that no compatibility test has been performed. This controller is not recommended.

Note

In the following list, compatibility tests for the Android client cover only cloud gaming. Tests for other clients cover both cloud computers and cloud gaming.

Controller model

Connection method

Windows client

macOS client

Android client

Wuying Box

GameSir-T4n Lite

2.4G/Bluetooth/USB

Supported

Supported

Supported

Supported

Sony PS5

2.4G/Bluetooth/USB

Supported

Supported

Supported

Sony PS4

Bluetooth/USB

Supported

Supported

Supported

Betop Sparta 3

2.4G/Bluetooth/USB

Supported

Supported

Supported

Supported

Thunderobot G50S (Pro-HD)

2.4G/Bluetooth/USB

Supported

Supported

Supported

Supported

Flydigi Direwolf 2

2.4G/Bluetooth/USB

Supported

Supported

Supported

Supported

Machenike G5Pro Max (Gaming Edition)

2.4G/Bluetooth/USB

Supported

Supported

Supported

Supported

Thunderobot G30

USB

Supported

Not supported

Mopai Red Hare PRO-HD

2.4G/Bluetooth/USB

Supported

Supported

Supported

Xbox One Controller

Bluetooth/USB

Supported

Not supported

8BitDo

2.4G/Bluetooth/USB

Supported

Nintendo Switch Pro Controller

Bluetooth/USB

Supported

Flydigi Vader 4 Pro

2.4G/Bluetooth/USB

Supported

Get peripheral information

For USB peripherals, you need the VID (Vendor ID) and PID (Product ID), which are required when you configure peripheral policies. Both VID and PID are hexadecimal values, such as 0xa12c, where the 0x prefix is typically optional. You can look up the VID and PID of a connected USB peripheral in several ways.

Important

The availability of peripheral devices on a cloud computer depends on multiple factors, including the type and version of the Alibaba Cloud Workspace terminal, the cloud computer image type and version, the type and version of the local device running the Alibaba Cloud Workspace client, and the brand and model of the peripheral device. You can visit the peripheral compatibility page to check whether a specific peripheral is compatible with a cloud computer. The data on this page was obtained under laboratory conditions and may differ from actual results.

From the Alibaba Cloud Workspace terminal

  1. Open and log on to the Alibaba Cloud Workspace client.

  2. In the upper-right corner of the client, click the icon, and then select Settings.

  3. In the left-side navigation pane of the Settings window, click Peripherals, and then view the VID and PID of the USB peripheral on the Local USB Peripherals panel.

From the computer's device manager

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

Windows

  1. In the Start menu, search for and open Device Manager.

  2. In the Device Manager window, navigate to , and then double-click the USB device you want to look up.

  3. On the Details tab of the properties dialog box, select Hardware Ids from the Property drop-down list. The VID and PID are displayed in the text box below.

macOS

  1. In the system menu bar, choose , and then click More Info in the dialog box.

  2. At the bottom of the About This Mac panel, click System Report.

  3. In the left-side navigation pane of the new window, choose Hardware > USB, select the USB device you want to look up in the right-side panel, and then view the VID and PID below.

From the floating menu

  1. Click the floating menu and select Peripherals & Printers.

  2. On the Advanced Management tab, view the VID and PID of the USB peripheral in the device list.

Use a third-party tool

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

  1. Download the tool: https://www.uwe-sieber.de/usbtreeview_e.html#download.

  2. Extract the downloaded package, and then double-click UsbTreeView.exe to open it.

  3. In the left-side directory of the tool, select the USB device you want to look up, and then view the VID and PID in the Device ID section of the right-side panel.

Configure peripheral policies

Peripheral management policies are part of the cloud computer policy, and must be created and maintained by an administrator in the console.

Note

Game controllers work with cloud computers by default and require no configuration. If issues occur, an administrator can resolve them by configuring custom peripheral rules in the console.

Note

The following examples use the EDS Enterprise Edition console. For the Business Edition procedure, see Manage policies.

Settings to enable in cloud computer policies

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.

  • Requirements: Set Device Type to Game Controller, enter the device name, VID, and PID, and set Redirection Mode to Disabled.

End user: Connect a game controller

Some game controllers require special steps to connect to certain Wuying terminals. Follow the steps below.

GameSir-T4n Lite

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. Press the A + Logo buttons to power on the controller, switch to Android mode, and enable Bluetooth pairing. The yellow light flashes.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

Connect the USB cable.

When the center yellow light turns on, the controller is in Android mode.

macOS client

Press the Y + HOME buttons to switch to Switch mode. Then, connect to your Mac computer using Bluetooth.

Sony PS5/PS4

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. Press and hold the Create button (①) and the PS button (②) at the same time. The controller enters Bluetooth pairing mode when the light bar (③) starts to flash.

    dg_controller_ps5.png

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

Connect the USB cable.

Betop Spartan 3

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. Briefly press the LB + Logo buttons. The controller enters Bluetooth pairing mode when the blue light starts to flash.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

  1. Press and hold the center Logo button. The controller switches to Switch mode when the dark blue light starts to flash.

  2. Connect the USB cable.

macOS client

Press and hold the LB + Logo buttons to power on the controller and connect using Bluetooth in Switch mode.

Thunderobot G50S (Pro-HD)

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. On the back of the controller, switch to S mode. Press and hold the small Home button on the front of the controller to enable Bluetooth pairing mode.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

Connect the USB cable.

macOS client

Switch to Switch mode and connect to your Mac computer using Bluetooth.

Flydigi Direwolf 2

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. On the back of the controller, switch to NS mode. Press and hold the small Home button at the bottom front of the controller to enable Bluetooth pairing mode.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

  1. On the back of the controller, switch the mode to USB, which is the leftmost option.

  2. Connect the USB cable.

  3. Connect to the cloud computer. The first time you connect, a dialog box appears. Select Connect Now.

macOS client

  1. Make sure the game controller is fully charged.

  2. On the back of the controller, switch to NS mode. Press and hold the small Home button at the bottom front of the controller to enable Bluetooth pairing mode.

  3. On your Mac computer, search for and connect to the Bluetooth device.

Machenike G5Pro Max

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. On the back of the controller, switch to NS mode. Press and hold the center Logo button on the front of the controller to enable Bluetooth pairing mode.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

If the button layout for A, B, X, and Y feels reversed, go to Settings > General > Diagnostic Tool > Start Detection > Game Controller. Select your game controller and switch it to the third mode.

USB connection

  1. On the back of the controller, switch the mode to USB, which is the leftmost option.

  2. Connect the USB cable.

  3. Connect to the cloud computer. The first time you connect, a dialog box appears. Select Connect Now.

macOS client

Switch to NS mode and connect to your Mac computer using Bluetooth.

Mobapad Chitu PRO-HD

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. Press and hold the D-pad Left + Home buttons to enable Android mode and connect using Bluetooth.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

Connect the USB cable.

macOS client

Connect to your Mac computer using Bluetooth.

Nintendo Switch Pro Controller

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. Press and hold the Bluetooth pairing button on the controller until the Wuying Box can find the Pro Controller device.

    joycon_sync_button.png

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

Connect the USB cable.

Flydigi Vader 4 Pro

Wuying Box

Bluetooth connection

  1. Make sure the game controller is fully charged.

  2. On the back of the controller, switch to NS mode. Press and hold the small Home button at the bottom front of the controller to enable Bluetooth pairing mode.

  3. On the Wuying Box, search for and connect to the Bluetooth device.

USB connection

  1. On the back of the controller, switch the mode to USB, which is the leftmost option.

  2. Connect the USB cable.

  3. Connect to the cloud computer. The first time you connect, a dialog box appears. Select Connect Now.

When you connect a peripheral for the first time, a connection configuration window appears in the bottom-right corner of the cloud computer desktop. Select the device type, set automatic connection, and choose whether to save the current configuration.

Game controller troubleshooting

If you have issues with your game controller, follow these steps to troubleshoot and resolve them.

Step

Check

Solution

A

Check if your Wuying terminal supports game controllers.

Wuying terminals that support game controllers include:

  • Windows client

  • macOS client

  • Android client

  • Wuying Box

Other types of Wuying terminals do not support game controllers.

If your Wuying terminal is not supported, go to the Wuying client download page to download a supported client, or switch to a supported hardware terminal.

B

Check if your Wuying client version supports game controllers.

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 version is too old, update the client. For more information, see Update the client.

C

Check if your game controller is on the list of supported models:

  • GameSir-T4n Lite

  • Sony PS5

  • Sony PS4

  • BETOP SPARTA 3

  • Thunderobot G50S (Pro-HD)

  • Flydigi Direwolf 2

  • Machenike G5Pro Max Play Edition

  • Thunderobot G30 game controller

  • MOBAPAD CHITU PRO-HD

  • Xbox One game controller

  • 8BitDo

  • Nintendo Switch Pro Controller

  • Flydigi Vader 4 Pro

If your game controller is not supported, switch to a supported model.

E

Check if the game controller is correctly connected to your local device.

Windows OS

  1. Press Win+R to open the Run window.

  2. In the Run window, enter control printers and click OK.

  3. In the Devices and Printers window, right-click the game controller icon and select Game controller settings.

  4. On the Test tab, check if the controller buttons work correctly.

macOS

Open System Settings, find the Game Controllers option, and check if the game controller is connected.

  • If the controller is not detected, the connection may be improper. Disconnect the cable and try reconnecting.

  • If reconnecting multiple times does not work, the cable may be damaged. Replace the cable.

  • If the controller is connected but the buttons do not work on the Test tab, the controller may be damaged. Replace the controller.

F

If the previous steps show no issues and you are using a USB connection, follow these steps to check if the game controller is disabled in the USB peripheral list:

  1. 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.

  2. In the Settings window, click Peripherals.

  3. In the Local USB Peripherals list, find the game controller. If the entry for the controller is editable, it means the controller is not disabled.

Follow these steps to disable the controller and check the connection status:

  1. In the Local USB Peripherals list, select the game controller and click Disable. After it is disabled, the button changes to Enable.

  2. Disconnect and reconnect the game controller.

  3. After reconnecting to the cloud computer, follow Step E to check if the cloud computer correctly recognizes the game controller.

Previous：Cloud gamingNext：Use Cases