FVS Unity Component

  • Last update:January 10, 2025
  • Overview

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

    Version

    Report Server Version
    Plugin VersionFunctional Change

    11.0.6

    V1.6.0

    Added the Unity component in 3D components, allowing you to upload Unity resources to realize more immersive 3D effects.

    11.0.8

    V1.8.2

    The Unity component supported Unity multi-scene resources. For details, see section "Unity Multi-Scene Switching."

    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.

    Unity Resource Preparation

    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.

    Unity Component Addition

    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.

    Unity 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.

    Unity 1.gif

    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.

    Unity 2.gif

    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.

    Interaction Events Supported by the Unity Component

    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.

    Attachment List


    Theme: FineVis Data Visualization
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy