Photo Sphere Viewer 虚拟漫游插件：如何根据来源设置初始视角

技术背景

Photo Sphere Viewer 是一个功能强大的全景图像查看器库，其 VirtualTour 插件允许用户创建交互式的虚拟漫游体验。在实际应用中，一个常见需求是根据用户从哪个节点进入当前场景，自动调整初始视角朝向，以提供更自然的导航体验。

视角控制原理

VirtualTour 插件通过以下机制控制场景切换时的视角：

1. 基础方向定义：默认情况下，全景图像的北方对应 yaw=0 方向。插件会基于这个基准方向计算视角。

2. poseHeading 参数：当原始图像没有正确对齐时，可以通过设置 poseHeading 参数来调整基准方向。

3. transitionOption 配置：在节点切换时，可以通过 transitionOption 精确控制切换过程中的视角变化。

室内场景的特殊处理

对于室内全景漫游，传统的基于地理方向的视角控制可能不太适用。开发者可以通过以下方式实现基于来源的视角控制：

1. linkOffset 参数：在节点链接配置中，position 属性定义了目标节点的初始视角，而 linkOffset 则控制源节点中标记的位置。

2. 计算关系：标记在源节点中的位置 = position + linkOffset。通过合理设置这两个参数，可以实现"从哪个门进入就朝向哪个方向"的效果。

实际应用示例

以下是一个典型的室内漫游配置示例，展示了如何在两个房间之间建立双向链接：

this.virtualTourPlugin.setNodes([
  {
    id: '客厅',
    panorama: './assets/living-room.jpg',
    links: [
      { 
        nodeId: '卧室', 
        position: { yaw: -0.5, pitch: -0.5 }, // 进入卧室时的初始视角
        linkOffset: {yaw: 1, pitch: 1}        // 客厅中门标记的位置
      }
    ]
  },
  {
    id: '卧室',
    panorama: './assets/bedroom.jpg',
    links: [
      { 
        nodeId: '客厅', 
        position: { yaw: 0.5, pitch: 0.5 },   // 返回客厅时的初始视角
        linkOffset: {yaw: -1, pitch: -1}      // 卧室中门标记的位置
      }
    ]
  }
]);

开发建议

1. 绝对位置配置：当前需要计算偏移量可能不够直观，建议开发者封装一个工具函数，将标记的绝对位置转换为所需的偏移量。

2. 用户体验优化：在编辑模式下，可以先获取标记的点击位置，再自动计算所需的偏移量，简化配置过程。

3. 多入口处理：对于有多个入口的房间，为每个入口创建独立的链接配置，分别设置不同的初始视角。

通过合理配置这些参数，开发者可以创建出符合真实空间感知的虚拟漫游体验，使用户在场景切换时获得自然的视角过渡。