@yangyongtao/gaea 1.0.0 → 1.0.2

package/package.json

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

package/src/GaeaMethods.js

@@ -48,6 +48,42 @@ function rgbToGaeaColor(rgb) {
 }
 
 
+// ==================== Gaea 检查 ====================
+
+function checkGaea() {
+  const G = window.Gaea;
+  if (!G || !G.World || !G.World.Instance) {
+    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 类 ====================
 
 import { Tween, Group, Easing } from '@tweenjs/tween.js';
@@ -81,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);
+  }
+
   // ==================== 点标注 ====================
 
   /**
@@ -94,7 +139,8 @@ export class GaeaApp {
       return null;
     }
 
-    const Gaea = window.Gaea;
+    const Gaea = checkGaea();
+    if (!Gaea) return null;
     const resName = 'pointIcon.res';
 
     if (!this._pointIconLoaded) {
@@ -156,7 +202,8 @@ export class GaeaApp {
    * @param {Object} opts - { height, step, duration, xrotation, lockEye, minZoom, maxZoom }
    */
   async flyAlongPath(lineData, opts = {}) {
-    const Gaea = window.Gaea;
+    const Gaea = checkGaea();
+    if (!Gaea) return Promise.reject(new Error('Gaea 未加载'));
     const {
       height = 150, step = 1000, duration = 20,
       xrotation = -30, lockEye = true, minZoom = 0, maxZoom = 400
@@ -264,6 +311,10 @@ export class GaeaApp {
   _initWeather() {
     if (this._weatherInited) return;
     const Gaea = window.Gaea;
+    if (!Gaea || !Gaea.World || !Gaea.World.Instance) {
+      console.warn('Gaea 尚未加载完毕，无法初始化天气');
+      return;
+    }
     this._fullScreenQuad = Gaea.World.Instance.FullScreenQuad;
     this._sky = Gaea.MeshInstance.ConvertBy(Gaea.World.Instance.GetNode('Sky'));
     this._sun = Gaea.Sun.ConvertBy(Gaea.World.Instance.GetNode('Sun'));
@@ -335,6 +386,10 @@ export class GaeaApp {
   /** 初始化基础环境（关闭默认雾、设置默认光照等） */
   initDefaultEnvironment() {
     const Gaea = window.Gaea;
+    if (!Gaea || !Gaea.World || !Gaea.World.Instance) {
+      console.warn('Gaea 尚未加载完毕，请确保在 Gaea 初始化之后调用此方法');
+      return;
+    }
 
     // 关闭默认雾
     const fogEnv = Gaea.Environment.ConvertBy(