FVS Unity Component

This document is applicable to users who have installed the FineVis Data Visualization plugin to learn the plugin functions.

Version

Application Scenario

Unity is a real-time 3D development platform. To enhance user experience with more immersive 3D effects, FVS has integrated the Unity component developed by Unity, allowing you to import, edit, save, and preview Unity resources.

The Unity component can extend the FVS 3D function while seamlessly integrating with the existing FVS design. For example, you can configure the Unity component with FVS data sources, or customize interaction events (such as linkage, jump, and parameter passing).

Note: 

1. Only the Unity versions released after 2021.3 are supported.

2. The function is not supported on mobile terminals.

Before utilizing the Unity component, you first need to develop the 3D scene function in Unity, export the WebGL resource package, and then upload the resource package to FVS.

Note:

1. In FVS, the configurations related to Unity scenes, data, and styles are determined and automatically generated by the resources themselves. FVS supports modifications only after the configuration files have been parsed.

2. Unity scene development is based on the FVS-Unity-SDK. For details, see FVS-Unity-SDK Help Document.

This document provides three sample Unity resource packages.

• Relatively small file (5 M) with simple resources: Build1.zip

• Relatively big file (76 M) with impressive resources: 

• Relatively big file (122 M) with multi-scene resources (applicable to FineReport with the FVS plugin of V1.8.2 and later versions): 

You do not need to unzip the packages after download.

1. Choose File > New FineVis Visualization Dashboard in the upper left corner of the designer to create a dashboard. You can customize the dashboard name and canvas size, as shown in the following figure. 

Choose 3D > Unity to add the Unity component to the canvas. Choose Content > Edit Component in the right configuration area to enter the Unity scene editing page.

Uploading the Unity Resource

When you enter the Unity component editing page for the first time, you will be prompted to upload the Unity resource before proceeding with configurations.

Click Upload Unity Resource. In this example, upload Unity Resource of the Exhibition Hall.zip mentioned in section "Unity Resources Preparation." Wait for a moment and the Unity scene will be loaded, as shown in the following figure.

Scene Configuration

After the Unity resources are parsed, the Scene panel exists by default and inherently includes the Refresh Unity Setting and Replace Unity functions.

If the resources contain scene-related configurations, the corresponding configuration items will appear on the Scene panel.

1. Refreshing the Unity Setting

After you click Refresh Unity Setting, all configurations modified in FVS will be restored to the original resource setting, except for the bound data and adjusted viewing angles.

2. Unity Multi-Scene Switching

In Unity, you can create multiple scenes and package them into a single Unity resource, where each scene has its own data, styles, or event setting.

In FineReport with the FVS plugin of V1.8.2 and later versions, if the imported resource package contains multiple scenes, the FVS Unity component can recognize and allow you to switch between these scenes. Upon switch, the configuration panel will be updated accordingly to match the current scene, as shown in the following figure.

3. Replacing the Unity Resource

You can click Replace Unity, select another Unity resource package, and click Select to replace the current Unity resource.

When you replace resources, the Unity component will parse the configuration file of the new resource and update the configuration items accordingly.

Data Configuration

When FVS parses Unity resources, it will automatically generate data layers and field names based on the data configuration information.

You cannot create or delete data layers in FVS, but can set data sources and bind data.

Take Unity Resource of the Exhibition Hall.zip uploaded in section "Uploading the Unity Resource" for example. The following figure shows the Data configuration panel of the Unity resource.

Note: When creating datasets in FVS, note that the model name is defined by the Unity resource. For example, the Hall Name field must be identical to the model name in the Unity resource.

Note: If the Unity resource has style attribute setting, a Style configuration panel will be automatically created as well.

1. The Unity component supports six types of click events via FVS component interaction attributes, enabling interactions such as component linkage and page jump.

Take Unity Resource of the Exhibition Hall.zip uploaded in section "Uploading the Unity Resource" for example. When you add a click event for the Unity component, two event objects are available, namely Hall Click and Camera Click.

Once you have selected the event object, you can select the event type and make configurations.

Note: The event object here does not require data layer configuration, but only relies on the setting of the Unity resource.

2. If the Unity resource contains configurable animations, you can set corresponding 3D component animation click events for other components to trigger the animation effects of the Unity component.