如何在Forge Viewer中导航跳转至任意指定坐标位置

核心实现逻辑 #

Forge Viewer 内置了完善的相机控制API，拿到目标世界坐标后可直接调用对应接口实现跳转，无需自行实现坐标映射、视口适配逻辑。

方案1：无动画瞬间跳转 #

适用于需要立刻切换到目标视角的场景：

// 替换为你实际获取的目标世界坐标
const targetPoint = new THREE.Vector3(123.4, 567.8, 90.1);
// 自定义相机位置，示例为在目标点Z轴正方向偏移1000单位，可自行调整距离、角度
const cameraPosition = targetPoint.clone().add(new THREE.Vector3(0, 0, 1000));

// 执行跳转
viewer.navigation.setView(cameraPosition, targetPoint);
// 可选：自动适配视口，让目标区域完整展示
viewer.fitToView();

如果仅需要调整视角看向目标点，不需要移动相机位置，可直接调用 viewer.navigation.setTarget(targetPoint)。

方案2：带平滑过渡的导航动画 #

适用于需要漫游过渡效果的场景：

const targetPoint = new THREE.Vector3(123.4, 567.8, 90.1);
const cameraPosition = targetPoint.clone().add(new THREE.Vector3(0, 0, 1000));

// 开启平滑过渡
viewer.navigation.requestTransition(
  Autodesk.Viewing.CameraTransitionType.LINEAR, // 可选SPHERICAL等其他过渡类型
  1500, // 过渡时长，单位为毫秒，此处为1.5秒
  cameraPosition,
  targetPoint
);

// 过渡结束后自动适配视口（可选）
viewer.addEventListener(Autodesk.Viewing.CAMERA_TRANSITION_COMPLETED, () => {
  viewer.fitToView();
}, { once: true });

异常场景排查 #

如果执行代码后无效果，可逐一核对以下规则：

• 确认你的目标坐标是Forge Viewer世界坐标系下的坐标，而非屏幕坐标、模型局部坐标。如果是局部坐标，需要先通过model.getFragmentList().getWorldMatrix(fragId, matrix)转换为世界坐标后再使用
• 确认跳转逻辑在Viewer加载完成后执行，建议绑定到Autodesk.Viewing.GEOMETRY_LOADED_EVENT事件或者loadModel的成功回调中触发
• 确认未设置相机控制锁定，若之前调用过viewer.navigation.setLockSettings()限制了相机移动，执行跳转前先解除对应限制

内容的提问来源于stack exchange，提问作者user17096286