Configure a document camera-Alibaba Cloud Workspace Terminal(Alibaba Cloud Workspace Terminal)-阿里云帮助中心

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

Open and log on to the Alibaba Cloud Workspace client.
In the upper-right corner of the client, click the icon, and then select Settings.
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

In the Start menu, search for and open Device Manager.
In the Device Manager window, navigate to , and then double-click the USB device you want to look up.
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

In the system menu bar, choose , and then click More Info in the dialog box.
At the bottom of the About This Mac panel, click System Report.
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

Click the floating menu and select Peripherals & Printers.
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.

Download the tool: https://www.uwe-sieber.de/usbtreeview_e.html#download.
Extract the downloaded package, and then double-click UsbTreeView.exe to open it.
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 (administrator)

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

Note

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

General procedure for creating or modifying peripheral policies

Create a custom policy and associate it with a cloud computer

By default, a newly created cloud computer is associated with the system-generated default policy. Because the default policy cannot be modified, the administrator must create a custom cloud computer policy in the console and associate it with the cloud computer.

Log on to the EDS enterprise console.
In the left-side navigation pane, choose O&M > Policies.
On the Policies page, click Create Policy.
On the Create Policy page, enter a Policy Name as prompted, modify 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-side navigation pane, choose Resource Management > EDS Enterprise.
On the EDS Enterprise page, perform one of the following operations as needed:
- Single operation: Find the target cloud computer, click More in the Actions column, and then select Change Policy.
- Batch operation: Select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.
On the Required Policy tab of the Change Policy panel, click Change Policy, select the custom policy you created, and then click OK.

Note
If the resource group to which the cloud computer belongs already has an associated policy, you cannot directly change the policy for the cloud computer here. You can either change the policy associated with the resource group, or first remove the cloud computer from the resource group and then change its policy.
At the bottom of the Change Policy panel, click OK, and then click Confirm Policy Change.

Modify a custom policy already associated with a cloud computer

If the cloud computer is already associated with a custom policy, the administrator can directly modify the policy in the console without re-associating it.

Log on to the EDS enterprise console.
In the left-side navigation pane, choose O&M > Policies.
On the Policies page, find the custom policy you want to modify, and then click Modify Policy in the Actions column.
On the Modify Policy page, modify the policy settings as needed, and then click OK.

Peripheral policy settings

Enable device redirection for cameras

Configuration path: Peripheral Control > Peripheral Redirection > Camera.
Configuration requirements: Set the redirection mode for cameras to Device Redirection.

Configure and use peripherals (end user)

Connect peripherals

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

Set the camera application mode

For a document camera, set its application mode to Document Camera mode in the peripheral management module of the Alibaba Cloud Workspace client.

Path: Alibaba Cloud Workspace client > > Settings > Peripherals.

FAQ

The vendor software cannot detect the document camera

If the document camera requires vendor-specific software and the software cannot detect the device, but the device appears in the cloud computer's device list, try changing the redirection mode for the document camera from Device Redirection to USB Redirection, and then reconnect to the cloud computer.

null

The USB Redirection option is disabled and unavailable by default. An administrator must modify the policy in the console before this option becomes available.

The administrator must perform the following steps:

In the console, go to O&M > Policies, find the policy associated with the target cloud computer, and click Modify Policy.
In the Peripheral Blacklist/Whitelist section, click Add Rule, enter a custom device name, the actual VID and PID of the document camera, select Whitelist, and then click OK. To obtain the VID and PID, see .
In the Peripheral Management Rules section, click Add Custom Peripheral Rule, set Device Type to Document Camera, enter the actual VID and PID of the document camera, select the terminal type used by the client, set Redirection Mode to USB Redirection, and then click OK.
At the bottom of the policy modification page, click OK, and then click Confirm in the dialog box.

The end user must perform the following verification steps:

Disconnect and reconnect to the cloud computer. Then, open Floating menu > Peripherals & Printers > Peripheral Management, find the document camera, and verify that the redirection mode has changed to USB Redirection.
Open the vendor software and verify that the document camera can be detected and used.

Troubleshooting

For common questions about cloud computer policies, see Policy FAQ.
For common questions about peripherals, see Peripheral FAQ.
For troubleshooting methods for common issues, see Self-help Guide for Peripheral Issues.