Manage twin spaces

更新时间:
复制 MD 格式

A twin space is a collection of twin entities, 3D twin scenarios, twin entity data sources, and 3D model resources. This topic describes how to create, view, and edit twin spaces.

Prerequisites

  • You have activated IoT Platform and are using a new public instance or an Enterprise instance.

    Note

    You can try IoT Platform for free after activation. For more information about the free trial, see Alibaba Cloud Free Trial for IoT Platform products. For more information about billing, see Billing overview. For more information about instances, see Instance overview.

  • You have created a product and a device for your instance, completed device-side development, and connected the device to IoT Platform.

  • You have activated the IoT Twin Engine service, which is a value-added service of IoT Platform.

    Note

    The IoT Twin Engine service is available as a value-added service and can be activated for free.

View the DEMO twin space

IoT Twin Engine provides a DEMO twin space by default. In this space, you can view the configured twin entity graph, data sources, scenarios, and 3D resources to quickly learn about the features of IoT Twin Engine.

Important

The default twin space and its configurations, such as the twin entity graph, data sources, scenarios, and 3D resources, are view-only and cannot be edited or deleted.

  1. Log on to the IoT Platform console. In the navigation pane on the left, click Value-added Services.

  2. In the IoT Twin Engine section, click Go to Service.

  3. In the upper-left corner of the IoT Twin Engine workbench, select your instance.

  4. In the navigation pane on the left, click DEMO Space.

  5. Click the space card, or click the 管理 icon in the upper-right corner of the card and select View Space.

  6. On the twin space page, view information such as the twin entity graph, data sources, scenarios, and 3D resources.

Create a twin space

  1. Log on to the IoT Platform console. In the navigation pane on the left, click Value-added Services.

  2. In the IoT Twin Engine section, click Go to Service.

  3. In the upper-left corner of the IoT Twin Engine workbench, select your instance.

  4. On the Space Management page, click Create Space and configure the parameters in the panel that appears on the right.

    Parameter

    Description

    Space Name

    The name can contain Chinese characters, letters, digits, hyphens (-), and underscores (_). The name can be up to 32 characters in length.

    Space Description

    A description of the space. The description can be up to 512 characters in length. Each Chinese character counts as one character.

    Space Coordinate

    The longitude and latitude of the space's location. The longitude and latitude can have up to six decimal places.

    Alternatively, click Locate on Map, select a location, and then click OK.

  5. Click OK to create the space.

    A card for the new space appears on the Space Management page.

After a twin space is created, a corresponding twin entity is added by default. You can view the entity on the Twin Entity Graph page of the twin space, as described in the following section.

View a custom twin space

  1. On the Space Management page, click a space card, or click the 管理 icon in the upper-right corner of the card and select View Space.

  2. On the Space Information page, view the Basic Information and Location Information of the space, as shown in the following figure.

  3. In the navigation pane on the left, click Twin Entity Graph.

    A twin entity with a primary twin node is added to the space by default. The primary node cannot be deleted. The node name is the same as the twin space name and cannot be modified.孪生主节点

Other operations

Edit a space

  1. On the Space Management page, click the 管理 icon in the upper-right corner of a space card and select Edit Information. Alternatively, on the Space Information page of the twin space, click Edit to the right of Basic Information.

  2. In the Edit Space Information panel, modify the space information and click OK.

Delete a space

  1. On the Space Management page, click the 管理 icon in the upper-right corner of a card and click Delete Space.

  2. Click OK.

What to do next

Add a twin node