Manage 3D Assets

This topic describes how you add 3D assets and manage in your AWS IoT TwinMaker workspace.

Prerequisites

Before you are able to upload any supported file type into TwinMaker make sure you have the following prerequisites:

1. An AWS Account and the necessary permissions to use AWS IoT TwinMaker. If you already have AWS IoT TwinMaker set up, you can proceed to the next section. Otherwise, follow the instructions to set up an account and configure authentication.

2. You have created an AWS IoT TwinMaker workspace. For more information on workspace creation, read the workspace creation topic.

Goals

"I want to upload my environment or a model of my equipment into AWS IoT T TwinMaker."

Once you have a AWS IoT TwinMaker workspace and scene configured, you can use AWS IoT TwinMaker's resource library to upload and organize 3d assets. Currently the supported the following 3D file formats: GLB and GLTF.

Additionally, you have a Matterport environment AWS IoT TwinMaker supports Matterport integration. The integration allows you to import your Matterport digital twin into your TwinMaker scene

Resource library limitations

Your 3D models can have a significant impact on performance. Complex model geometry and meshes can reduce performance. For example, industrial CAD models have a high level of detail. We recommend compressing these model's meshes and reducing their polygon count before using them in AWS IoT TwinMaker scenes. If you're creating new 3D models for AWS IoT TwinMaker, you should establish a level of detail and maintain it across all your models. Remove details from models that don’t affect the visualization or interpretation of your use case..

To compress models and reduce the file size, use open source mesh compression tools, such as DRACO 3D data compression.

Unoptimized textures can also impact performance. If you don’t require any transparency in your textures, considering choosing the PEG image format over the PNG format. You can compress your texture files by using open source texture compression tools, such as Basis Universal texture compression.

Uploading 3D assets

The following steps show you how to upload assets to the AWS IoT TwinMaker console:

1. Login into your AWS account.

2. Open the AWS IoT TwinMaker console.

3. Navigate to your workspace, or create a new one. For more information on creating a workspace, read the workspace creation topic.

4. Using the left navigation menu in the console, find the Resource library option and select it.

5. Press the Add resources button, then press the Choose file button. Now you can select files from your local machine and upload them to your workspace's resource library.

6. Now any 3D uploaded, should appear in your resource library and be ready for use in your workspace.  

Importing a Matterport digital twin

AWS IoT TwinMaker supports Matterport integration, allowing you to import your Matterport digital twins into your AWS IoT TwinMaker scenes. Your Matterport digital twin can serve as an environment in your AWS IoT TwinMaker scene. Read the official documentation AWS IoT TwinMaker Matterport integration, to learn how to integrate your Matterport digital twin into an AWS IoT TwinMaker scene.  

Clean up

The following steps show you how to remove assets from workspace.

1. Login into your AWS account.

2. Open the AWS IoT TwinMaker console.

3. Navigate to the workspace that has the 3D assets you want to remove.

4. Open the resource library with the left navigation menu.

5. On the resource library page press the delete button.

6. In the delete window, type out the name of the resource you wish to remove. When ready, press okay to remove the resource.  

7. Your 3D model file should now be removed.