npm - @realsee/five - Versions diffs - 6.9.0-alpha.0 → 6.9.0-alpha.1 - Mend

@realsee/five 6.9.0-alpha.0 → 6.9.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (266) hide show

package/docs/documents/features_mode.html CHANGED Viewed

@@ -10,7 +10,7 @@
 <p><strong>Definition</strong>: <a href="../../five/application/mode.d.ts">Mode</a>, <a href="../../five/application/fiveInitArgs.d.ts">FiveInitArgs</a></p>
 </blockquote>
 <p><strong>Mode</strong> 类型定义如下：</p>
-<pre><code class="ts"><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">Mode</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;Panorama&quot;</span><span class="hl-1">   </span><span class="hl-8">// 全景图游走模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;Mapview&quot;</span><span class="hl-1">    </span><span class="hl-8">// 模型地图模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;Floorplan&quot;</span><span class="hl-1">  </span><span class="hl-8">// 模型户型图模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;Topview&quot;</span><span class="hl-1">    </span><span class="hl-8">// 模型平面图模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;Model&quot;</span><span class="hl-1">      </span><span class="hl-8">// 模型游走模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;VRPanorama&quot;</span><span class="hl-1"> </span><span class="hl-8">// Cardboard VR 眼镜模式</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;XRPanorama&quot;</span><span class="hl-1"> </span><span class="hl-8">// WebXR 虚拟现实 VR 眼镜模式</span>
+<pre><code class="ts"><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">Mode</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;Panorama&quot;</span><span class="hl-1">   </span><span class="hl-7">// 全景图游走模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;Mapview&quot;</span><span class="hl-1">    </span><span class="hl-7">// 模型地图模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;Floorplan&quot;</span><span class="hl-1">  </span><span class="hl-7">// 模型户型图模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;Topview&quot;</span><span class="hl-1">    </span><span class="hl-7">// 模型平面图模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;Model&quot;</span><span class="hl-1">      </span><span class="hl-7">// 模型游走模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;VRPanorama&quot;</span><span class="hl-1"> </span><span class="hl-7">// Cardboard VR 眼镜模式</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;XRPanorama&quot;</span><span class="hl-1"> </span><span class="hl-7">// WebXR 虚拟现实 VR 眼镜模式</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="concepts" class="tsd-anchor-link">Concepts<a href="#concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
@@ -49,50 +49,50 @@
 <h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>初始化 <code>new Five()</code> 时，可以通过配置参数对各个模式进行个性化定制。</p>
 <h3 id="panorama-全景漫游" class="tsd-anchor-link">Panorama (全景漫游)<a href="#panorama-全景漫游" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">PanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认相机俯仰角 (Default: 0) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认垂直 FOV (Default: 90) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultFov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 最大垂直 FOV (Default: 120) */</span><br/><span class="hl-1">  </span><span class="hl-6">maxFov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 最小垂直 FOV (Default: 20) */</span><br/><span class="hl-1">  </span><span class="hl-6">minFov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 最大俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-6">maxLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | ((</span><span class="hl-6">fov</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">number</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-8">/** 最小俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-6">minLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1"> | ((</span><span class="hl-6">fov</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">number</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点位间移动速度 (m/s) (Default: 3.6) */</span><br/><span class="hl-1">  </span><span class="hl-6">moveSpeed</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 最远可移动观察点距离 */</span><br/><span class="hl-1">  </span><span class="hl-6">maxAccessibleDistance</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 点击地面判定范围 */</span><br/><span class="hl-1">  </span><span class="hl-6">panoTapTriggerRadius</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 航拍点最小高度 (Default: 5) */</span><br/><span class="hl-1">  </span><span class="hl-6">aerialObserverMinHeight</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 全景进入渐变时长 (s) */</span><br/><span class="hl-1">  </span><span class="hl-6">tileAppearDuration</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 全景瓦片最大并发请求数 */</span><br/><span class="hl-1">  </span><span class="hl-6">tileMaxRequest</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/**</span><br/><span class="hl-8">   * 地面观察点标识自定义创建器</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">observer</span><span class="hl-8"> - 观察点数据</span><br/><span class="hl-8">   * </span><span class="hl-3">@param</span><span class="hl-8"> </span><span class="hl-6">options</span><span class="hl-8"> - 配置项，如航拍点最小高度</span><br/><span class="hl-8">   * </span><span class="hl-3">@returns</span><span class="hl-8"> PanoCircleMeshInterface 实例 (如 PanoCircleMesh, PanoCircleMeshSolid)</span><br/><span class="hl-8">   */</span><br/><span class="hl-1">  </span><span class="hl-5">panoCircleMeshCreator</span><span class="hl-1">?: (</span><br/><span class="hl-1">    </span><span class="hl-6">observer</span><span class="hl-1">: </span><span class="hl-7">WorkObserver</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">options</span><span class="hl-1">: { </span><span class="hl-6">aerialObserverMinHeight</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1"> }</span><br/><span class="hl-1">  ) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">PanoCircleMeshInterface</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">PanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认相机俯仰角 (Default: 0) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认垂直 FOV (Default: 90) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultFov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 最大垂直 FOV (Default: 120) */</span><br/><span class="hl-1">  </span><span class="hl-5">maxFov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 最小垂直 FOV (Default: 20) */</span><br/><span class="hl-1">  </span><span class="hl-5">minFov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 最大俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-5">maxLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1"> | ((</span><span class="hl-5">fov</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-7">/** 最小俯仰角 */</span><br/><span class="hl-1">  </span><span class="hl-5">minLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1"> | ((</span><span class="hl-5">fov</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点位间移动速度 (m/s) (Default: 3.6) */</span><br/><span class="hl-1">  </span><span class="hl-5">moveSpeed</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 最远可移动观察点距离 */</span><br/><span class="hl-1">  </span><span class="hl-5">maxAccessibleDistance</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 点击地面判定范围 */</span><br/><span class="hl-1">  </span><span class="hl-5">panoTapTriggerRadius</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 航拍点最小高度 (Default: 5) */</span><br/><span class="hl-1">  </span><span class="hl-5">aerialObserverMinHeight</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 全景进入渐变时长 (s) */</span><br/><span class="hl-1">  </span><span class="hl-5">tileAppearDuration</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 全景瓦片最大并发请求数 */</span><br/><span class="hl-1">  </span><span class="hl-5">tileMaxRequest</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/**</span><br/><span class="hl-7">   * 地面观察点标识自定义创建器</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">observer</span><span class="hl-7"> - 观察点数据</span><br/><span class="hl-7">   * </span><span class="hl-8">@param</span><span class="hl-7"> </span><span class="hl-5">options</span><span class="hl-7"> - 配置项，如航拍点最小高度</span><br/><span class="hl-7">   * </span><span class="hl-8">@returns</span><span class="hl-7"> PanoCircleMeshInterface 实例 (如 PanoCircleMesh, PanoCircleMeshSolid)</span><br/><span class="hl-7">   */</span><br/><span class="hl-1">  </span><span class="hl-4">panoCircleMeshCreator</span><span class="hl-1">?: (</span><br/><span class="hl-1">    </span><span class="hl-5">observer</span><span class="hl-1">: </span><span class="hl-9">WorkObserver</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">options</span><span class="hl-1">: { </span><span class="hl-5">aerialObserverMinHeight</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1"> }</span><br/><span class="hl-1">  ) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">PanoCircleMeshInterface</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="mapview-模型地图" class="tsd-anchor-link">Mapview (模型地图)<a href="#mapview-模型地图" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">MapviewConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认水平角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认俯仰角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认相机距离 (Default: 150) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultDistance</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机类型: &#39;perspective&#39; | &#39;orthographic&#39; | &#39;auto&#39; (Default: &#39;auto&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-6">cameraType</span><span class="hl-1">?: </span><span class="hl-9">&quot;perspective&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;orthographic&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;auto&quot;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 相机移动范围限制 */</span><br/><span class="hl-1">  </span><span class="hl-6">cameraFence</span><span class="hl-1">?: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Box3</span><span class="hl-1"> | </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Sphere</span><span class="hl-1"> | </span><span class="hl-7">null</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">MapviewConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认水平角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认俯仰角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认相机距离 (Default: 150) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultDistance</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机类型: &#39;perspective&#39; | &#39;orthographic&#39; | &#39;auto&#39; (Default: &#39;auto&#39;) */</span><br/><span class="hl-1">  </span><span class="hl-5">cameraType</span><span class="hl-1">?: </span><span class="hl-10">&quot;perspective&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;orthographic&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;auto&quot;</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 相机移动范围限制 */</span><br/><span class="hl-1">  </span><span class="hl-5">cameraFence</span><span class="hl-1">?: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Box3</span><span class="hl-1"> | </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Sphere</span><span class="hl-1"> | </span><span class="hl-9">null</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="floorplan-模型户型" class="tsd-anchor-link">Floorplan (模型户型)<a href="#floorplan-模型户型" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">FloorplanConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认水平角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认俯仰角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认垂直 FOV (Default: 80) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultFov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">FloorplanConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认水平角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认俯仰角 (Default: Math.PI / 4) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认垂直 FOV (Default: 80) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultFov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="topview-模型平面" class="tsd-anchor-link">Topview (模型平面)<a href="#topview-模型平面" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">TopviewConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认水平角 (Default: 0) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">/** 默认俯仰角 (Default: Math.PI / 2) */</span><br/><span class="hl-1">  </span><span class="hl-6">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">TopviewConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认水平角 (Default: 0) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLongitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">/** 默认俯仰角 (Default: Math.PI / 2) */</span><br/><span class="hl-1">  </span><span class="hl-5">defaultLatitude</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="model-模型漫游" class="tsd-anchor-link">Model (模型漫游)<a href="#model-模型漫游" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>继承自 Panorama 配置，支持 FOV、俯仰角限制及移动速度等参数。</p>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">ModelConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">moveSpeed</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">defaultFov</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">ModelConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">moveSpeed</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-5">defaultFov</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="vrpanorama-xrpanorama-vr-模式" class="tsd-anchor-link">VRPanorama / XRPanorama (VR 模式)<a href="#vrpanorama-xrpanorama-vr-模式" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>继承自 Panorama 配置，但移除了俯仰角限制（<code>maxLatitude</code>, <code>minLatitude</code>），因为 VR 模式下视角由设备姿态控制。</p>
-<pre><code class="typescript"><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">VRPanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">  </span><span class="hl-8">// 移除: maxLatitude, minLatitude</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">XRPanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">  </span><span class="hl-8">// 移除: maxLatitude, minLatitude</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">VRPanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">  </span><span class="hl-7">// 移除: maxLatitude, minLatitude</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">XRPanoramaConfig</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 同 Panorama 基础配置</span><br/><span class="hl-1">  </span><span class="hl-7">// 移除: maxLatitude, minLatitude</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="快速上手-quick-example" class="tsd-anchor-link">快速上手 (Quick Example)<a href="#快速上手-quick-example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>使用 <code>setState</code> 切换模式：</p>
-<pre><code class="ts"><span class="hl-8">// 切换到模型地图模式</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">setState</span><span class="hl-1">({ </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&#39;Mapview&#39;</span><span class="hl-1"> });</span>
+<pre><code class="ts"><span class="hl-7">// 切换到模型地图模式</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">setState</span><span class="hl-1">({ </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&#39;Mapview&#39;</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="初始化配置示例-initialization-configuration-example" class="tsd-anchor-link">初始化配置示例 (Initialization Configuration Example)<a href="#初始化配置示例-initialization-configuration-example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>在 <code>new Five()</code> 时配置各个模式的默认参数：</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">PanoCircleMeshSolid</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-8">// 全景模式配置</span><br/><span class="hl-1">  </span><span class="hl-6">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 限制垂直视角范围</span><br/><span class="hl-1">    </span><span class="hl-6">minFov:</span><span class="hl-1"> </span><span class="hl-11">40</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">maxFov:</span><span class="hl-1"> </span><span class="hl-11">100</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-8">// 调整移动速度</span><br/><span class="hl-1">    </span><span class="hl-6">moveSpeed:</span><span class="hl-1"> </span><span class="hl-11">5.0</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-8">// 自定义地面点位样式 (例如：只显示实心点)</span><br/><span class="hl-1">    </span><span class="hl-5">panoCircleMeshCreator</span><span class="hl-6">:</span><span class="hl-1"> (</span><span class="hl-6">observer</span><span class="hl-1">, </span><span class="hl-6">options</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-8">// 这里的 options 包含了 aerialObserverMinHeight 等信息</span><br/><span class="hl-1">      </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">PanoCircleMeshSolid</span><span class="hl-1">({</span><br/><span class="hl-1">        </span><span class="hl-6">color:</span><span class="hl-1"> </span><span class="hl-11">0x3366ff</span><span class="hl-1">, </span><span class="hl-8">// 自定义颜色</span><br/><span class="hl-1">        </span><span class="hl-6">scale:</span><span class="hl-1"> </span><span class="hl-11">1.2</span><span class="hl-1">       </span><span class="hl-8">// 自定义大小</span><br/><span class="hl-1">      });</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-8">// 模型地图配置</span><br/><span class="hl-1">  </span><span class="hl-6">mapview:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 设置默认进入时的视角参数</span><br/><span class="hl-1">    </span><span class="hl-6">defaultLatitude:</span><span class="hl-1"> </span><span class="hl-6">Math</span><span class="hl-1">.</span><span class="hl-4">PI</span><span class="hl-1"> / </span><span class="hl-11">3</span><span class="hl-1">, </span><span class="hl-8">// 60度俯视</span><br/><span class="hl-1">    </span><span class="hl-6">defaultDistance:</span><span class="hl-1"> </span><span class="hl-11">200</span><span class="hl-1">,         </span><span class="hl-8">// 相机距离</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-8">// 模型漫游配置</span><br/><span class="hl-1">  </span><span class="hl-6">model:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">moveSpeed:</span><span class="hl-1"> </span><span class="hl-11">10.0</span><span class="hl-1"> </span><span class="hl-8">// 模型模式下移动更快</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">PanoCircleMeshSolid</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-7">// 全景模式配置</span><br/><span class="hl-1">  </span><span class="hl-5">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 限制垂直视角范围</span><br/><span class="hl-1">    </span><span class="hl-5">minFov:</span><span class="hl-1"> </span><span class="hl-3">40</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">maxFov:</span><span class="hl-1"> </span><span class="hl-3">100</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-7">// 调整移动速度</span><br/><span class="hl-1">    </span><span class="hl-5">moveSpeed:</span><span class="hl-1"> </span><span class="hl-3">5.0</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-7">// 自定义地面点位样式 (例如：只显示实心点)</span><br/><span class="hl-1">    </span><span class="hl-4">panoCircleMeshCreator</span><span class="hl-5">:</span><span class="hl-1"> (</span><span class="hl-5">observer</span><span class="hl-1">, </span><span class="hl-5">options</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-7">// 这里的 options 包含了 aerialObserverMinHeight 等信息</span><br/><span class="hl-1">      </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">PanoCircleMeshSolid</span><span class="hl-1">({</span><br/><span class="hl-1">        </span><span class="hl-5">color:</span><span class="hl-1"> </span><span class="hl-3">0x3366ff</span><span class="hl-1">, </span><span class="hl-7">// 自定义颜色</span><br/><span class="hl-1">        </span><span class="hl-5">scale:</span><span class="hl-1"> </span><span class="hl-3">1.2</span><span class="hl-1">       </span><span class="hl-7">// 自定义大小</span><br/><span class="hl-1">      });</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-7">// 模型地图配置</span><br/><span class="hl-1">  </span><span class="hl-5">mapview:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 设置默认进入时的视角参数</span><br/><span class="hl-1">    </span><span class="hl-5">defaultLatitude:</span><span class="hl-1"> </span><span class="hl-5">Math</span><span class="hl-1">.</span><span class="hl-6">PI</span><span class="hl-1"> / </span><span class="hl-3">3</span><span class="hl-1">, </span><span class="hl-7">// 60度俯视</span><br/><span class="hl-1">    </span><span class="hl-5">defaultDistance:</span><span class="hl-1"> </span><span class="hl-3">200</span><span class="hl-1">,         </span><span class="hl-7">// 相机距离</span><br/><span class="hl-1">  },</span><br/><span class="hl-1">  </span><span class="hl-7">// 模型漫游配置</span><br/><span class="hl-1">  </span><span class="hl-5">model:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">moveSpeed:</span><span class="hl-1"> </span><span class="hl-3">10.0</span><span class="hl-1"> </span><span class="hl-7">// 模型模式下移动更快</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="动态修改配置-update-configuration" class="tsd-anchor-link">动态修改配置 (Update Configuration)<a href="#动态修改配置-update-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>初始化后，可以使用 <code>five.updateConfiguration()</code> 动态修改各模式的配置参数，无需重新实例化。</p>
-<pre><code class="typescript"><span class="hl-8">// 动态修改全景模式的移动速度和最大 FOV</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">updateConfiguration</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-6">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">moveSpeed:</span><span class="hl-1"> </span><span class="hl-11">10.0</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">maxFov:</span><span class="hl-1"> </span><span class="hl-11">140</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-8">// 动态修改模型地图模式的相机距离</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">updateConfiguration</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-6">mapview:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">defaultDistance:</span><span class="hl-1"> </span><span class="hl-11">300</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-7">// 动态修改全景模式的移动速度和最大 FOV</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">updateConfiguration</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">panorama:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">moveSpeed:</span><span class="hl-1"> </span><span class="hl-3">10.0</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">maxFov:</span><span class="hl-1"> </span><span class="hl-3">140</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-7">// 动态修改模型地图模式的相机距离</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">updateConfiguration</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">mapview:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">defaultDistance:</span><span class="hl-1"> </span><span class="hl-3">300</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="进阶用法-advanced-usage" class="tsd-anchor-link">进阶用法 (Advanced Usage)<a href="#进阶用法-advanced-usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>使用 <code>changeMode</code> 精准控制切换过程，并监听完成时机：</p>
-<pre><code class="ts"><span class="hl-10">import</span><span class="hl-1"> { </span><span class="hl-6">Five</span><span class="hl-1">, </span><span class="hl-6">Mode</span><span class="hl-1"> } </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">five</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-5">Five</span><span class="hl-1">();</span><br/><br/><span class="hl-8">// ... 初始化 ...</span><br/><br/><span class="hl-8">// 定义一个切换模式的函数</span><br/><span class="hl-3">async</span><span class="hl-1"> </span><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">switchMode</span><span class="hl-1">(</span><span class="hl-6">targetMode</span><span class="hl-1">: </span><span class="hl-7">Mode</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-10">try</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// changeMode 返回 Promise，resolve 时表示切换动画结束</span><br/><span class="hl-1">    </span><span class="hl-10">await</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">changeMode</span><span class="hl-1">(</span><span class="hl-6">targetMode</span><span class="hl-1">, </span><span class="hl-3">undefined</span><span class="hl-1">, {</span><br/><span class="hl-1">        </span><span class="hl-6">duration:</span><span class="hl-1"> </span><span class="hl-11">1000</span><span class="hl-1"> </span><span class="hl-8">// 动画时长 1000ms</span><br/><span class="hl-1">    });</span><br/><span class="hl-1">    </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`成功切换到 </span><span class="hl-3">${</span><span class="hl-6">targetMode</span><span class="hl-3">}</span><span class="hl-9"> 模式`</span><span class="hl-1">);</span><br/><span class="hl-1">  } </span><span class="hl-10">catch</span><span class="hl-1"> (</span><span class="hl-6">error</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">error</span><span class="hl-1">(</span><span class="hl-9">`切换到 </span><span class="hl-3">${</span><span class="hl-6">targetMode</span><span class="hl-3">}</span><span class="hl-9"> 失败`</span><span class="hl-1">, </span><span class="hl-6">error</span><span class="hl-1">);</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">// 绑定按钮事件</span><br/><span class="hl-6">document</span><span class="hl-1">.</span><span class="hl-5">querySelector</span><span class="hl-1">(</span><span class="hl-9">&#39;#btn-map&#39;</span><span class="hl-1">).</span><span class="hl-5">addEventListener</span><span class="hl-1">(</span><span class="hl-9">&#39;click&#39;</span><span class="hl-1">, () </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">switchMode</span><span class="hl-1">(</span><span class="hl-9">&#39;Mapview&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="ts"><span class="hl-11">import</span><span class="hl-1"> { </span><span class="hl-5">Five</span><span class="hl-1">, </span><span class="hl-5">Mode</span><span class="hl-1"> } </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&#39;@realsee/five&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">five</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-4">Five</span><span class="hl-1">();</span><br/><br/><span class="hl-7">// ... 初始化 ...</span><br/><br/><span class="hl-7">// 定义一个切换模式的函数</span><br/><span class="hl-8">async</span><span class="hl-1"> </span><span class="hl-8">function</span><span class="hl-1"> </span><span class="hl-4">switchMode</span><span class="hl-1">(</span><span class="hl-5">targetMode</span><span class="hl-1">: </span><span class="hl-9">Mode</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-11">try</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// changeMode 返回 Promise，resolve 时表示切换动画结束</span><br/><span class="hl-1">    </span><span class="hl-11">await</span><span class="hl-1"> </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">changeMode</span><span class="hl-1">(</span><span class="hl-5">targetMode</span><span class="hl-1">, </span><span class="hl-8">undefined</span><span class="hl-1">, {</span><br/><span class="hl-1">        </span><span class="hl-5">duration:</span><span class="hl-1"> </span><span class="hl-3">1000</span><span class="hl-1"> </span><span class="hl-7">// 动画时长 1000ms</span><br/><span class="hl-1">    });</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">`成功切换到 </span><span class="hl-8">${</span><span class="hl-5">targetMode</span><span class="hl-8">}</span><span class="hl-10"> 模式`</span><span class="hl-1">);</span><br/><span class="hl-1">  } </span><span class="hl-11">catch</span><span class="hl-1"> (</span><span class="hl-5">error</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">error</span><span class="hl-1">(</span><span class="hl-10">`切换到 </span><span class="hl-8">${</span><span class="hl-5">targetMode</span><span class="hl-8">}</span><span class="hl-10"> 失败`</span><span class="hl-1">, </span><span class="hl-5">error</span><span class="hl-1">);</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">// 绑定按钮事件</span><br/><span class="hl-5">document</span><span class="hl-1">.</span><span class="hl-4">querySelector</span><span class="hl-1">(</span><span class="hl-10">&#39;#btn-map&#39;</span><span class="hl-1">).</span><span class="hl-4">addEventListener</span><span class="hl-1">(</span><span class="hl-10">&#39;click&#39;</span><span class="hl-1">, () </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">switchMode</span><span class="hl-1">(</span><span class="hl-10">&#39;Mapview&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="common-pitfalls" class="tsd-anchor-link">Common Pitfalls<a href="#common-pitfalls" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>

package/docs/documents/features_model.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/model/model.d.ts">Model</a></p>
 </blockquote>
 <p>Model 类继承自 <code>THREE.Object3D</code>，是三维场景中的顶级对象。</p>
-<pre><code class="typescript"><span class="hl-8">// 简化版定义，完整定义参考 lib/five/model/model.ts</span><br/><span class="hl-3">class</span><span class="hl-1"> </span><span class="hl-7">Model</span><span class="hl-1"> </span><span class="hl-3">extends</span><span class="hl-1"> </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Object3D</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-8">/** 唯一标识 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">fiveId</span><span class="hl-1">: </span><span class="hl-7">string</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 对应的 Work 数据 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">Work</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 模型参数配置 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">parameter</span><span class="hl-1">: </span><span class="hl-7">Parameter</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 包含的视图层 (如 mesh, point_cloud, gaussian_splatting) */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">viewLayers</span><span class="hl-1">: </span><span class="hl-7">ViewLayer</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 是否加载完成 (初次加载) */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">loaded</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 是否细化完成 (高清纹理/模型加载完毕) */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">refined</span><span class="hl-1">: </span><span class="hl-7">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 细化进度 [当前, 总数] */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">refineProgress</span><span class="hl-1">: [</span><span class="hl-7">number</span><span class="hl-1">, </span><span class="hl-7">number</span><span class="hl-1">];</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 外包围盒 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">boundingBox</span><span class="hl-1">: </span><span class="hl-7">THREE</span><span class="hl-1">.</span><span class="hl-7">Box3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-8">/** 楼层数量 */</span><br/><span class="hl-1">  </span><span class="hl-3">public</span><span class="hl-1"> </span><span class="hl-6">floorLength</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-7">// 简化版定义，完整定义参考 lib/five/model/model.ts</span><br/><span class="hl-8">class</span><span class="hl-1"> </span><span class="hl-9">Model</span><span class="hl-1"> </span><span class="hl-8">extends</span><span class="hl-1"> </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Object3D</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-7">/** 唯一标识 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">fiveId</span><span class="hl-1">: </span><span class="hl-9">string</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 对应的 Work 数据 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">Work</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 模型参数配置 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">parameter</span><span class="hl-1">: </span><span class="hl-9">Parameter</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 包含的视图层 (如 mesh, point_cloud, gaussian_splatting) */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">viewLayers</span><span class="hl-1">: </span><span class="hl-9">ViewLayer</span><span class="hl-1">[];</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 是否加载完成 (初次加载) */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">loaded</span><span class="hl-1">: </span><span class="hl-9">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 是否细化完成 (高清纹理/模型加载完毕) */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">refined</span><span class="hl-1">: </span><span class="hl-9">boolean</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 细化进度 [当前, 总数] */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">refineProgress</span><span class="hl-1">: [</span><span class="hl-9">number</span><span class="hl-1">, </span><span class="hl-9">number</span><span class="hl-1">];</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 外包围盒 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">boundingBox</span><span class="hl-1">: </span><span class="hl-9">THREE</span><span class="hl-1">.</span><span class="hl-9">Box3</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-7">/** 楼层数量 */</span><br/><span class="hl-1">  </span><span class="hl-8">public</span><span class="hl-1"> </span><span class="hl-5">floorLength</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">;</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <blockquote>
@@ -29,7 +29,7 @@
 <li><strong><code>five.model</code></strong>: 这是一个便捷属性，直接返回 <code>five.models[0]</code>。</li>
 </ul>
 <p>通常情况下，如果你只加载了一个 Work，可以直接使用 <code>five.model</code> 来操作当前模型。</p>
-<pre><code class="typescript"><span class="hl-8">// 下面两种方式是等价的</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">model1</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">models</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">];</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">model2</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">model</span><span class="hl-1">;</span>
+<pre><code class="typescript"><span class="hl-7">// 下面两种方式是等价的</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">model1</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">models</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">model2</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">model</span><span class="hl-1">;</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-model-vs-work" class="tsd-anchor-link">2. Model vs Work<a href="#2-model-vs-work" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
@@ -115,11 +115,11 @@ Model 加载完成后，会自动根据 Work 数据生成对应的 ViewLayer，
 </table>
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="获取并操作当前模型" class="tsd-anchor-link">获取并操作当前模型<a href="#获取并操作当前模型" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-8">// 获取当前模型</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">model</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">models</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">];</span><br/><br/><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">model</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;模型对应 Work 名称:&quot;</span><span class="hl-1">, </span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">work</span><span class="hl-1">.</span><span class="hl-6">name</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;模型是否细化完成:&quot;</span><span class="hl-1">, </span><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">refined</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-8">// 监听模型细化事件</span><br/><span class="hl-1">  </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">on</span><span class="hl-1">(</span><span class="hl-9">&quot;model.refined&quot;</span><span class="hl-1">, () </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;模型高清资源加载完毕&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  });</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-7">// 获取当前模型</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">model</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">models</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><br/><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">model</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;模型对应 Work 名称:&quot;</span><span class="hl-1">, </span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">work</span><span class="hl-1">.</span><span class="hl-5">name</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;模型是否细化完成:&quot;</span><span class="hl-1">, </span><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">refined</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-7">// 监听模型细化事件</span><br/><span class="hl-1">  </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">on</span><span class="hl-1">(</span><span class="hl-10">&quot;model.refined&quot;</span><span class="hl-1">, () </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;模型高清资源加载完毕&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  });</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="遍历-viewlayer" class="tsd-anchor-link">遍历 ViewLayer<a href="#遍历-viewlayer" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">model</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">models</span><span class="hl-1">[</span><span class="hl-11">0</span><span class="hl-1">];</span><br/><span class="hl-8">// model.viewLayers 即为 ViewLayer 列表</span><br/><span class="hl-6">model</span><span class="hl-1">.</span><span class="hl-6">viewLayers</span><span class="hl-1">.</span><span class="hl-5">forEach</span><span class="hl-1">((</span><span class="hl-6">layer</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">`图层名称: </span><span class="hl-3">${</span><span class="hl-6">layer</span><span class="hl-12">.</span><span class="hl-6">name</span><span class="hl-3">}</span><span class="hl-9">, 类型: </span><span class="hl-3">${</span><span class="hl-6">layer</span><span class="hl-12">.</span><span class="hl-6">type</span><span class="hl-3">}</span><span class="hl-9">`</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">layer</span><span class="hl-1">.</span><span class="hl-6">type</span><span class="hl-1"> === </span><span class="hl-9">&#39;mesh&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-8">// 对网格层做特殊处理</span><br/><span class="hl-1">    </span><span class="hl-6">layer</span><span class="hl-1">.</span><span class="hl-6">visible</span><span class="hl-1"> = </span><span class="hl-3">true</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">model</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">models</span><span class="hl-1">[</span><span class="hl-3">0</span><span class="hl-1">];</span><br/><span class="hl-7">// model.viewLayers 即为 ViewLayer 列表</span><br/><span class="hl-5">model</span><span class="hl-1">.</span><span class="hl-5">viewLayers</span><span class="hl-1">.</span><span class="hl-4">forEach</span><span class="hl-1">((</span><span class="hl-5">layer</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">`图层名称: </span><span class="hl-8">${</span><span class="hl-5">layer</span><span class="hl-12">.</span><span class="hl-5">name</span><span class="hl-8">}</span><span class="hl-10">, 类型: </span><span class="hl-8">${</span><span class="hl-5">layer</span><span class="hl-12">.</span><span class="hl-5">type</span><span class="hl-8">}</span><span class="hl-10">`</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">layer</span><span class="hl-1">.</span><span class="hl-5">type</span><span class="hl-1"> === </span><span class="hl-10">&#39;mesh&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-7">// 对网格层做特殊处理</span><br/><span class="hl-1">    </span><span class="hl-5">layer</span><span class="hl-1">.</span><span class="hl-5">visible</span><span class="hl-1"> = </span><span class="hl-8">true</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="common-pitfalls" class="tsd-anchor-link">Common Pitfalls<a href="#common-pitfalls" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>

package/docs/documents/features_move-pano-effect.html CHANGED Viewed

@@ -12,12 +12,12 @@
 <p><strong>Definition</strong>: <a href="../../five/types/movePanoEffect.d.ts">MovePanoEffect</a></p>
 </blockquote>
 <p><code>effect</code> 参数定义了全景切换的动画模式。</p>
-<pre><code class="typescript"><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">MovePanoEffect</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;fly&quot;</span><span class="hl-1">      </span><span class="hl-8">// 飞行效果 (默认)：模拟相机在空间中的移动</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;instant&quot;</span><span class="hl-1">  </span><span class="hl-8">// 瞬间切换：无动画，直接跳变</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;fade&quot;</span><span class="hl-1">     </span><span class="hl-8">// 淡入淡出：原场景渐隐，新场景渐现 (位置保持不变)</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;montage&quot;</span><span class="hl-1">  </span><span class="hl-8">// 蒙太奇：通过黑屏过渡 (渐变穿插到黑屏再亮起)</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;spread&quot;</span><span class="hl-1">   </span><span class="hl-8">// 扩散：新场景从中心向四周扩散</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;zoomin&quot;</span><span class="hl-1">   </span><span class="hl-8">// 放大：新场景从小放大覆盖</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;zoomout&quot;</span><span class="hl-1">  </span><span class="hl-8">// 缩小：原场景缩小消失</span><br/><span class="hl-1">  | </span><span class="hl-9">&quot;model&quot;</span><span class="hl-1">;   </span><span class="hl-8">// 模型过渡：切换过程中展示 3D 模型结构</span>
+<pre><code class="typescript"><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">MovePanoEffect</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;fly&quot;</span><span class="hl-1">      </span><span class="hl-7">// 飞行效果 (默认)：模拟相机在空间中的移动</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;instant&quot;</span><span class="hl-1">  </span><span class="hl-7">// 瞬间切换：无动画，直接跳变</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;fade&quot;</span><span class="hl-1">     </span><span class="hl-7">// 淡入淡出：原场景渐隐，新场景渐现 (位置保持不变)</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;montage&quot;</span><span class="hl-1">  </span><span class="hl-7">// 蒙太奇：通过黑屏过渡 (渐变穿插到黑屏再亮起)</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;spread&quot;</span><span class="hl-1">   </span><span class="hl-7">// 扩散：新场景从中心向四周扩散</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;zoomin&quot;</span><span class="hl-1">   </span><span class="hl-7">// 放大：新场景从小放大覆盖</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;zoomout&quot;</span><span class="hl-1">  </span><span class="hl-7">// 缩小：原场景缩小消失</span><br/><span class="hl-1">  | </span><span class="hl-10">&quot;model&quot;</span><span class="hl-1">;   </span><span class="hl-7">// 模型过渡：切换过程中展示 3D 模型结构</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="effecteasing" class="tsd-anchor-link">effectEasing<a href="#effecteasing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p><code>effectEasing</code> 是一个函数，用于控制前后全景图的混合进度。</p>
-<pre><code class="typescript"><span class="hl-8">// 输入 0-1 的进度值，返回 0-1 的混合比例</span><br/><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">EffectEasing</span><span class="hl-1"> = (</span><span class="hl-6">progress</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> </span><span class="hl-7">number</span><span class="hl-1">;</span>
+<pre><code class="typescript"><span class="hl-7">// 输入 0-1 的进度值，返回 0-1 的混合比例</span><br/><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">EffectEasing</span><span class="hl-1"> = (</span><span class="hl-5">progress</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> </span><span class="hl-9">number</span><span class="hl-1">;</span>
 </code><button type="button">Copy</button></pre>
 <ul>
@@ -47,17 +47,17 @@
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="1-基础用法-basic-usage" class="tsd-anchor-link">1. 基础用法 (Basic Usage)<a href="#1-基础用法-basic-usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>使用不同的 <code>effect</code> 进行切换。</p>
-<pre><code class="typescript"><span class="hl-8">// 1. 飞行模式 (默认)</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">1</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">duration:</span><span class="hl-1"> </span><span class="hl-11">1500</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-8">// 2. 瞬间切换 (无动画)</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">2</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;instant&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-8">// 3. 淡入淡出 (适用于远距离切换)</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">10</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;fade&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">duration:</span><span class="hl-1"> </span><span class="hl-11">1000</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-7">// 1. 飞行模式 (默认)</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">moveToPano</span><span class="hl-1">(</span><span class="hl-3">1</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">effect:</span><span class="hl-1"> </span><span class="hl-10">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">duration:</span><span class="hl-1"> </span><span class="hl-3">1500</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-7">// 2. 瞬间切换 (无动画)</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">moveToPano</span><span class="hl-1">(</span><span class="hl-3">2</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">effect:</span><span class="hl-1"> </span><span class="hl-10">&#39;instant&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-7">// 3. 淡入淡出 (适用于远距离切换)</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">moveToPano</span><span class="hl-1">(</span><span class="hl-3">10</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">effect:</span><span class="hl-1"> </span><span class="hl-10">&#39;fade&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">duration:</span><span class="hl-1"> </span><span class="hl-3">1000</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-自定义缓动-custom-easing" class="tsd-anchor-link">2. 自定义缓动 (Custom Easing)<a href="#2-自定义缓动-custom-easing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>使用 <code>effectEasing</code> 控制混合节奏。</p>
-<pre><code class="typescript"><span class="hl-8">// 示例：Ease-In-Quad (先慢后快)</span><br/><span class="hl-3">function</span><span class="hl-1"> </span><span class="hl-5">easeInQuad</span><span class="hl-1">(</span><span class="hl-6">x</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">): </span><span class="hl-7">number</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-6">x</span><span class="hl-1"> * </span><span class="hl-6">x</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-11">5</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">duration:</span><span class="hl-1"> </span><span class="hl-11">2000</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-8">// 自定义混合曲线</span><br/><span class="hl-1">  </span><span class="hl-6">effectEasing:</span><span class="hl-1"> </span><span class="hl-6">easeInQuad</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-7">// 示例：Ease-In-Quad (先慢后快)</span><br/><span class="hl-8">function</span><span class="hl-1"> </span><span class="hl-4">easeInQuad</span><span class="hl-1">(</span><span class="hl-5">x</span><span class="hl-1">: </span><span class="hl-9">number</span><span class="hl-1">): </span><span class="hl-9">number</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-5">x</span><span class="hl-1"> * </span><span class="hl-5">x</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">moveToPano</span><span class="hl-1">(</span><span class="hl-3">5</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">effect:</span><span class="hl-1"> </span><span class="hl-10">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">duration:</span><span class="hl-1"> </span><span class="hl-3">2000</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-7">// 自定义混合曲线</span><br/><span class="hl-1">  </span><span class="hl-5">effectEasing:</span><span class="hl-1"> </span><span class="hl-5">easeInQuad</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="3-高级缓动控制-advanced-easing" class="tsd-anchor-link">3. 高级缓动控制 (Advanced Easing)<a href="#3-高级缓动控制-advanced-easing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>在某些特殊场景（如从地面点切换到航拍点），我们可能希望前 80% 的时间都显示地面点，最后 20% 才快速过渡到航拍图。</p>
-<pre><code class="typescript"><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">moveToPano</span><span class="hl-1">(</span><span class="hl-6">aerialPanoIndex</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">effect:</span><span class="hl-1"> </span><span class="hl-9">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">duration:</span><span class="hl-1"> </span><span class="hl-11">3000</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">effectEasing</span><span class="hl-6">:</span><span class="hl-1"> (</span><span class="hl-6">progress</span><span class="hl-1">) </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-8">// 0 - 0.8 期间返回 0 (显示原图)</span><br/><span class="hl-1">    </span><span class="hl-8">// 0.8 - 1.0 期间线性过渡到 1</span><br/><span class="hl-1">    </span><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">progress</span><span class="hl-1"> &lt; </span><span class="hl-11">0.8</span><span class="hl-1">) </span><span class="hl-10">return</span><span class="hl-1"> </span><span class="hl-11">0</span><span class="hl-1">;</span><br/><span class="hl-1">    </span><span class="hl-10">return</span><span class="hl-1"> (</span><span class="hl-6">progress</span><span class="hl-1"> - </span><span class="hl-11">0.8</span><span class="hl-1">) / </span><span class="hl-11">0.2</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">moveToPano</span><span class="hl-1">(</span><span class="hl-5">aerialPanoIndex</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">effect:</span><span class="hl-1"> </span><span class="hl-10">&#39;fly&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">duration:</span><span class="hl-1"> </span><span class="hl-3">3000</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">effectEasing</span><span class="hl-5">:</span><span class="hl-1"> (</span><span class="hl-5">progress</span><span class="hl-1">) </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-7">// 0 - 0.8 期间返回 0 (显示原图)</span><br/><span class="hl-1">    </span><span class="hl-7">// 0.8 - 1.0 期间线性过渡到 1</span><br/><span class="hl-1">    </span><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">progress</span><span class="hl-1"> &lt; </span><span class="hl-3">0.8</span><span class="hl-1">) </span><span class="hl-11">return</span><span class="hl-1"> </span><span class="hl-3">0</span><span class="hl-1">;</span><br/><span class="hl-1">    </span><span class="hl-11">return</span><span class="hl-1"> (</span><span class="hl-5">progress</span><span class="hl-1"> - </span><span class="hl-3">0.8</span><span class="hl-1">) / </span><span class="hl-3">0.2</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>

package/docs/documents/features_multi-work.html CHANGED Viewed

@@ -11,7 +11,7 @@
 <p><strong>Definition</strong>: <a href="../../five/application/fiveLoadOptions.d.ts">FiveLoadOptions</a>, <a href="../../five/work/looseWorkType.d.ts">LooseWorkWithExtrinsics</a></p>
 </blockquote>
 <h3 id="核心类型定义" class="tsd-anchor-link">核心类型定义<a href="#核心类型定义" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
-<pre><code class="typescript"><span class="hl-8">// 输入数据类型</span><br/><span class="hl-3">type</span><span class="hl-1"> </span><span class="hl-7">FiveLoadInput</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-7">Work</span><span class="hl-1">[]</span><br/><span class="hl-1">  | </span><span class="hl-7">LooseWorkWithExtrinsics</span><span class="hl-1">[]</span><br/><span class="hl-1">  | </span><span class="hl-7">string</span><span class="hl-1">[]; </span><span class="hl-8">// JSON Strings</span><br/><br/><span class="hl-8">// 带位姿信息的 LooseWork (用于调整模型在场景中的位置)</span><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">LooseWorkWithExtrinsics</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">work</span><span class="hl-1">: </span><span class="hl-7">LooseWork</span><span class="hl-1">;      </span><span class="hl-8">// Work 数据内容</span><br/><span class="hl-1">  </span><span class="hl-6">transform</span><span class="hl-1">?: </span><span class="hl-7">number</span><span class="hl-1">[]; </span><span class="hl-8">// 4x4 变换矩阵 (数组格式), 用于整体偏移/旋转该 Work</span><br/><span class="hl-1">  </span><span class="hl-6">workCode</span><span class="hl-1">?: </span><span class="hl-7">string</span><span class="hl-1">;    </span><span class="hl-8">// 强制指定 WorkCode (覆盖数据中的默认值)</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-8">// 加载选项</span><br/><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">FiveLoadOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">mode</span><span class="hl-1">?: </span><span class="hl-9">&quot;replace&quot;</span><span class="hl-1"> | </span><span class="hl-9">&quot;add&quot;</span><span class="hl-1">; </span><span class="hl-8">// 替换当前场景 vs 追加到当前场景</span><br/><span class="hl-1">  </span><span class="hl-8">// ... 其他常规选项</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-7">// 输入数据类型</span><br/><span class="hl-8">type</span><span class="hl-1"> </span><span class="hl-9">FiveLoadInput</span><span class="hl-1"> =</span><br/><span class="hl-1">  | </span><span class="hl-9">Work</span><span class="hl-1">[]</span><br/><span class="hl-1">  | </span><span class="hl-9">LooseWorkWithExtrinsics</span><span class="hl-1">[]</span><br/><span class="hl-1">  | </span><span class="hl-9">string</span><span class="hl-1">[]; </span><span class="hl-7">// JSON Strings</span><br/><br/><span class="hl-7">// 带位姿信息的 LooseWork (用于调整模型在场景中的位置)</span><br/><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">LooseWorkWithExtrinsics</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">work</span><span class="hl-1">: </span><span class="hl-9">LooseWork</span><span class="hl-1">;      </span><span class="hl-7">// Work 数据内容</span><br/><span class="hl-1">  </span><span class="hl-5">transform</span><span class="hl-1">?: </span><span class="hl-9">number</span><span class="hl-1">[]; </span><span class="hl-7">// 4x4 变换矩阵 (数组格式), 用于整体偏移/旋转该 Work</span><br/><span class="hl-1">  </span><span class="hl-5">workCode</span><span class="hl-1">?: </span><span class="hl-9">string</span><span class="hl-1">;    </span><span class="hl-7">// 强制指定 WorkCode (覆盖数据中的默认值)</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-7">// 加载选项</span><br/><span class="hl-8">interface</span><span class="hl-1"> </span><span class="hl-9">FiveLoadOptions</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">mode</span><span class="hl-1">?: </span><span class="hl-10">&quot;replace&quot;</span><span class="hl-1"> | </span><span class="hl-10">&quot;add&quot;</span><span class="hl-1">; </span><span class="hl-7">// 替换当前场景 vs 追加到当前场景</span><br/><span class="hl-1">  </span><span class="hl-7">// ... 其他常规选项</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="concepts" class="tsd-anchor-link">Concepts<a href="#concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
@@ -55,22 +55,22 @@
 <h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <h3 id="1-基础加载-basic-loading" class="tsd-anchor-link">1. 基础加载 (Basic Loading)<a href="#1-基础加载-basic-loading" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>一次性加载两个 Work。</p>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">works</span><span class="hl-1"> = [</span><span class="hl-6">workDataA</span><span class="hl-1">, </span><span class="hl-6">workDataB</span><span class="hl-1">];</span><br/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">works</span><span class="hl-1">).</span><span class="hl-5">then</span><span class="hl-1">(() </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;所有 Work 加载完成&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;当前 Works:&quot;</span><span class="hl-1">, </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">works</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">works</span><span class="hl-1"> = [</span><span class="hl-5">workDataA</span><span class="hl-1">, </span><span class="hl-5">workDataB</span><span class="hl-1">];</span><br/><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">works</span><span class="hl-1">).</span><span class="hl-4">then</span><span class="hl-1">(() </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;所有 Work 加载完成&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;当前 Works:&quot;</span><span class="hl-1">, </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">works</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="2-沙盘排布-sandbox-layout" class="tsd-anchor-link">2. 沙盘排布 (Sandbox Layout)<a href="#2-沙盘排布-sandbox-layout" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>使用 <code>transform</code> 将两个户型并排摆放。</p>
-<pre><code class="typescript"><span class="hl-10">import</span><span class="hl-1"> </span><span class="hl-3">*</span><span class="hl-1"> </span><span class="hl-10">as</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1"> </span><span class="hl-10">from</span><span class="hl-1"> </span><span class="hl-9">&quot;three&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 创建变换矩阵：向 X 轴正方向平移 20 米</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">matrixB</span><span class="hl-1"> = </span><span class="hl-3">new</span><span class="hl-1"> </span><span class="hl-4">THREE</span><span class="hl-1">.</span><span class="hl-5">Matrix4</span><span class="hl-1">().</span><span class="hl-5">makeTranslation</span><span class="hl-1">(</span><span class="hl-11">20</span><span class="hl-1">, </span><span class="hl-11">0</span><span class="hl-1">, </span><span class="hl-11">0</span><span class="hl-1">);</span><br/><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">input</span><span class="hl-1"> = [</span><br/><span class="hl-1">  </span><span class="hl-8">// Work A: 保持在原点</span><br/><span class="hl-1">  { </span><span class="hl-6">work:</span><span class="hl-1"> </span><span class="hl-6">workDataA</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-8">// Work B: 偏移位置</span><br/><span class="hl-1">  {</span><br/><span class="hl-1">    </span><span class="hl-6">work:</span><span class="hl-1"> </span><span class="hl-6">workDataB</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-6">transform:</span><span class="hl-1"> </span><span class="hl-6">matrixB</span><span class="hl-1">.</span><span class="hl-5">toArray</span><span class="hl-1">()</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">];</span><br/><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">input</span><span class="hl-1">);</span>
+<pre><code class="typescript"><span class="hl-11">import</span><span class="hl-1"> </span><span class="hl-8">*</span><span class="hl-1"> </span><span class="hl-11">as</span><span class="hl-1"> </span><span class="hl-5">THREE</span><span class="hl-1"> </span><span class="hl-11">from</span><span class="hl-1"> </span><span class="hl-10">&quot;three&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 创建变换矩阵：向 X 轴正方向平移 20 米</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">matrixB</span><span class="hl-1"> = </span><span class="hl-8">new</span><span class="hl-1"> </span><span class="hl-6">THREE</span><span class="hl-1">.</span><span class="hl-4">Matrix4</span><span class="hl-1">().</span><span class="hl-4">makeTranslation</span><span class="hl-1">(</span><span class="hl-3">20</span><span class="hl-1">, </span><span class="hl-3">0</span><span class="hl-1">, </span><span class="hl-3">0</span><span class="hl-1">);</span><br/><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">input</span><span class="hl-1"> = [</span><br/><span class="hl-1">  </span><span class="hl-7">// Work A: 保持在原点</span><br/><span class="hl-1">  { </span><span class="hl-5">work:</span><span class="hl-1"> </span><span class="hl-5">workDataA</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-7">// Work B: 偏移位置</span><br/><span class="hl-1">  {</span><br/><span class="hl-1">    </span><span class="hl-5">work:</span><span class="hl-1"> </span><span class="hl-5">workDataB</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-5">transform:</span><span class="hl-1"> </span><span class="hl-5">matrixB</span><span class="hl-1">.</span><span class="hl-4">toArray</span><span class="hl-1">()</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">];</span><br/><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">input</span><span class="hl-1">);</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="3-动态添加-dynamic-add" class="tsd-anchor-link">3. 动态添加 (Dynamic Add)<a href="#3-动态添加-dynamic-add" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>在不销毁当前场景的情况下，追加一个新的 Work。</p>
-<pre><code class="typescript"><span class="hl-8">// 假设当前已经加载了 Work A</span><br/><span class="hl-8">// 追加 Work C</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">load</span><span class="hl-1">(</span><span class="hl-6">workDataC</span><span class="hl-1">, </span><span class="hl-3">undefined</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&quot;add&quot;</span><span class="hl-1"> </span><span class="hl-8">// 关键参数</span><br/><span class="hl-1">}).</span><span class="hl-5">then</span><span class="hl-1">(() </span><span class="hl-3">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">console</span><span class="hl-1">.</span><span class="hl-5">log</span><span class="hl-1">(</span><span class="hl-9">&quot;Work C 已加入场景&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+<pre><code class="typescript"><span class="hl-7">// 假设当前已经加载了 Work A</span><br/><span class="hl-7">// 追加 Work C</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">load</span><span class="hl-1">(</span><span class="hl-5">workDataC</span><span class="hl-1">, </span><span class="hl-8">undefined</span><span class="hl-1">, {</span><br/><span class="hl-1">  </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&quot;add&quot;</span><span class="hl-1"> </span><span class="hl-7">// 关键参数</span><br/><span class="hl-1">}).</span><span class="hl-4">then</span><span class="hl-1">(() </span><span class="hl-8">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-5">console</span><span class="hl-1">.</span><span class="hl-4">log</span><span class="hl-1">(</span><span class="hl-10">&quot;Work C 已加入场景&quot;</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
 </code><button type="button">Copy</button></pre>
 <h3 id="4-work-间切换-switching-works" class="tsd-anchor-link">4. Work 间切换 (Switching Works)<a href="#4-work-间切换-switching-works" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
 <p>跳转到指定 Work 的特定点位。</p>
-<pre><code class="typescript"><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">targetWorkCode</span><span class="hl-1"> = </span><span class="hl-9">&quot;work-id-b&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-8">// 方式一：指定点位索引</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-5">setState</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-6">workCode:</span><span class="hl-1"> </span><span class="hl-6">targetWorkCode</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-6">panoIndex:</span><span class="hl-1"> </span><span class="hl-11">0</span><span class="hl-1">, </span><span class="hl-8">// 目标 Work 的第 0 个点位</span><br/><span class="hl-1">  </span><span class="hl-6">mode:</span><span class="hl-1"> </span><span class="hl-9">&quot;Panorama&quot;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-8">// 方式二：查找特定 Work</span><br/><span class="hl-3">const</span><span class="hl-1"> </span><span class="hl-4">targetWork</span><span class="hl-1"> = </span><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">works</span><span class="hl-1">.</span><span class="hl-5">getWork</span><span class="hl-1">(</span><span class="hl-6">targetWorkCode</span><span class="hl-1">);</span><br/><span class="hl-10">if</span><span class="hl-1"> (</span><span class="hl-6">targetWork</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-8">// 你的业务逻辑</span><br/><span class="hl-1">}</span>
+<pre><code class="typescript"><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">targetWorkCode</span><span class="hl-1"> = </span><span class="hl-10">&quot;work-id-b&quot;</span><span class="hl-1">;</span><br/><br/><span class="hl-7">// 方式一：指定点位索引</span><br/><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-4">setState</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">workCode:</span><span class="hl-1"> </span><span class="hl-5">targetWorkCode</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-5">panoIndex:</span><span class="hl-1"> </span><span class="hl-3">0</span><span class="hl-1">, </span><span class="hl-7">// 目标 Work 的第 0 个点位</span><br/><span class="hl-1">  </span><span class="hl-5">mode:</span><span class="hl-1"> </span><span class="hl-10">&quot;Panorama&quot;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-7">// 方式二：查找特定 Work</span><br/><span class="hl-8">const</span><span class="hl-1"> </span><span class="hl-6">targetWork</span><span class="hl-1"> = </span><span class="hl-5">five</span><span class="hl-1">.</span><span class="hl-5">works</span><span class="hl-1">.</span><span class="hl-4">getWork</span><span class="hl-1">(</span><span class="hl-5">targetWorkCode</span><span class="hl-1">);</span><br/><span class="hl-11">if</span><span class="hl-1"> (</span><span class="hl-5">targetWork</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-7">// 你的业务逻辑</span><br/><span class="hl-1">}</span>
 </code><button type="button">Copy</button></pre>
 <h2 id="common-pitfalls" class="tsd-anchor-link">Common Pitfalls<a href="#common-pitfalls" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>