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

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`: 即将发生点位变更（旧版兼容）。