视角定位

可通过构件定位、相机跳转和恢复快照控制 3D Viewer 视角。

打开 API 调试

视角定位

可通过构件定位、相机跳转和恢复快照控制 3D Viewer 视角。

定位到构件

const position = viewer.engine?.getModelPosition({
  url: 'https://example.com/models/building-a/',
  ids: [350518]
});

console.log(position);

url 必须与加载模型时使用的地址一致,ids 是构件 ID 数组。

跳转至摄像头视角

const success = viewer.engine?.jumpToCamera(cameraData);
if (!success) {
  console.warn('相机数据无效或引擎未初始化');
}

cameraData 通常来自业务系统保存的视角或图钉数据。保存数据应按项目和模型版本隔离,避免跨模型直接复用。

恢复视图快照

await viewer.engine?.restoreViewSnapshot(snapshot);

恢复前需完成模型加载。快照的数据结构由创建快照的同一版本 Viewer 生成,业务侧应原样持久化。