@realsee/five 6.8.0-alpha.26 → 6.8.0-alpha.28

package/ai_guides/features/event.md

@@ -131,15 +131,20 @@ five.on("pano.prepare", (event) => {
   );
 });
 
-// 示例：结合 preventDefault 和 waitUntil 实现条件拦截
-five.on("pano.prepare", async (event) => {
-  const allowed = await checkPermission(event.pano);
-  if (!allowed) {
-    event.preventDefault();
-  }
+// 示例：通过 waitUntil reject 来取消走点
+five.on("pano.prepare", (event) => {
+  event.waitUntil(
+    showConfirmDialog("是否前往该点位？").then((confirmed) => {
+      if (!confirmed) {
+        throw new Error("用户取消走点");
+      }
+    })
+  );
 });
 ```
 
+> **注意**: `preventDefault` 和 `waitUntil` 必须在事件回调的同步执行阶段调用，不能放在 `await` 之后。
+
 ## Concepts
 
 Five 的事件系统将事件主要分为以下几类：
@@ -158,7 +163,7 @@ Five 的事件系统将事件主要分为以下几类：
 ### Pano Events (全景导航)
 监听全景图的点位切换过程。
 
-- `pano.prepare`: 准备切换到新点位。这是一个 `ExtendableEvent`，支持通过 `waitUntil(promise)` 延迟后续加载流程（如预加载资源）。
+- `pano.prepare`: 准备切换到新点位。这是一个 `ExtendableEvent`，支持通过 `waitUntil(promise)` 延迟后续加载流程（如预加载资源），以及通过 `preventDefault()` 取消本次走点。
 - `pano.arrived`: 成功到达新点位（移动动画结束）。
 - `pano.moving`: 正在移动到新点位（动画进行中）。
 - `pano.willChange`: 即将发生点位变更（旧版兼容）。

package/ai_guides/features/load-external-model.md

@@ -80,6 +80,7 @@ Five 使用 **Z-up** (Z 轴向上) 的右手坐标系。
 *   `REALSEE_materials_lightmap`
 *   `KHR_gaussian_splatting`
 *   `KHR_gaussian_splatting_compression_spz`
+*   `KHR_gaussian_splatting_compression_spz_2`
 
 | 参数 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |

package/ai_guides/release_notes/6.8.md

@@ -12,7 +12,7 @@ npm install @realsee/five@6.8
 ### 文件格式支持
   1. `.splat` 文档及工具 [GitHub - antimatter15/splat: WebGL 3D Gaussian Splat Viewer](https://github.com/antimatter15/splat)
   2. `.spz` 文档及工具 GitHub - [nianticlabs/spz: File format for 3D Gaussian splats. About 10x smaller than the PLY equival](https://github.com/nianticlabs/spz)
-  3. `.glb` `.gltf` 对应的  KHR_gaussian_splatting_compression_spz 扩展。
+  3. `.glb` `.gltf` 对应的 KHR_gaussian_splatting, KHR_gaussian_splatting_compression_spz, KHR_gaussian_splatting_compression_spz_2 扩展。
 
 ### 支持 3d-tile
 > 通过 3d-tile 标准，使用 glb 作为模型格式。