cesium-xs-sdk 1.0.10 → 1.0.11

package/dist/cesium-xs-sdk.cjs.js

@@ -95,6 +95,10 @@ class Config {
                 navigationInstructionsInitiallyVisible: false,
                 depthTestAgainstTerrain: true, // 默认开启深度检测
             },
+            // 军标模块默认配置
+            militarySymbol: {
+                defaultIconMode: 'default', // 'default' | 'custom' | 'overlay'
+            },
             // 图元默认样式：延迟到 getConfig 时再构造，避免在 Cesium 未配置时崩溃
             // （对 SSR 和单元测试更友好）
         };
@@ -9240,6 +9244,39 @@ class MilitarySymbolModule {
         return this;
     }
 
+    /**
+     * 设置全局默认图标模式
+     * @param {'default'|'custom'|'overlay'} mode 默认图标模式
+     * @returns {MilitarySymbolModule}
+     */
+    setDefaultIconMode(mode) {
+        this._defaultIconMode = mode;
+        return this;
+    }
+
+    /**
+     * 注册某个军标类型的默认图标
+     * @param {string} type 军标类型
+     * @param {string} imgUrl 图标 URL / dataURL
+     * @returns {MilitarySymbolModule}
+     */
+    registerDefaultImage(type, imgUrl) {
+        this.defaultImageMap.set(type, imgUrl);
+        return this;
+    }
+
+    /**
+     * 批量注册军标默认图标
+     * @param {Record<string, string>} map { type: imgUrl }
+     * @returns {MilitarySymbolModule}
+     */
+    registerDefaultImages(map) {
+        Object.entries(map).forEach(([type, imgUrl]) => {
+            this.registerDefaultImage(type, imgUrl);
+        });
+        return this;
+    }
+
     /**
      * 解析军标图标
      * - iconMode = 'default'：使用 SDK 内置默认图标；没有默认图标时回退到 imgUrl
@@ -9248,23 +9285,27 @@ class MilitarySymbolModule {
      * @private
      */
     _resolveImage(id, options) {
-        const mode = options.iconMode || 'default';
+        const globalMode = this._defaultIconMode || this.config.militarySymbol?.defaultIconMode;
+        const mode = options.iconMode || globalMode || 'default';
         const defaultImage = DEFAULT_SYMBOL_IMAGES[options.type];
+        const registeredImage = this.defaultImageMap.get(options.type);
+        const imgUrl = options.imgUrl || registeredImage || null;
 
         if (mode === 'custom') {
-            if (!options.imgUrl) {
-                console.warn(`iconMode 为 custom 时需提供 imgUrl，将尝试使用默认图标`);
+            if (!imgUrl) {
+                console.warn(`iconMode 为 custom 时未找到可用图标，将尝试使用默认图标`);
                 return defaultImage || null;
             }
-            return options.imgUrl;
+            return imgUrl;
         }
 
         if (mode === 'overlay') {
-            if (!options.imgUrl || !defaultImage) {
-                return options.imgUrl || defaultImage || null;
+            const overlayImage = imgUrl;
+            if (!overlayImage || !defaultImage) {
+                return overlayImage || defaultImage || null;
             }
             // 异步合成叠加图标，创建时先返回默认图标，合成完成后再替换
-            this._composeOverlayImage(defaultImage, options.imgUrl).then((compositeUrl) => {
+            this._composeOverlayImage(defaultImage, overlayImage).then((compositeUrl) => {
                 const symbol = this.symbolMap.get(id);
                 if (symbol?.entity?.billboard) {
                     symbol.entity.billboard.image = compositeUrl;
@@ -9275,13 +9316,11 @@ class MilitarySymbolModule {
             return defaultImage;
         }
 
-        // 默认模式
-        if (!defaultImage) {
-            if (options.imgUrl) return options.imgUrl;
-            console.warn(`军标类型 ${options.type} 未提供图标，也未找到内置默认图标`);
-            return null;
-        }
-        return defaultImage;
+        // 默认模式：优先 SDK 内置图标，其次注册图标 / imgUrl
+        if (defaultImage) return defaultImage;
+        if (imgUrl) return imgUrl;
+        console.warn(`军标类型 ${options.type} 未提供图标，也未找到内置默认图标`);
+        return null;
     }
 
     /**