视角定位
可通过构件定位、相机跳转和恢复快照控制 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 生成,业务侧应原样持久化。