3D Scene Model Data Application

Version

Note:

To use this function, you need to purchase the FVS 3D Component - Scene Twin function point. For details, you can contact FanRuan sales personnel.

Application Scenario

Models in 3D scenes often need to be combined with data to reflect the corresponding changes in real-world scenarios in real time. In version V4.1.0, a new event setting was added under Scene Event > Model Data Application for the FVS custom 3D models. The model data application event allows you to set functions for showing/hiding the model and model animations.

• Through the Show/Hide function, you can switch the display status of the model in real time to reflect real-world changes in entity counts, such as the number of goods on a warehouse rack or the construction status of a building floor in a park.

• Through the model animation function, you can utilize data signals to drive the playback of model animations and simulate the working status of equipment, thereby achieving a more intuitive and dynamic scene presentation.

Model Data Application Event Adding

1. You can enter the custom 3D scene component editing page, choose Model > Scene Event > Model Data Application, click Add Model Data Application Event to enter the event setting panel.

2. The event setting includes Event Name and Data Source settings.

• Event Name: You can set the event name, which is Model Data Application Event X by default. You can customize the event name, but empty names are not supported.

• Data Source: You can select Dataset or WebSocket. The following table describes the details.

Data Source	Illustration	Description
Dataset		You can select template datasets and server datasets that have been added to the current template.  Update Frequency: You need to set the frequency for updating. The minimum and default frequency is 5s.
WebSocket		Data Source Configuration: You need to set the corresponding data source name, ID, and URL for WebSocket. Note: WebSocket supports URL reuse. Data Field: You need to predefine the field key used for driving, and add multiple data fields. Note: For details about the WebSocket data push format requirements, see 3D Data Source.

3. You can add multiple Model Data Application events, which will be executed in sequence from top to bottom in the list. You can re-edit, rename, copy, delete, and disable the events.

Execution Adding

After setting the data source, you can add specific execution actions, which support the setting for showing/hiding the model and animation playback.

Show/Hide

The Show/Hide execution action allows you to dynamically display/hide the specified model according to data.

Note:

For models requiring the showing and hiding control, you are advised to create the models as individual GLB models. For the multi-level model structure, you are advised to set the parent node as an empty node.

You can set Execution Condition and Execution. The following table describes details.

Model Animation

The Model Animation execution action allows you to dynamically control the animation playback status of the specified model according to the data.

You can set Execution Condition and Execution. The following table describes details.

Configuration		Description
Execution Condition		Same as that for Show/Hide.
Execution	Action Name	Same as that for Show/Hide.
	Target Object	The model to which the event applies supports Data Specification and Manual Specification. Manual Specification: You need to select models manually from the model list, and both parameter models and common models are supported. Note: You can select animations from all existing models in the model list. Wireframe animations are not supported. Data Specification: You need to match the models based on the data in the data source. You can select the fields in the selected dataset. Note: Animation Name can be empty. In this case, the first animation in the model animation list will be played by default.
	Playback Command	You can set Start Playback, Pause Playback, or Exit Playback.
	Command Timing	This option appears only when Play Command is set to Start Playback. You can set Play at Once or Delay Animation.
	Playback Method	This option appears only when Play Command is set to Start Playback. You can set Single Playback or Loop Playback.

For details, you can download the template: Intelligent Warehousing and Logistics Demo

Data Preparation

The dataset must contain at least the following fields: Model Name, Animation Name, and the condition judgment field.

This example takes rack animations as a demonstration. The in/out retrieval motion Animation has been added to the model. When Motion Status of the rack is Running, the animation is played; otherwise, it remains paused.

Model Preparation

The retrieval arm of the rack can be created as an individual GLB model, and a retrieval animation has been added to it.

Model Data Application Event Adding

1. You can enter the custom 3D scene component editing page, choose Model > Scene Event > Model Data Application, click Add Model Data Application to enter the event setting panel.

2. Set Event Name to Rack Motion Status, set Data Source to Dataset, and choose Rack Motion Status from the drop-down list.

3. Choose Add Execution > Model Animation.

Add two executions separately. The following figure shows the specific setting.

• Running: When the Motion Status field is equal to Running, the corresponding model needs to play the running animation.

• Suspension: When the Motion Status field is equal to Suspend, the corresponding model needs to pause the running animation.

Effect Display