NSDT可编程3D场景兼容Three.js

Posted 2023-03-04 新缸中之脑

NSDT编辑器简化了WebGL 3D应用的开发，完全兼容Three.JS生态。本文介绍如何在自己的应用中嵌入使用NSDT编辑器搭建的3D场景，并通过JS API与场景进行交互。

在自己的应用中嵌入3D场景只需要三个步骤：

• 在NSDT编辑器中搭建3D场景
• 在自己的前端应用中加载搭建好的3D场景
• 使用javascript API与3D场景交互

首先下载NSDT 3D场景JS开发包和演示程序，开发包文档参见这里。

1、搭建3D场景

前往NSDT场景编辑器，拖拽模型快速搭建3D场景，成果如下，预览点击这里：

2、加载3D场景

首先在html页面中创建一个Canvas元素以便渲染3D场景：

<canvas class="canvas webgl"></canvas>

然后引入开发包：

<script src="./libs/js/three.js"></script>
<script src="./libs/js/[e-mail]"></script>

创建一个NSDT Viewer对象，并调用Viewer的 loadScene() 方法加载指定的场景：

const sceneId = '63a13d2d39c45778ba1bedd0'     //场景ID
const viewer = new DT.Viewer(canvas);          //初始化场景查看器
const scene = await viewer.loadScene(sceneId)  //加载指定场景

3、与3D场景交互

加载场景后，可以使用JS API与场景中的对象模型交互，比如调整其位置、旋转角度、路径漫游等，也可以接收来自3D场景的事件，例如：

下面以相机漫游为例。

首先调用Viewer的 getRoamingList() 方法获取指定场景的漫游列表，并将漫游路径关键点信息（位置、方向、时长等）存入 points数组：

const res = await viewer.getRoamingList(sceneId)              //获取漫游列表

const points = [];
for (let item of res[0].points) 
  points.push(                                               //保存路径关键点
    duration: Number(item.duration) * 1000,
    position: new THREE.Vector3().fromArray(item.position),
    target: new THREE.Vector3().fromArray(item.target),
  );

然后利用读取的关键点创建 RoamingPath 对象，并调用其 start() 方法启动：

const roaming = new DT.RoamingPath(viewer, points)
roaming.start();

效果如下：

---

原文链接：NSDT可编程3D场景 — BimAnt