[]
        
首页
开发者学堂
文档
论坛
市场
生态机会
活动
在线Demo 免费试用
(Showing Draft Content)

集成3D场景设计器

1. 概述

1.1 功能概述

通过iFrame容器技术,用户可将3D场景设计器无缝嵌入Web业务系统,来快速实现创建新的 3D 场景或者编辑已有的 3D 场景。

2. 操作步骤

2.1 新建 3D 场景

2.1.1 准备3D 场景 URL

  1. 先准备好创建报表设计器的URL。例如:

    http://localhost:51980/scenes/create

2.1.2 添加用户令牌

  1. 在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用“?token=” 进行连接,得到最终的 URL 字串。

    例如:http://localhost:51980/scenes/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

    注意: 生成令牌时使用的用户,应具有创建仪表板的权限。

  2. 使用得到的URL即可直接打开一个全新的空设计器。

    image

2.2 编辑已有的 3D 场景

2.2.1 获取 3D 场景的 URL

  1. 在文档门户中,选择需要集成的3D 场景,单击页面操作栏的在新窗口中浏览3D场景按钮image ,即可在新的浏览器窗口中打开然后将3D场景的 URL地址拷贝粘贴到记事本中待用。

    PixPin_2025-10-27_17-44-59

  2. 在记事本中将URL中的 view 改为 edit 。例如:

    原URL:http://localhost:51980/scenes/view/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN
    
    修改后的URL:http://localhost:51980/scenes/edit/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN

2.2.2 添加用户令牌

  1. 在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用 “&token=” 进行连接,得到最终的 URL 字串。

    例如:http://localhost:51980/scenes/edit/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6
  2. 使用上面的链接打开后,效果如下图。在设计器中打开了指定的3D 场景。

    PixPin_2025-07-22_09-53-12

    注意: 生成令牌时使用的用户,应具有创建仪表板的基本权限以及对目标3D场景的读写权限。