DocsICP FilingConsole
官方文档
首页

Use a game controller

更新时间：
复制 MD 格式
我的收藏

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:

  • The icon indicates that the compatibility test passed.

  • The icon indicates that the compatibility test failed. Do not use this controller.

  • A missing icon 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

Sony PS5

2.4G/Bluetooth/USB

Sony PS4

Bluetooth/USB

Betop Sparta 3

2.4G/Bluetooth/USB

Thunderobot G50S (Pro-HD)

2.4G/Bluetooth/USB

Flydigi Direwolf 2

2.4G/Bluetooth/USB

Machenike G5Pro Max (Gaming Edition)

2.4G/Bluetooth/USB

Thunderobot G30

USB

Mopai Red Hare 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

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

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

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

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

  2. In the Device Manager window, expand and double-click the target USB device.

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

  1. From the Apple menu bar, choose . In the pop-up window, click More Info.

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

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

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

  2. Unzip the downloaded package and double-click UsbTreeView.exe to run it.

  3. 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 peripheral policies

Peripheral control policies are part of cloud computer policies, which administrators must create and maintain 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 procedure uses the Elastic Desktop Service (EDS) console for enterprises as an example. For the specific procedure for the business edition, 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