@yangyongtao/gaea 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangyongtao/gaea",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Gaea 3D 可视化组件库，包含天气控制、沿线飞行、台风标注、模型加载等功能",
   "type": "module",
   "main": "src/index.js",

package/src/GaeaMethods.js

@@ -53,12 +53,36 @@ function rgbToGaeaColor(rgb) {
 function checkGaea() {
   const G = window.Gaea;
   if (!G || !G.World || !G.World.Instance) {
-    console.warn('Gaea 尚未加载完毕，请确保在 Gaea 初始化之后再调用此方法');
+    console.warn('Gaea 尚未加载完毕，请先调用 await GaeaApp.waitForReady()');
     return null;
   }
   return G;
 }
 
+/**
+ * 等待 Gaea 引擎初始化完毕（轮询 World.Instance）
+ * @param {number} timeout - 超时毫秒数，默认 30000
+ * @returns {Promise<boolean>}
+ */
+async function waitForGaea(timeout = 30000) {
+  if (window.Gaea && window.Gaea.World && window.Gaea.World.Instance) {
+    return true;
+  }
+  const start = Date.now();
+  return new Promise((resolve) => {
+    const timer = setInterval(() => {
+      if (window.Gaea && window.Gaea.World && window.Gaea.World.Instance) {
+        clearInterval(timer);
+        resolve(true);
+      } else if (Date.now() - start > timeout) {
+        clearInterval(timer);
+        console.error('Gaea 初始化超时');
+        resolve(false);
+      }
+    }, 200);
+  });
+}
+
 
 // ==================== GaeaApp 类 ====================
 
@@ -93,6 +117,15 @@ export class GaeaApp {
     this._tweenGroup = new Group();
   }
 
+  /**
+   * 静态方法：等待 Gaea 引擎就绪
+   * @example await GaeaApp.waitForReady(); // 30s 超时
+   * @example await GaeaApp.waitForReady(60000); // 自定义超时
+   */
+  static waitForReady(timeout) {
+    return waitForGaea(timeout);
+  }
+
   // ==================== 点标注 ====================
 
   /**
@@ -351,13 +384,16 @@ export class GaeaApp {
   }
 
   /** 初始化基础环境（关闭默认雾、设置默认光照等） */
-  initDefaultEnvironment() {
-    const Gaea = window.Gaea;
-    if (!Gaea || !Gaea.World || !Gaea.World.Instance) {
-      console.warn('Gaea 尚未加载完毕，请确保在 Gaea 初始化之后调用此方法');
+  async initDefaultEnvironment() {
+    // 等待 Gaea 就绪
+    const ready = await waitForGaea(15000);
+    if (!ready) {
+      console.error('Gaea 引擎初始化超时');
       return;
     }
 
+    const Gaea = window.Gaea;
+
     // 关闭默认雾
     const fogEnv = Gaea.Environment.ConvertBy(
       Gaea.GaeaResourceLoader.Instance.LoadLoaclResource('res://default_env.tres')