The layout of DataMesh Importer user interface are as follows:
Menu
The Menu includes functions such as File, Settings, and Information Panel. You can perform operations such as opening local models, opening cloud models, and saving models.
File menu
Open Local: Open a locally saved model file.
Open Cloud: Open a model file from the FactVerse resources.
Save Model: Upload the currently imported model to the FactVerse resources.
Save As: Perform a Save As operation on the current model and specify a new name for it.
Save
It is the same as the Save Model function in the File menu. It saves the model resource to the FactVerse resources.
Settings
Language: You can switch to different interface The DataMesh Importer offers four interface languages: Simplified Chinese, Traditional Chinese, English, and Japanese. After users log in, the interface language will default to the system language. If the system language is not one of these four application languages, the interface language will default to English.
Account > User account: Display current login user account.
Account > Log out: Exit current user account.
Rendering Quality: To adapt to different device performance, DataMesh One provides six different rendering quality options. Increasing the quality can optimize screen aliasing, ripple, and shadow effects.
Change Rendering Environment: Support modifying the rendering environment of the scene, which can include system-built rendering environments or custom rendering environments. For detailed information, please refer to the guide on Change rendering environment.
Upload log: You can upload the latest seven log files to FactVerse.
Operating Parameters: Display the application’s Memory, FPS, DrawCall, Batches, Polygons, Vertices, and other key data.
About: View the current application version number.
Quit: Close the application.
Information Panel
Display attributes information of the model.
Node structure directory
The Node structure directory is a feature in DataMesh Importer that displays the hierarchical structure and node relationships of the imported 3D models. The Node structure directory can help you better manage and control the structure of the imported 3D model. You can select, deselect, and merge nodes as needed to flexibly adjust the model’s hierarchical structure. This can improve the model’s operability and flexibility, making it easier for you to perform subsequent model editing and scene creation work.
In the Node structure directory, you can perform the following operations:
Smart Select All: With Smart Select All, you can quickly select or deselect all nodes for batch operations.
Single node selection: Each node has a checkbox that you can click to select or deselect the node. Through the checkbox, you can selectively control the components of the model. When you upload the model, the selected nodes will be uploaded as separate objects, while the unselected nodes will be merged into other nodes.
Select same-level nodes quickly: By double-clicking the checkbox of a node, you can quickly select or deselect all nodes at the same level. This feature makes it convenient for you to perform mass selection or deselection operations on nodes at the same level.
Note: When the number of nodes exceeds 500, you need to manually select the nodes.
Scene area
The Scene area can load and display imported 3D models. Users can import various format model files (such as FBX, GLTF, OBJ, etc.) and present them as realistic 3D objects in the Scene area. Users can freely browse and observe the model in the Scene area.
When loading and displaying imported 3D models in the Scene area, users can use the following methods to adjust the scene perspective:
Rotate the scene: Hold down the right mouse button at any position in the scene and move the mouse horizontally to rotate the scene in all directions for a comprehensive view of the model.
Pan the scene: To move the scene to the left, right, forward, or backward in the scene, click on a blank area in the scene, hold down the left mouse button, and drag the mouse to the left, right, or up and down on the screen. You can also hold down the mouse wheel and drag the mouse in the direction you want to pan.
Zoom the scene: To zoom in and out of the scene, you can use the scroll wheel on the mouse. Scroll up to zoom in and scroll down to zoom out.
Raise and lower the scene: To raise and lower the scene, hold down the Shift key and the left mouse button, and move up and down on the blank area of the scene. Move up to lower the scene and move down to raise the scene.
Model Attributes pane
The Model Attributes pane displays the current model’s performance on various platforms and its basic attribute information. At the same time, the attributes pane provides material editing functions that allow users to adjust and modify the model’s materials. Users can choose the type of material ball for the model (such as metal, wood, plastic, etc.), or customize the color, glossiness, roughness, and other attributes of the material to achieve the desired visual effect.
Available Platforms: The platform availability indicates the availability of models on different platforms. The size and complexity of the model’s structure can affect its performance on different platforms. When using DataMesh Importer to open a model, we will prompt you to see whether the DataMesh application on three platforms supports the model’s normal operation.
Polygons: The polygons refer to the number of polygons in the model. It is an important indicator for measuring model complexity and detail level. Higher polygon counts usually mean more details and more refined appearance but may also lead to performance burdens. In DataMesh Importer, when the polygon count of the model is too large, it may affect the use of the application and give corresponding prompts.
Vertices: The model vertices refer to the total number of vertices in the model. Vertices are the basic building blocks of the model, forming polygons by connecting vertices, thus forming the entire model. The vertices are related to the detail and complexity of the model. A high vertex may increase rendering and computational burdens. Therefore, when using DataMesh Importer, if the vertices of the model are too large, prompts may be given.
Textures: The texture count refers to the number of texture images applied to the model. Textures can give the model visual effects such as color, texture, and reflection. Increasing the number of textures may increase memory usage and render burdens. In DataMesh Importer, the textures can provide an evaluation of the model’s texture usage, allowing users to understand the details of the model.
Materials: The materials represent the number of materials used in the model. Materials define the characteristics of the model’s surface, such as color, transparency, metallicity, and smoothness. In DataMesh Importer, users can edit and adjust each material, including modifying properties such as color, transparency, metallicity, and smoothness. Understanding the number of materials in the model can help users understand the changes in appearance and detail control of the model.
Animation: When the model has built-in animation, users can click the Play button to play it.
After opening DataMesh Importer, click on the settings button in the toolbar, and select Account > Account Login from the drop-down menu to open the login page.
Following figure is the login interface:
The login interface supports following configuration:
Server List: You can switch to different servers, including China, Japan, and Singapore.
Private Deployment: If an enterprise has deployed a private server, users need to enter the exclusive service code for the private deployment when logging in.
Third-party Login: For more information about third-party login, please refer to the specific section on Third-party Login in the user manual.
Forgot Password: Click Forgot Password, open the server login page, and proceed with the password reset.
Regular login
To log in to DataMesh Importer, use your FactVerse account and password on the login interface.
1. Open the login interface of DataMesh Importer.
2. Select the correct server.
3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.
a. Click the private server icon . b. In the popup, enter the private server’s code, for example: “dtcs-sg”. c. Click Confirm to return to the login page.
4. Enter your account and password of FactVerse.
5. Click Sign in.
a. If you have only one account, you will be directly logged in. b. If you have multiple accounts, select the correct one from a list and you will be logged in.
Third-party login
DataMesh Importer supports using Third-party login methods for logging in, using Microsoft Entra ID, an identity and access management service, in order to enhance user security.
1. Open the login interface of DataMesh Importer.
2. Select the correct server.
3. (Optional) Private server deployment. If your company has deployed a private server, you need to configure the private server settings before logging in.
4. Click the Microsoft third-party login icon, and then enter the third-party account and password to log in.
SMS verification login
When a company enables the dual authentication of account passwords and SMS in FactVerse, users are required to undergo an SMS verification process when logging into the DataMesh client and FactVerse platform. Upon the first login to DataMesh Importer, you will encounter a prompt asking you to bind your mobile number for login verification. You will need to log in to the FactVerse platform to complete the binding.
Once your phone number is bound, the steps for using SMS verification are as follows:
1. Open the DataMesh Importer login interface
2. Select the correct server.
3. (Optional) Private server deployment. If your company has deployed a private server, you need to configure the private server settings before logging in.
4. Enter your FactVerse account and password, then click the Login button.
5. (Optional) Select the company your account belongs to: If you have multiple enterprise accounts, a list of company accounts will be displayed for you to choose from.
6. If the selected company has enabled dual authentication with FactVerse account passwords and SMS, the mobile phone you bound will receive a login verification code, valid for 5 minutes.
DataMesh Importer is a lightweight and efficient 3D model viewing tool that supports importing various formats of 3D model resources, including FBX, GLTF, OBJ, PLY, 3MF, and STL formats. With DataMesh Importer, you can intuitively understand the structure and basic attributes of the imported model, quickly preview the running effect of the model on different devices and adjust and edit the material properties of the model to optimize the rendering effect.
DataMesh Importer also supports one-click upload of models to the cloud resource library of DataMesh FactVerse, facilitating team collaboration and resource sharing. At the same time, when used in conjunction with DataMesh Studio, it can easily add 3D models to presentations, providing users with an efficient 3D content creation tool.
This chapter will provide a detailed overview of the user interface and numerous features of DataMesh One in training mode. You’ll learn how to use DataMesh One in training mode, including the processes to design learning and test tasks by instructors, as well as the procedures followed by students to complete these learning and test tasks.
User interface
Main interface
The main interface of DataMesh One in training mode is as follows:
My Tasks: The My Tasks page displays a list of all learning tasks and test tasks.
Course record: The Course record shows all learning records and test records, including time, task names, duration, and scores.
Settings
The Settings for the training mode interface are the same as those for the standard mode. For more details, refer to the section Settingsunder standard mode.
Resource positioning
The side buttons in the Position Mode interface support the following actions:
Complete positioning adjustments: Click the Complete button to exit Positioning Mode and enter the scene playback interface.
Adjust displacement and rotation precision: You can open the additional features panel by clicking the More Options button and then click the setting button to enter the Set click accuracy window for refining the precision of displacement and rotation.
QR code Positioning: Click the QR code Positioning button to use the scan-based positioning feature for a more accurate positioning of the scenario.
Gaze Mode: Click the gaze mode button to enter the Gaze Mode, adjust the scenario’s position by moving the camera’s field of view.
For more details, please refer to the section Resource positioning under standard mode.
Learning tasks
Task Status
Incomplete: Tasks that have not been started or have not been completed are considered incomplete.
Completed: Tasks that have been completed within the task period.
Expired: Tasks that exceed the task deadline are considered expired tasks.
Playback interface of the learning task
The side buttons in the playback interface of the learning task support the following actions:
Settings: Click the settings button to open the settings page for configuration.
View task timer: If the task has set a task duration, clicking the timer button will display the remaining time until the learning task ends. If the duration is exceeded, the task will automatically end.
View task score: Click the task score button to see the real-time task scoring situation.
Switch to position mode: Click the position mode button to enter the position mode for adjusting the scenario’s position.
Help: Provide concise operating instructions and relevant tips to help you better understand and use the features.
Interaction interface of the learning task
The interaction interface of the learning task appears as follows:
You will find the Skip, Demo, Reset, and Confirm buttons below the interaction interface:
Demo: Clicking the Demo button allows you to watch the correct way for roles to interact.
Reset: Clicking the Reset button restores the model to its state before being moved.
Confirm: After placing the interactive role in the correct position and rotating it to the proper angle, clicking the Confirm button completes the interaction.
Skip: Clicking the Skip button lets you directly skip the interaction task for the current scene.
The side buttons in the interaction scene of the learning task support the following actions:
Settings: Click the settings button to access the general settings.
View task timer: If the task has set a task duration, clicking the timer button will display the remaining time until the learning task ends. If the duration is exceeded, the task will automatically end.
View task score: Click the task score button to see the real-time task scoring situation.
Switch to position mode: Click the position mode button to enter position mode and adjust the position.
Switch interaction method: Click to choose the input type, turn the scene axis on or off, and adjust the scene opacity, and the scene scale ratio.
Help: Provide concise operating instructions and relevant tips to help you better understand and use the features.
Exam tasks
Task Status
Incomplete: Tasks that have not been started or have not been completed are categorized as incomplete tasks.
Completed: Tasks that have been completed within the task period by learners.
Expired: Tasks that exceed the task deadline are considered expired tasks.
Playback interface of the exam task
The side buttons in the playback interface of the exam task support the following actions:
Settings: Click the settings button to open the settings page for configuration.
View task timer: If the task has set a task duration, clicking the timer button will display the remaining time until the learning task ends. If the duration is exceeded, the task will automatically end.
View task score: Click the task score button to see the real-time task scoring situation.
Switch to position mode: Click the position mode button to enter the position mode for adjusting the scenario’s position.
Help: Provide concise operating instructions and relevant tips to help you better understand and use the features.
Interaction interface of the exam task
The interaction interface of the exam task appears as follows:
You will find the Reset, and Confirm buttons below the interaction interface:
Reset: Clicking the Reset button restores the model to its state before being moved.
Confirm: After placing the interactive element in the correct position and rotating it to the proper angle, clicking the Confirm button completes the interaction. Note: If there are multiple interactive elements in the scene, you need to click Confirm after completing each operation for the scoring to take effect.
The side buttons in the interaction scene of the learning task support the following actions:
Settings: Click the settings button to access the general settings.
View task timer: If the task has set a task duration, clicking the timer button will display the remaining time until the learning task ends. If the duration is exceeded, the task will automatically end.
View task score: Click the task score button to see the real-time task scoring situation.
Switch to position mode: Click the position mode button to enter position mode and adjust the position.
Switch interaction method: Click to choose the input type, turn the scene axis on or off, and adjust the scene opacity, and the scene scale ratio.
Help: Provide concise operating instructions and relevant tips to help you better understand and use the features.
Score interface
Course record
The Course record page displays the user’s name, custom avatar, learning records, and exam records.
Avatar: Users can upload a custom avatar on the FactVerse platform.
User Name: For external users, the name is displayed upon login; for internal users, the username is displayed.
Learning/Exam Records:
Time: Displayed in ascending order of completion time; format is yyyy.mm.dd hh:mm, for example, 2022.02.02 12:23.
Task Name: Displays the name of the learning or exam task.
Time Taken: Format is hh:mm:ss.
Score: Shows the final score for a task.
Training Process
Training preparation
Create task assessment scenarios
Training instructors use DataMesh Studio to create scenarios with task assessments. The following is the basic process for creating scenarios with task assessments:
1. Upload the required resources for scenario creation (e.g., models, images, PDF files, etc.) to the resource library of the FactVerse platform.
2. Log in to DataMesh Studio.
3. Add the necessary resources, such as models, to the scene.
4. Add linking actions or interactive positions to the roles.
5. Create assessment tasks, set scores for tasks, and bind interactive actions.
6. Set the scenario playback mode.
For more information about creating assessment scenarios with task assessments, you can refer to the Interaction Position and Assessment section in the DataMesh Studio user manual.
Training management
Training instructors need to perform the following training management tasks in the Learning Management module on the DataMesh FactVerse platform:
1. Create training groups
In the Learning Management module on the DataMesh FactVerse platform, create internal training groups and add learners to these groups. For more information, please refer to the section Create an internal training group in the DataMesh FactVerse User Manual.
2. Create courseware
Training instructors need to create training courseware and bind task assessment scenarios in the Learning Management module on the DataMesh FactVerse platform to provide learning resources for training content. For more information, please refer to the section on Create a new coursewarein the DataMesh FactVerse User Manual.
3. Create learning tasks
In the Learning Management module on the DataMesh FactVerse platform, set up learning tasks for the previously created training groups to guide learners in their learning and training. For more information, please refer to the section onCreate a new taskin the DataMesh FactVerse User Manual.
4. Create exam tasks
In the Learning Management module on the DataMesh FactVerse platform, create exam tasks for training groups to assess and evaluate learners. For more information, please refer to the section onCreate a new task in the DataMesh FactVerse User Manual.
Complete learning tasks
Trainees in the training group complete learning tasks in the training mode of DataMesh One. These tasks must be completed within the task’s validity period. The specific steps for completing a learning task are as follows:
1． Log in to the training mode of DataMesh One. 2． Click on My Tasks, select the learning task you want to complete, and enter the learning task interface.
3． Move your mobile device’s camera to recognize the surrounding environment.
4． After recognizing a flat surface, tap on an empty area on the screen to quickly place the model on the recognized surface.
5． Position Adjustment: After placing the model, enter the position adjustment mode. You can adjust the model’s position using the joystick, QR code positioning, or by reselecting the gaze mode. For more information, please refer to the section Resource positioning in the standard mode.
6． Adjust Translation and Rotation Accuracy (Optional): If you need to fine-tune the translation and rotation accuracy, you can open the additional options panel by clicking the button on the side of the position adjustment interface. Then, click the adjustment function button to enter the adjustment and click accuracy window for corresponding adjustments.
7． After completing the position adjustment, click the Complete button to start playing the scene. 8． When there are interactive tasks in the scene, click the “Demo” button after all the characters in the scene have finished playing to see how to perform the operation.
9． Click on the model you want to interact with in the scene; the selected model will be surrounded by a blue highlighted outline.
10． According to the task requirements, move the model to the designated area or rotate the model. If the model is within the automatic adsorption range and rotation angle error, it will automatically move to the correct position and rotate to the correct angle. Note: The interactive behavior in this scene does not affect the roles in the next scene. 11． Click Confirm after completing an action. Note: If there are multiple interactive actions in the scene, you need to click Confirm after completing each action for the scoring to take effect.
12． After completing all interactive actions in the current scene, click the arrow to turn the page and continue playing the next scene.
13． After all scenes have been played, the message “The task is Over” will be displayed.
14． Click the Next button to display the score results.
15． Click the Next button to exit the learning task. 16． Click Course record to view learning records.
Complete exam tasks
Trainees in the training group complete exam tasks in the training mode of DataMesh One. These tasks must be completed within the task’s validity period. The specific steps for completing an exam task are as follows:
1． Log in to the training mode of DataMesh One. 2． Click on the exam task you want to complete in My Tasks and enter the exam task interface.
3． Move your mobile device’s camera to recognize the surrounding environment.
4． After recognizing a flat surface, tap on an empty area on the screen to quickly place the model on the recognized surface.
5． Adjust Position: After placing the model, enter the position adjustment mode. You can adjust the model’s position using the joystick, QR code positioning, or by reselecting the gaze mode. For more information, please refer to the section Resource positioning in the standard mode. 6． Adjust Translation and Rotation Accuracy (Optional): If you need to fine-tune the translation and rotation accuracy, you can open the additional options panel by clicking the button on the side of the position adjustment interface. Then, click the adjustment function button to enter the adjustment and click accuracy window for corresponding adjustments.
7． After completing the position adjustment, click the Complete button to start playing the scene. 8． When there are interactive tasks within the scene, after all roles in the scene have finished playing, enter the interactive mode. 9． Click on the model you want to interact with in the scene; the selected model will be surrounded by a blue highlighted outline.
10． According to the task requirements, move the model to the designated area or rotate the model. If the model is within the automatic adsorption range and rotation angle error, it will automatically move to the correct position and rotate to the correct angle. Note: The interactive behavior in this scene does not affect the roles in the next scene.
11． Click Confirm after completing an action. Note: If there are multiple interactive actions in the scene, you need to click Confirm after completing each action.
12． After completing all interactive actions in the current scene, click the arrow to turn the page and continue playing the next scene.
13． After all scenes have been played, the message “The task is Over” will be displayed.
14． Click the Next button to display the exam score results.
15． Click the Next button to display whether the exam has been passed.
16． Click the Exit button to finish the exam task. 17． Click Course record to view exam records.
In this chapter, we’ll delve into the user interface of DataMesh One in standard mode, as well as the features it contains. You’ll learn how to navigate and use DataMesh One in standard mode, including resource positioning, resource editing, and opening resources and scenes.
User interface
Main interface
Resources
The Resources tab contains all the folder directories and resource files that your account has access to. These resource files include 3D models, scenarios, images, PDF files, and more. The resource type of each file is indicated in the top-right corner of its respective resource file.
The following figure shows the toolbar found in the Resources tab:
Events
The Event tab is used to manage all the events that the current account has access to. In the Event tab, you can browse the event list, view event details, participant information, and scenarios. If you are the creator of the event, you can also edit the event.
The following figure shows the toolbar of the Events tab:
Scenes
DataMesh One provides access to scene files that are created in FactVerse Designer. A user who has permissions for the scene function can view the scene interface directly in the application. The scene tab contains all folder directories and scene files that the current account has access to.
Settings
Clicking on the gear icon on the top right takes you to the application’s settings, where you can find general settings like account, browse mode, appearance, language, watermark, cache, and features such as uploading logs to our servers.
Browse Mode: If a user has the authority to toggle between the standard and training modes, the interface will default to the training mode. However, the user can adjust this default by altering the browsing mode settings. If the user have access to only one mode, this option to switch will not be displayed in the settings.
Language: DataMesh One supports Simplified Chinese, English, Japanese and Traditional Chinese.
Appearance: This option allows the user to swap between the light mode and dark mode interface. The default appearance is Light.
Rendering Quality: To adapt to different device performance, DataMesh One provides six different rendering quality options. Increasing the quality can optimize screen aliasing, ripple, and shadow effects.
Position Reference: The position reference setting aligns the content displayed by DataMesh One in positioning mode with the target object in the real world to achieve positioning effects.
Current Frame: Positioning is based on the current playback content of the scenario.
First Frame: Positioning is based on the first frame of the first scene of the scenario. For example, if A is added in the positioning mode of the DataMesh Studio scenario, A will be displayed for positioning under the initial positioning settings.
Watermark: Supports turning the watermark on/off. (Trial accounts and demo mode do not support turning off the watermark).
MR: This toggles the viewing modes between Mixed Reality (MR) and 3D. When using DataMesh One on mobile devices, MR mode is enabled by default, and you can switch to 3D viewing mode by turning off the MR switch in the settings. When using DataMesh One on a PC, only 3D mode is supported, and MR mode is not supported.
Cache: This allows you to clear the cache of either the entire system or resources that have not been accessed in thirty days. Doing this is a good way to increase performance when necessary.
Sort List: List Sorting: The list sorting function allows users to sort resources, scenes, and events according to different criteria, making it easier to find and manage resources, scenes, and events.
Help: Interface elements that assist users in understanding specific features or completing particular tasks. They typically appear in the form of prompts, explanations, or examples to provide guidance and assistance with user operations. You can enable or disable the feature to control the display of help information in DataMesh One.
Logs: DataMesh One supports uploading the latest seven logs.
Log out: Click the Logout button to log out of the account and return to the login page.
Open resources
In the Standard Mode of DataMesh One, you can view 3D models, 2D resources, scenarios, and other content in the Resources tab.
Before opening resources, please make sure your device is connected to a stable network, otherwise it might take a while for larger 3D models to load.
In the Mixed Reality (MR) viewing mode, resources can be placed and viewed through your device’s camera and can be moved via our application’s Position Mode. For more information, please refer to our Resource positioningarticle.
In 3D viewing mode, resources will automatically appear in front of your view. You can rotate, zoom, and move the resources using gestures or joysticks to better observe and experience. If you need to edit the position, rotation angle, scale, or transparency of a resource, you can enter Edit mode to perform the operation. For more information, please refer to Resource editing.
3D models
Please follow the following steps to open 3D models from the resources list:
1. In the Resources interface, navigate to the folder containing the 3D models. If you know the name of the file, you can search for it with the search bar at the top.
2. Click on the 3D model file you want to view in the resource list, which will start the downloading process.
In MR viewing mode, the model center is placed at (0, 0, 0) and you will enter position mode. Move your mobile device and click on the blank space in the screen to place the model.
In 3D viewing mode, the model will automatically appear in front of your view after it is loaded.
3. If you need to adjust the position of a model that has already been placed, you can click the position button to reset the position. For more information, please refer to Resource positioning.
4. If you need to adjust the position, rotation angle, scale, or transparency of the model, you can enter Edit mode for editing. For more information, please refer to Resource editing.
2D resources
The standard mode of DataMesh One also supports opening 2D resources such as images, videos, and PDF files. The opening process is the same as for 3D models, and they start out in the environment, but can be incorporated into the HUD (Head-up Display) for convenient viewing and operation by the user.
Image
After opening an image, you can minimize, hide, and view the image in full screen.
: Minimize. Clicking on this option will minimize the resource and fix it in the upper right corner of the screen for convenient viewing at any time.
: Hide. Clicking on the Hide icon will hide the image. After hiding the image, a Show icon will appear. Clicking on the Show icon, the image will be displayed again.
: View in full screen.
: Unminimize. Select the image in the minimized state in the upper right corner of the screen, and then click to unminimize the image.
Video
After selecting a video, you can use the control buttons to play, pause, fast forward, rewind, adjust the progress bar, and control the volume.
After clicking on the minimize icon, the video will minimize and be fixed to the upper right corner of the screen. You can click on the minimized video and use the control buttons to play, pause, fast forward, rewind, and adjust the video progress. You can also unminimize the video or watch the video in full screen.
PDF
The standard mode supports operations such as page turning, minimizing, and hiding PDF files.
Clicking the minimize icon will minimize the PDF file and fix it to the upper right corner of the screen. You can click on the minimized PDF file and choose to turn pages, deselect minimize, or read in full screen mode.
Scenario
Scenario playbacks are one of the highlights of our application. Through scenarios, users can create and view complex tutorials, training guides for workers, and much more. Here’s how to open scenarios in the standard mode of DataMesh One.
Steps
1. Click on the folder where the scenario is located in the Resources tab.
2. Click on the scenario you want to play, which will start the downloading process.
3. After opening the scenario, you can manipulate the properties and position of the models and other resources using the Position and Edit Modes. For more information, please refer to the Resource Positioning and Resource Editing articles.
4. Click on the Stage List button to open a list of all the stages found in the scenario. Selecting one of the stages will cause the object to change states into the one that you selected.
Scan QR code to open resources
Standard mode also supports opening resources by scanning the code. Here are the steps:
1. On FactVerse, go to the Resources page in the Digital Assets module, navigate to the model or scenario file you want to view and open it.
2. Click on the QR icon at the top right. Users with permission to access the corresponding directory can use the standard mode of DataMesh One to scan the QR code, open and view the resource quickly.
In the standard mode of DataMesh One, click on the scan button , and scan the QR code generated in the previous step, which will then load and open the model or scenario.
View resource information
In the standard mode of DataMesh One, an information pane is provided to help users view resource information and better understand the content in the scene. Through the information pane, users can obtain the following resource-related information:
Resource name: Displays the name of the resource, helping users quickly identify the selected resource.
Model properties: Provides related information such as model attributes and node attributes. The information contained within these properties can help users understand the characteristics and structure of the model.
Engineering Information: Engineering information in the BIM file properties includes display options, identity data, constraints, dimensions, and other metadata. These details are used to describe elements in architectural design, such as door types. Display options can define the appearance of doors, such as color and line styles. Identity data can include the name, number, and material information of the door, used for annotations and identification. Constraints ensure the correct placement of doors within walls and alignment with other elements. Dimensions represent the width, height, and thickness of the door, providing size-related information.
Steps
1. In the case of opening a resource or playing an event, select the resource to be viewed in the scene.
2. Press the Info button on the right side to expand the resource information pane.
3. In the resource information pane contains more details, such as model name and node name.
4. To collapse the resource information pane, press the Info button again.
Resource positioning
In MR mode, you can accurately position resources, including adjustments for location, distance, height, and angle, to ensure that resources are precisely placed where needed.
Joystick controls
Utilizing the touchpad joystick controls can adjust the position, distance, height, and angle of resources with a greater degree of accuracy and precision.
Steps
1. After completing the placement of resources, you can click on the Position button .
2. After entering Position mode, the touchpad joystick controls are used by default.
3. (Optional) Set the precision for each displacement or rotation in the joystick adjustment:
a. Click the More functions button to open the More functions panel.
b. Click the Adjust function button to open the Set click accuracy window.
Move: Adjusts the unit size of each movement. The default unit is 2 centimeters (cm)millimeters (mm), but users can change the number and select different unit types such as millimeters (mm), decimeters (dm), or meters (m). By adjusting the unit size, users can achieve precise position adjustments.
Rotate: Users can adjust the angle of each rotation. The default angle is 3 degrees (3˚), but users have the flexibility to customize the rotation angle for more precise adjustments.
c. Set the movement sensitivity or rotation precision according to specific requirements, then click Apply to complete the setup.
4. When using the touchpad joystick controls, in addition to using the left joystick to control the resource’s horizontal movement, you can also use the right joystick to control the resource’s vertical movement and orientation angle.
5. Click to complete the resource positioning.
Gaze mode
In Gaze Mode, resources follow the center of the device’s camera and can be placed by tapping on the screen when the white grid is located at the desired location. This allows for faster placement of resources in a mixed reality space.
When opening a resource, you will enter Gaze Mode by default. After placing the resource, if you need to place a virtual object using the camera again, you can follow these steps:
1. Select the Position button to enter the position mode.
2. Select the Gaze Mode button to enter Gaze mode.
3. After entering Gaze Mode, move the camera when the white grid is at the desired location, then tap anywhere on the screen to place the resource.
4. Click on the button to complete positioning.
QR code positioning
By scanning the QR code while positioning virtual objects, you can place them into the mixed reality world with more precision, ensuring that they correspond to the real-world physical environment. For example, in an exhibition, you may need to precisely place a virtual exhibit in the same location as a real exhibit, which enables visitors to observe the virtual exhibit’s effect in the real environment. Note: QR code positioning only supports object positioning in the scenario.
The steps for scanning the code to position are as follows:
1. On FactVerse, go to the Resource page in the Digital Twin module and find the scenario file you need.
2. Open the Resource details window and download the locating code.
3. Place the downloaded QR code in the target position.
4. Open scenario in the resources list on DataMesh One.
5. Click on the Position button to enter position mode.
6. Click button to scan QR code.
7. Scan the QR code placed in the target position to complete scenario positioning.
8. Click on to complete resource positioning.
Resource editing
To facilitate playback and viewing experience, the edit mode can be used to adjust the position, size, rotation angle, and transparency of models, sub-objects, tools, and other resource content in the scenario.
Edit mode setting
1. After opening the resource, you can enter Edit mode by clicking on the Edit button .
2. Then, press the Settings button to open Edit Mode Settings.
Input type: There are two input types in edit mode, Touchscreen Gesture and Touchscreen Joystick. You can switch between the two types here.
Dimensional Movement: This setting is unique to touchscreen gesture inputs. Dimensional Movement allows users to move virtual objects in straight lines across the three dimensions (X, Y, and Z) for extra precision. Three cones will appear around an object’s central point, each corresponding to an axis, and by pressing and dragging a cone you will be able to move objects across only that axis.
Resources properties: In this section, you can adjust the opacity and zoom ratio of the resource, as well as further adjust the accuracy through the settings of advanced options.
Gesture operation
You can adjust the position, size, and rotation angle of objects or sub-objects by using touchscreen gestures. This input type is more flexible, quick, and intuitive than using the joysticks, and is designed for devices that have a touchscreen.
Here are the detailed steps for using touchscreen gestures on a mobile device:
1. After completing the placement of a resource, press the Edit icon to enter Edit Mode.
2. Press the settings button to enter Edit Mode Settings and select the Touchscreen Gesture.
3. Select the object to be edited, and a blue highlight border will appear around the object. Use gesture controls to move, scale, and rotate the object. a) Movement: Press and drag anywhere inside the border to move the object. b) Resizing: Press and hold any corner of the border, which will create a blue square, then drag the square to increase or decrease the size of the object.
c) Rotation: Press and hold the center of any of the lines that make up the border to create a blue sphere, then drag the sphere to rotate the object.
Joystick operation
Utilizing the touchpad joystick controls can more accurately adjust the position, distance, height, and angle of resources with a greater degree of accuracy and precision.
Steps:
1. After completing the placement of the resource, click on the Edit button to enter the edit mode.
2. After entering the edit mode, select Touchscreen Joystick. You can also adjust the sensitivity, rotation angle, and other parameters of the joystick by adjusting the Movement Sensitivity.
3. Click to select the object to be edited, and a blue highlight border will appear around the object.
4. Use the joystick to move and horizontally rotate the object.
Open scene files
When you have the necessary permissions for the scene function in your enterprise, you can open scene files accessible to you in DataMesh One using the following steps in MR mode:
The steps to open a scene file in MR mode are as follows:
1. On the main interface, click on the Scene tab to enter the scene interface.
2. In the Scene interface, browse and open the folder containing the target scene file. Scroll through the folder’s contents using the dropdown scrollbar, locate the scene file you want to play, and click to open the scene file.
3. After opening the scene file, move the camera (field of view) to recognize the environment and automatically place resources.
4. You can click the positioning button to enter the joystick adjustment mode.
5. In joystick adjustment mode, or by switching to gaze mode, adjust the position of the scene. Once the resource placement is complete, click to finish scene position adjustment. For more information on resource positioning, please refer to the relevant instructions for Resource positioning.
6. After completing the scene position adjustment, enter scene playback mode. You can move the camera to roam the entire scene.
Events
The Events function in the standard mode of DataMesh One provides users with rich AR experience and collaboration functions, allowing users to create and participate in immersive AR events.
Here is a description of the Events function:
New Event: With the standard mode of DataMesh One, users can create new virtual reality events. When creating a new event, users can set basic information such as the name and valid date of the event and set the scenario for the AR scene. The scenario defines the scenes, roles, actions, and interaction processes in the event.
Event management: As the creator and owner of the event, users can manage the event. This includes deleting events, changing event scenarios, and more. The event management function enables users to flexibly control and customize the event.
Play event scenarios: The event creator can guide the event by playing the scenario of the event. During the event, the event creator can gradually play the scenes and guide participants to complete various tasks and experiences according to the scenario.
Participate in events: The standard mode of DataMesh One allows users to participate in virtual reality events created by others. Users can select events of interest from the event list and enter the event scene through devices such as HoloLens, mobile phones, and tablets. Event participants can watch the scenario, but do not have permission to play the scenario. This provides convenience for observing, learning, and sharing events.
Create events
Users with collaboration creation permissions can create events.
Steps
1. Click the add button in the event list to go to the New Event interface.
2. In the New Event interface, fill in the Event Name (default format yyyy-mm-dd hh:mm: ss) and select the event’s Validity Period. 3. Click the Create button to open the event setting interface. 4. In the event setting interface, click Add button.
5. Open the folder where the scenario is located, select the scenario, and click Save to add the scenario to the event.
6. After the scenario loading is completed, the event is created successfully.
Change event scenarios
The steps to change event scenarios are as follows:
Note: Only the owner of the event has permission to edit the event.
1. Click on the event in the event list to enter the event details page.
2. On the event details page, click the Change Scenario button.
3. Select one scenario to replace the existing scenario.
4. After editing is complete, click the “<” button in the upper left corner to exit the event details page and return to the event list page.
Play events
To play a created scenario in the event details page, follow these steps:
1. Select the event to be played in the event list and enter the event details page.
2. Wait for the models in the event to download and load.
3. After all participants are ready, the creator of the event can click the Play button to start playing the scenario.
4. Place the models and adjust their position and orientation to ensure that the scenario can be played in the correct scene. For more information on placing models and adjusting their position, please refer to the Resource Positioning.
5. Click the Stage List button to open the scenario’s Stage List. Click the scene name in the list to play the scene on a single page.
6. After the scenario is finished playing, click the “<” button in the upper left corner to exit the event.
Note: During the collaborative event demo, if the host exits the event, all participants and the host will return to the event preparation page. If a participant exits the event while the host remains, the participant will directly return to the event interface.
Delete events
The creator or owner of the event can delete it. The specific steps to delete an event are as follows:
1. Log in to the FactVerse platform.
2. Go to Collaboration > Event Management page.
3. In the event list, find the event you want to delete and click the corresponding delete button .
4. In the prompt window, click Confirm to confirm the deletion of the event.
Other functions
Adjust scene viewing angle
When browsing in 3D mode, you can adjust the viewing angle by using the following methods:
On PC:
Rotate the scene: Hold down the right mouse button at any position in the scene, then move the mouse left or right to horizontally rotate the scene for a full view of the model.
Pan the scene: To move left, right, forward, or backward in the scene, click on a blank space in the scene, hold down the left mouse button, and drag the mouse to the left or right of the screen or up and down on the screen. You can also hold down the mouse wheel and drag the mouse in the direction you want to pan. This operation can avoid selecting any characters with the left mouse button, and the wheel can only be used to drag the scene.
Zoom in and out of the scene: To zoom in and out of the scene, you can use the mouse wheel button, scroll up to zoom in, and scroll down to zoom out.
Raise and lower the scene: To raise and lower the scene, you can hold down the Shift key and the left mouse button and move up or down on a blank space in the scene to lower or raise the scene.
On mobile devices:
Rotate the scene: Tap any position in the scene with your finger, then use a single finger to swipe horizontally to rotate the scene.
Gesture zooming: Through gestures, pinch or spread with two fingers in space to zoom in or out of the scene.
Pan the scene: You can pan the scene by sliding two fingers on the screen.
Offline mode
When the network condition is poor, after a period of network request, an Offline Mode button option will appear. You can switch to Offline Mode to view previously downloaded models or scenarios and play and use them normally.
After clicking on Offline Mode, the resource list will display all local content. Note: Search, filter, and scan functions are not supported in offline mode.
When the internet is connected, you can choose Click to reconnect to switch back to online mode.
Language: You can switch the interface language to Simplified Chinese, English, Japanese, and Traditional Chinese.
Server: This changes which server you connect to. Make sure that the server you connect to is the same one that your organization uses.
: Private Server icon. This allows you to enter a private server, which requires a password to access.
Demo: It allows users to watch built-in models, scenarios, and events provided by DataMesh as a guest.
QR code login: For more details, please refer to our QR code login article.
Third-party login: For more details, please refer to our Third-party login article.
Note: After successful login, users with standard mode permissions can only enter the standard mode interface. Users with training mode permissions can only enter the training mode interface. Users with both mode permissions by default enter the training mode interface, and users can switch the browsing mode in Settings.
Regular login
On the login interface of DataMesh One, use your account and password to log in.
Steps
1. Open the Login interface of DataMesh One.
2. Select the correct language and server.
3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.
a) Click the Private server icon . b) In the popup, enter the private server’s code.
c) Click Confirm to return to the login page. The server’s name on the login page should be displayed as the code you just entered.
4. Enter your FactVerse account and password.
5. Click the Login button.
a. If you have only one account, you will be directly logged in.
b. If you have multiple accounts, select the correct one from a list and you will be logged in.
Third-party login
DataMesh One supports using Third-party login methods for logging in, using Microsoft Entra ID, an identity and access management service, in order to enhance user security.
Steps
1. Open the Login interface of DataMesh One.
2. Select the correct language and server.
3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.
a) Click the Private server icon . b) In the popup, enter the private server’s code.
c) Click Confirm to return to the login page. The server’s name on the login page should be displayed as the code you just entered.
4. Click on the third-party login icon , and confirm the pop-up message.
5. Enter your Microsoft account and password to log in.
QR code login
Using the QR code login feature provided by DataMesh FactVerse, quickly log in to your account on DataMesh One.
Steps
1. Open the Login interface of DataMesh One.
2. Select the correct language and server.
3. If your organization has a private server, follow these directions below. Otherwise, skip to step 4.
a) Click the Private server icon . b) In the popup, enter the private server’s code.
c) Click Confirm to return to the login page. The server’s name on the login page should be displayed as the code you just entered.
4. Click on the scan code icon , and a scanning frame will appear.
5. Log in to FactVerse, click on the username in the top navigation bar, and select QR code login in the account function menu. Note: Please select the same server on both the One side and the FactVerse platform. For example, if you have chosen China on the One side, ensure that you log in to the FactVerse platform using the correct URL: https://dcs.datamesh.com.cn/ to obtain the corresponding QR code.
6. The system will automatically generate a QR code that refreshes at intervals.
7. Use DataMesh One to scan the QR code generated on the FactVerse platform in Step 6. After successfully scanning, a prompt window will appear.
8. In the QR code login confirmation window on the FactVerse platform, click Confirm to complete the login.
SMS verification login
When a company enables the dual authentication of FactVerse accounts using both passwords and SMS, users logging into the DataMesh client and the FactVerse platform need to undergo SMS verification.
Upon your initial login to DataMesh One, a prompt to bind your mobile phone number will appear. You need to log in to the FactVerse platform to bind a mobile phone number for login verification. For detailed instructions on how to bind your phone number, please refer to the FactVerse User Manual.
Once your phone number is bound, the steps for using SMS verification to log in on DataMesh One are as follows:
1. Open the DataMesh One login interface.
2. Choose the language and the server associated with your company.
3. Private deployment settings (optional): If your company uses a privately deployed server, you need to set an exclusive service code before logging in.
4. Enter your FactVerse account and password, then click the Login button.
5. Choose the company your account belongs to (optional): If you have multiple enterprise accounts, a list of company accounts will be displayed for you to choose from.
6. If the selected company has enabled dual authentication with FactVerse account passwords and SMS, the mobile phone you bound will receive a login verification code, valid for 5 minutes.
7. Enter the code to access the main interface and complete the login process.
2. DataMesh One 6.1 and earlier versions have been tested on HoloLens devices. Later versions have not been fully tested and may have unknown issues.
Account Permission
Standard mode
To view resources in the standard mode of DataMesh One, you need to first obtain the corresponding permissions. You can contact your administrator to assign standard mode permissions in DataMesh One. If you want to view the scene content, you also need to obtain the permissions for FactVerse Designer.
Training mode
When conducting training tasks in the Training Mode of DataMesh One., it is important to ensure that both training instructors and learners have the appropriate permissions. The following are the required permission settings for training:
1. Training instructor permissions:
Enterprise administrators should create training instructor accounts and designate corresponding roles on the FactVerse platform.
Grant the following permissions to training instructors:
Permissions to use the Digital Assets and Learning Management
Licenses for FactVerse, DataMesh Studio, and Training Mode of DataMesh One.
2. Learner permissions:
Learners need to have FactVerse accounts. If they do not have accounts, administrators should add their FactVerse accounts for them.
Administrators need to allocate Training mode licenses of DataMesh One to learners.
DataMesh One is an application that can be used in conjunction with DataMesh Studio and FactVerse platform. It can play immersive 3D data scenarios and display vivid scenes on virtual reality devices, smartphones, tablets, and other devices. In addition, multiple users can share the same 3D space simultaneously, making it convenient for collaborative learning and communication. Our application also provides convenient interactive operations, such as gestures and joysticks, which allow users to interact more organically with models in the 3D space. Moreover, it can also be used for Extended Reality (XR) training, providing robust technical support for enterprise education, training, and online learning, addressing issues such as high training costs, limited methods, and poor outcomes. To enrich users’ learning and communication methods, DataMesh One provides two browsing modes, namely Standard Mode and Training Mode.
Standard Mode
In Standard Mode, users can freely browse various resources and scene content, and can also participate in multi-person collaborative activities, making learning and communication easy. Here are some of the main operations you can perform in Standard Mode:
View resources: In the Standard Mode, you can view 2D, 3D resources and scenarios. For more details, please refer to the section Open resources.
View scenes: In the Standard Mode, you can view scenes created in FactVerse Designer. For more details, please refer to the section Open scene files.
Collaboration events: Standard Mode supports multi-device, multi-person collaboration events. For more details, please refer to the section Events.
Training Mode
In Training Mode, users can not only complete learning tasks and assessment tasks, but also experience a more immersive learning environment through XR-based technology, thereby improving learning efficiency and training effectiveness. This mode not only focuses on knowledge transfer, but also emphasizes practical operations and skill development, providing users with a more comprehensive training experience.
Typical application scenario
Here are some examples of typical application scenarios under the Training Mode of DataMesh One.
New employee on-boarding training: Training Mode can be used to provide pre-job training for new employees. Through virtual reality technology, employees can engage in simulated operations, scenario rehearsals, and knowledge acquisition to become familiar with their work environment, workflow, and required skills in advance.
On-the-job training: Training Mode is suitable for ongoing education and training of existing employees. Through virtual reality experiences and interactive learning, employees can enhance their professional knowledge and skills, understand the latest work processes, operational standards, and best practices.
Individual assessment: Training Mode supports individual assessment. During individual assessments, employees can undergo evaluations in a virtual environment, assessing their comprehension and application abilities related to specific knowledge and skills.
Lifelong learning tracking: Training Mode can be used for skill certification and lifelong learning tracking. Through online learning and virtual practice, employees can obtain relevant skill certificates and certifications, recording personal skill growth and career development trajectory.
Return on investment (ROI) for corporate training: Training Mode can help companies enhance the ROI of their training investments. Through virtual training and online learning, it is possible to reduce training costs, enhance training effectiveness and efficiency, mitigate real-world operational risks, and provide companies with data analysis and assessment reports, assisting in optimizing training plans and resource allocation.
User roles
Instructor
Scenario-based course import, configuration, and distribution: Instructors can import and configure scenarios for various training courses, including scene settings, instructional content, tasks, etc., and distribute them to learners for study. For more details, please refer to Training preparation.
Learner
Course learning: Learners can use Training Mode to study various training courses, including virtual practice, scenario experiences, knowledge acquisition, etc. For more details, please refer to Complete learning tasks.
Test and Assessment: Learners can carry out assessment tests through Training Mode to verify their learning outcomes. For more details, please refer to Complete exam tasks.
Learning data dashboard: Learners can view their own learning data, learning progress, grades, and other information to understand their personal learning status. For more details, please refer to Course record.
HR or TD (Human Resources or Training and Development Department)
Employee Course record: HR or TD can track employees’ career development and learning journey, record and manage employees’ training and certification status, and provide support and guidance for employees’ career paths. For more details, please refer to Course record.
Users can create annotation tasks in the Acceptance of Work module and associate them with architectural scenes. They can view, export, and delete annotation records for that architectural scene.
Create annotation tasks
The steps to create a new annotation task are as follows:
1. On the Annotation Task Management page, click the New button to open a new window.
2. In the New window, fill in the task name and associate it with an architectural scene.
3. Click the Confirm button to complete the creation of the annotation task.
View annotation task record
On the Annotation Task Management page, click the details button corresponding to the annotation task you want to view to open the Annotations page for that task.
On the Annotations page, you can view all the annotations for that architectural scene, sorted by default in descending order of creation time. Clicking on the attachment name allows you to view attachment images.
Filter annotations: Click the filter button on the Annotations page to filter records by creator, creation time, or category.
Exporting annotations: Click the Export Excel button on the Annotations page to export all annotations.
Delete annotations: On the Annotations page, click the delete button corresponding to the annotation you want to delete, and click Confirm in the pop-up window.
in the toolbar, and select Account > Account Login from the drop-down menu to open the login page.
.
and then click the setting button 
to enter the Set click accuracy window for refining the precision of displacement and rotation.
to use the scan-based positioning feature for a more accurate positioning of the scenario.
to enter the Gaze Mode, adjust the scenario’s position by moving the camera’s field of view.
to open the settings page for configuration.
will display the remaining time until the learning task ends. If the duration is exceeded, the task will automatically end.
to see the real-time task scoring situation.
to enter the position mode for adjusting the scenario’s position.
to enter the position mode for adjusting the scenario’s position.
to start playing the scene.
to enter the adjustment and click accuracy window for corresponding adjustments.
on the top right takes you to the application’s settings, where you can find general settings like account, browse mode, appearance, language, watermark, cache, and features such as uploading logs to our servers.
to reset the position. For more information, please refer to 
: Minimize. Clicking on this option will minimize the resource and fix it in the upper right corner of the screen for convenient viewing at any time.
: Hide. Clicking on the Hide icon will hide the image. After hiding the image, a Show icon will appear. Clicking on the Show icon, the image will be displayed again.
: View in full screen.
: Unminimize. Select the image in the minimized state in the upper right corner of the screen, and then click to unminimize the image.
to open a list of all the stages found in the scenario. Selecting one of the stages will cause the object to change states into the one that you selected.
, and scan the QR code generated in the previous step, which will then load and open the model or scenario.
on the right side to expand the resource information pane.
to enter Gaze mode.
.
in the event list to go to the New Event interface.
.
: Private Server icon. This allows you to enter a private server, which requires a password to access.
, and confirm the pop-up message.
, and a scanning frame will appear.
on the Annotations page to filter records by creator, creation time, or category.
