@kimap/indoor-positioning-sdk-vue2 4.2.9 → 4.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kimap/indoor-positioning-sdk-vue2",
-  "version": "4.2.9",
+  "version": "4.3.2",
   "description": "Vue2自包含室内定位SDK - 完全兼容Webpack3+Babel6 | Vue2 Self-Contained Indoor Positioning SDK",
   "main": "index.js",
   "files": [

package/src/KimapCore.browser.js

@@ -193,6 +193,90 @@
     return colorMap;
   }
 
+  // 从OBJ内容中提取文本元素
+  function extractTextElementsFromOBJ(objContent) {
+    var textElements = [];
+    var lines = objContent.split('\n');
+    var currentText = null;
+    
+    for (var i = 0; i < lines.length; i++) {
+      var line = lines[i].trim();
+      
+      if (line.indexOf('# ===== Text Element =====') === 0) {
+        currentText = {};
+      } else if (line.indexOf('# ===== End Text Element =====') === 0 && currentText) {
+        textElements.push(currentText);
+        currentText = null;
+      } else if (currentText) {
+        if (line.indexOf('# TEXT_ID') === 0) {
+          currentText.id = line.split(' ')[2];
+        } else if (line.indexOf('# TEXT_CONTENT') === 0) {
+          currentText.content = line.substring(line.indexOf('TEXT_CONTENT') + 13).trim();
+        } else if (line.indexOf('# TEXT_POSITION') === 0) {
+          var parts = line.split(' ');
+          currentText.points = [{ x: parseFloat(parts[2]), y: parseFloat(parts[3]) }];
+        } else if (line.indexOf('# TEXT_ELEVATION') === 0) {
+          currentText.elevation = parseFloat(line.split(' ')[2]);
+        } else if (line.indexOf('# TEXT_FONT_SIZE') === 0) {
+          currentText.fontSize = parseFloat(line.split(' ')[2]);
+        } else if (line.indexOf('# TEXT_COLOR') === 0) {
+          currentText.color = line.split(' ')[2];
+        } else if (line.indexOf('# TEXT_FONT_FAMILY') === 0) {
+          currentText.fontFamily = line.substring(line.indexOf('TEXT_FONT_FAMILY') + 17).trim();
+        } else if (line.indexOf('# TEXT_BOLD') === 0) {
+          currentText.bold = line.split(' ')[2] === 'true';
+        } else if (line.indexOf('# TEXT_ITALIC') === 0) {
+          currentText.italic = line.split(' ')[2] === 'true';
+        } else if (line.indexOf('# TEXT_BORDER_COLOR') === 0) {
+          currentText.borderColor = line.split(' ')[2];
+        } else if (line.indexOf('# TEXT_BG_COLOR') === 0) {
+          currentText.backgroundColor = line.split(' ')[2];
+        } else if (line.indexOf('# TEXT_BG_OPACITY') === 0) {
+          currentText.backgroundOpacity = parseFloat(line.split(' ')[2]);
+        } else if (line.indexOf('# TEXT_PADDING') === 0) {
+          currentText.padding = parseFloat(line.split(' ')[2]);
+        }
+      }
+    }
+    
+    console.log('[Parsers] 提取到的文本元素:', textElements.length, '个');
+    return textElements;
+  }
+
+  // 从OBJ内容中提取墙体透明度信息
+  function extractWallOpacityFromOBJ(objContent) {
+    var wallOpacity = {};
+    var lines = objContent.split('\n');
+    var currentWallId = null;
+    
+    for (var i = 0; i < lines.length; i++) {
+      var line = lines[i].trim();
+      
+      if (line.indexOf('o Wall_') === 0) {
+        // 提取墙体ID（格式：Wall_<id>_seg<n>）
+        var match = line.match(/Wall_([^_]+)_seg/);
+        if (match) {
+          currentWallId = match[1];
+        }
+      } else if (currentWallId && line.indexOf('# WALL_OPACITY') === 0) {
+        var opacity = parseFloat(line.split(' ')[2]);
+        if (!wallOpacity[currentWallId]) {
+          wallOpacity[currentWallId] = {};
+        }
+        wallOpacity[currentWallId].opacity = opacity;
+      } else if (currentWallId && line.indexOf('# WALL_COLOR') === 0) {
+        var color = line.split(' ')[2];
+        if (!wallOpacity[currentWallId]) {
+          wallOpacity[currentWallId] = {};
+        }
+        wallOpacity[currentWallId].color = color;
+      }
+    }
+    
+    console.log('[Parsers] 提取到的墙体透明度:', Object.keys(wallOpacity).length, '个墙体');
+    return wallOpacity;
+  }
+
   /**
    * 3D 场景核心
    */
@@ -548,9 +632,28 @@
                   console.log('提取到颜色信息:', colorMap);
                 }
                 
+                // 提取文本元素
+                var textElements = extractTextElementsFromOBJ(objContent);
+                if (textElements && textElements.length > 0) {
+                  console.log('✅ 从OBJ提取到文本元素:', textElements.length, '个');
+                  self._textElements = textElements;
+                }
+                
+                // 提取墙体透明度信息
+                var wallOpacity = extractWallOpacityFromOBJ(objContent);
+                if (wallOpacity && Object.keys(wallOpacity).length > 0) {
+                  console.log('✅ 从OBJ提取到墙体透明度:', Object.keys(wallOpacity).length, '个墙体');
+                  self._wallOpacity = wallOpacity;
+                }
+                
                 var object = objLoader.parse(objContent);
                 self.processModel(object, colorMap);
                 
+                // 渲染文本元素
+                if (self._textElements && self._textElements.length > 0) {
+                  self.renderTextElements(self._textElements);
+                }
+                
                 console.log('=== Kimap模型加载成功 ===');
                 self.logModelInfo();
                 resolve();
@@ -595,6 +698,7 @@
   };
 
   SceneCore.prototype.processModel = function(object, colorMap) {
+    var self = this;
     this.mapModel = object;
     colorMap = colorMap || {};
     
@@ -632,6 +736,16 @@
           } else if (child.material.name.startsWith('Wall_')) {
             roughness = 0.25;
             metalness = 0;
+            
+            // 从OBJ提取的墙体透明度数据中读取
+            if (self._wallOpacity) {
+              var wallId = child.material.name.replace('Wall_', '');
+              if (self._wallOpacity[wallId]) {
+                opacity = self._wallOpacity[wallId].opacity;
+                transparent = opacity < 1.0;
+                console.log('[SceneCore] 应用墙体透明度:', wallId, '=', opacity);
+              }
+            }
           } else if (child.material.name.startsWith('Shape_') || 
                      child.material.name.startsWith('Stair_')) {
             roughness = 0.25;
@@ -854,6 +968,183 @@
     this.renderer.setSize(this.container.clientWidth, this.container.clientHeight);
   };
 
+  /**
+   * 创建文本精灵（用于3D场景中显示文本）
+   */
+  SceneCore.prototype.createTextSprite = function(options) {
+    var content = options.content || '';
+    var fontSize = options.fontSize || 16;
+    var color = options.color || '#000000';
+    var fontFamily = options.fontFamily || 'Arial, sans-serif';
+    var bold = options.bold || false;
+    var italic = options.italic || false;
+    var borderColor = options.borderColor || '#87CEEB';
+    var backgroundColor = options.backgroundColor || '#FFFFFF';
+    var backgroundOpacity = options.backgroundOpacity !== undefined ? options.backgroundOpacity : 0.8;
+    var padding = options.padding || 8;
+    
+    // 创建高分辨率canvas用于文本纹理
+    var canvas = document.createElement('canvas');
+    var context = canvas.getContext('2d');
+    
+    // 使用更大的canvas尺寸以提高清晰度
+    canvas.width = 1024;
+    canvas.height = 512;
+    
+    // 配置字体（放大4倍以提高质量）
+    var scaledFontSize = fontSize * 4;
+    var fontStyle = (italic ? 'italic ' : '') + (bold ? 'bold ' : '') + scaledFontSize + 'px ' + fontFamily;
+    context.font = fontStyle;
+    context.textAlign = 'center';
+    context.textBaseline = 'middle';
+    
+    // 测量文本
+    var metrics = context.measureText(content);
+    var textWidth = metrics.width;
+    var textHeight = scaledFontSize * 1.2;
+    
+    // 计算背景尺寸
+    var scaledPadding = padding * 4;
+    var bgWidth = textWidth + scaledPadding * 2;
+    var bgHeight = textHeight + scaledPadding * 2;
+    
+    // 计算居中位置
+    var centerX = canvas.width / 2;
+    var centerY = canvas.height / 2;
+    var bgX = centerX - bgWidth / 2;
+    var bgY = centerY - bgHeight / 2;
+    
+    // 绘制阴影效果以增强可读性
+    context.shadowColor = 'rgba(0, 0, 0, 0.5)';
+    context.shadowBlur = 8;
+    context.shadowOffsetX = 2;
+    context.shadowOffsetY = 2;
+    
+    // 绘制背景
+    context.fillStyle = backgroundColor;
+    context.globalAlpha = Math.max(backgroundOpacity, 0.9); // 确保背景足够不透明
+    context.fillRect(bgX, bgY, bgWidth, bgHeight);
+    
+    // 重置阴影
+    context.shadowColor = 'transparent';
+    context.shadowBlur = 0;
+    context.shadowOffsetX = 0;
+    context.shadowOffsetY = 0;
+    
+    // 绘制边框（加粗以提高可见性）
+    context.strokeStyle = borderColor;
+    context.lineWidth = 6;
+    context.globalAlpha = 1;
+    context.strokeRect(bgX, bgY, bgWidth, bgHeight);
+    
+    // 绘制文本轮廓以增强对比度
+    context.strokeStyle = color === '#000000' ? '#FFFFFF' : '#000000';
+    context.lineWidth = 2;
+    context.strokeText(content, centerX, centerY);
+    
+    // 绘制文本
+    context.fillStyle = color;
+    context.fillText(content, centerX, centerY);
+    
+    // 创建纹理和sprite
+    var texture = new THREE.Texture(canvas);
+    texture.needsUpdate = true;
+    texture.minFilter = THREE.LinearFilter;
+    texture.magFilter = THREE.LinearFilter;
+    
+    var material = new THREE.SpriteMaterial({ 
+      map: texture,
+      transparent: true,
+      depthTest: true,
+      depthWrite: false,
+      sizeAttenuation: true // 启用距离衰减，使文本大小随距离变化
+    });
+    
+    var sprite = new THREE.Sprite(material);
+    
+    // 增大缩放以提高可读性（与编辑器一致）
+    var scale = 3;
+    sprite.scale.set(scale, scale / 2, 1);
+    
+    // 设置渲染顺序为最大值，确保文本始终在最上层
+    sprite.renderOrder = 999999;
+    
+    return sprite;
+  };
+
+  /**
+   * 渲染文本元素到场景
+   */
+  SceneCore.prototype.renderTextElements = function(textElements) {
+    var self = this;
+    
+    if (!textElements || textElements.length === 0) {
+      return;
+    }
+    
+    // 创建文本组（如果不存在）
+    if (!this.textGroup) {
+      this.textGroup = new THREE.Group();
+      this.textGroup.name = 'texts';
+      this.scene.add(this.textGroup);
+    }
+    
+    // 清空现有文本
+    while (this.textGroup.children.length > 0) {
+      var child = this.textGroup.children[0];
+      this.textGroup.remove(child);
+      
+      // 释放资源
+      if (child.material && child.material.map) {
+        child.material.map.dispose();
+      }
+      if (child.material) {
+        child.material.dispose();
+      }
+    }
+    
+    // 渲染每个文本元素
+    textElements.forEach(function(textEl) {
+      if (!textEl.points || textEl.points.length === 0) return;
+      
+      var point = textEl.points[0];
+      var x = point.x / 100; // Canvas pixels to 3D meters
+      var z = point.y / 100;
+      
+      // 文本elevation单位是mm，需要按照墙面比例缩放（与编辑器预览一致）
+      var LOGICAL_WALL_HEIGHT = 3000; // 逻辑墙高3000mm（3米）
+      var RENDER_WALL_HEIGHT = 0.375; // 渲染墙高0.375米
+      var elevationMm = textEl.elevation || 8500; // 默认8500mm（850cm）
+      var y = (elevationMm / LOGICAL_WALL_HEIGHT) * RENDER_WALL_HEIGHT;
+      
+      console.log('[SceneCore] 渲染文本元素:', {
+        content: textEl.content,
+        elevationMm: elevationMm,
+        calculatedY: y,
+        position: { x: x, y: y, z: z }
+      });
+      
+      var sprite = self.createTextSprite({
+        content: textEl.content || '',
+        fontSize: textEl.fontSize || 16,
+        color: textEl.color || '#000000',
+        fontFamily: textEl.fontFamily || 'Arial, sans-serif',
+        bold: textEl.bold || false,
+        italic: textEl.italic || false,
+        borderColor: textEl.borderColor || '#87CEEB',
+        backgroundColor: textEl.backgroundColor || '#FFFFFF',
+        backgroundOpacity: textEl.backgroundOpacity !== undefined ? textEl.backgroundOpacity : 0.8,
+        padding: textEl.padding || 8
+      });
+      
+      sprite.position.set(x, y, z);
+      sprite.userData = { type: 'text', elementId: textEl.id };
+      self.textGroup.add(sprite);
+    });
+    
+    console.log('[SceneCore] ✅ 文本元素渲染完成:', textElements.length, '个');
+  };
+
   SceneCore.prototype.destroy = function() {
     if (this.scene) {
       this.scene.traverse(function(object) {
@@ -1575,6 +1866,7 @@
       })
       .then(function(result) {
         console.log('✅ 3D家具模型加载完成:', result);
+        
         return { success: true, loaded: result.loaded, failed: result.failed };
       })
       .catch(function(error) {
@@ -2127,6 +2419,173 @@
     }
   };
 
+  /**
+   * 解析并渲染文本元素
+   * @private
+   */
+  KimapSDK.prototype._parseAndRenderTextElements = function(kidataObj) {
+    var textElements = [];
+    
+    // 从floors中提取文本元素
+    if (kidataObj.floors && Array.isArray(kidataObj.floors)) {
+      kidataObj.floors.forEach(function(floor) {
+        if (floor.layers && Array.isArray(floor.layers)) {
+          floor.layers.forEach(function(layer) {
+            if (layer.elements && Array.isArray(layer.elements)) {
+              layer.elements.forEach(function(element) {
+                if (element.type === 'text' && element.visible !== false) {
+                  textElements.push(element);
+                }
+              });
+            }
+          });
+        }
+      });
+    }
+    
+    console.log('[KimapSDK] 找到', textElements.length, '个文本元素');
+    
+    // 调用SceneCore的渲染方法
+    if (textElements.length > 0 && this.core) {
+      this.core.renderTextElements(textElements);
+    }
+  };
+
+  /**
+   * 应用墙面透明度
+   * @private
+   */
+  KimapSDK.prototype._applyWallOpacity = function(kidataObj) {
+    if (!kidataObj || !kidataObj.floors || !this.core || !this.core.scene) {
+      console.log('[KimapSDK] _applyWallOpacity: 缺少必要数据');
+      return;
+    }
+    
+    console.log('[KimapSDK] 开始应用墙面透明度...');
+    
+    var wallCount = 0;
+    var wallsInKidata = [];
+    var self = this;
+    
+    // 收集kidata中的所有墙体数据
+    kidataObj.floors.forEach(function(floor) {
+      if (floor.layers) {
+        floor.layers.forEach(function(layer) {
+          if (layer.elements) {
+            layer.elements.forEach(function(element) {
+              if (element.type === 'wall') {
+                wallsInKidata.push({
+                  id: element.id,
+                  opacity: element.opacity !== undefined ? element.opacity : 0.85,
+                  color: element.color
+                });
+              }
+            });
+          }
+        });
+      }
+    });
+    
+    console.log('[KimapSDK] Kidata中墙体数量:', wallsInKidata.length);
+    
+    // 如果kidata中没有墙体数据，不需要继续
+    if (wallsInKidata.length === 0) {
+      console.log('[KimapSDK] Kidata中没有墙体数据');
+      return;
+    }
+    
+    // 遍历场景中的所有对象，通过材质名称识别墙体
+    this.core.scene.traverse(function(object) {
+      if (object instanceof THREE.Mesh && object.material) {
+        var materialName = object.material.name || '';
+        
+        // 通过材质名称识别墙体（Wall_前缀）
+        if (materialName.startsWith('Wall_')) {
+          // 从材质名称中提取墙体ID（格式：Wall_<id>）
+          var wallId = materialName.replace('Wall_', '');
+          
+          // 在kidata中查找对应的墙体数据
+          var wallData = wallsInKidata.find(function(w) {
+            return w.id === wallId;
+          });
+          
+          if (wallData) {
+            var opacity = wallData.opacity;
+            
+            console.log('[KimapSDK] 应用墙体透明度:', {
+              id: wallId,
+              opacity: opacity,
+              materialName: materialName
+            });
+            
+            // 应用透明度到材质
+            if (Array.isArray(object.material)) {
+              object.material.forEach(function(mat) {
+                mat.transparent = opacity < 1;
+                mat.opacity = opacity;
+                mat.needsUpdate = true;
+              });
+            } else {
+              object.material.transparent = opacity < 1;
+              object.material.opacity = opacity;
+              object.material.needsUpdate = true;
+            }
+            
+            wallCount++;
+          }
+        }
+      }
+    });
+    
+    if (wallCount > 0) {
+      console.log('[KimapSDK] ✅ 应用墙面透明度完成:', wallCount, '个墙体');
+    } else {
+      console.log('[KimapSDK] ⚠️ 未找到匹配的墙体对象');
+    }
+  };
+
+  /**
+   * 从kidata内容加载家具模型（不处理文本和墙体透明度）
+   * @param {string} kidataContent - kidata文件内容（加密或未加密）
+   */
+  KimapSDK.prototype.loadKidataForFurniture = function(kidataContent) {
+    var self = this;
+    
+    try {
+      // 解密kidata文件
+      var decrypted = self._decryptKidata(kidataContent);
+      var kidataObj = JSON.parse(decrypted);
+      
+      // 保存kidata数据供路径规划使用
+      self.kidataContent = kidataObj;
+      
+      // 如果kidata包含楼层数据，设置为projectLayers
+      if (kidataObj.floors && Array.isArray(kidataObj.floors)) {
+        console.log('[KimapSDK] kidata包含楼层数据，楼层数量:', kidataObj.floors.length);
+        if (!self.projectLayers && kidataObj.floors.length > 0) {
+          self.projectLayers = kidataObj.floors[0].layers;
+          console.log('[KimapSDK] 从kidata设置楼层数据，图层数量:', self.projectLayers.length);
+        }
+      }
+      
+      console.log('[KimapSDK] ✅ Kidata文件解密成功:', {
+        version: kidataObj.version,
+        furnitureCount: kidataObj.furnitures ? kidataObj.furnitures.length : 0,
+        floorCount: kidataObj.floors ? kidataObj.floors.length : 0
+      });
+      
+      // 只加载3D家具模型
+      return self._loadFurnitureModels(kidataObj)
+        .then(function(result) {
+          console.log('[KimapSDK] ✅ 3D家具模型加载完成:', result);
+          return { success: true, loaded: result.loaded, failed: result.failed };
+        });
+    } catch (error) {
+      console.error('[KimapSDK] ❌ Kidata加载失败:', error);
+      return Promise.reject(error);
+    }
+  };
+
   KimapSDK.prototype.destroy = function() {
     if (this.animationFrameId) {
       cancelAnimationFrame(this.animationFrameId);

package/src/core/KimapSDK.js

@@ -723,6 +723,7 @@ KimapSDK.prototype.loadKMData = function() {
     })
     .then(function(result) {
       console.log('✅ 3D家具模型加载完成:', result);
+      
       return { success: true, loaded: result.loaded, failed: result.failed };
     })
     .catch(function(error) {
@@ -967,6 +968,48 @@ KimapSDK.prototype._loadSingleFurniture = function(furniture, serverUrl) {
   });
 };
 
+/**
+ * 从kidata内容加载家具模型（不处理文本和墙体透明度）
+ * @param {string} kidataContent - kidata文件内容（加密或未加密）
+ */
+KimapSDK.prototype.loadKidataForFurniture = function(kidataContent) {
+  var self = this;
+  
+  try {
+    // 解密kidata文件
+    var decrypted = self._decryptKidata(kidataContent);
+    var kidataObj = JSON.parse(decrypted);
+    
+    // 保存kidata数据供路径规划使用
+    self.kidataContent = kidataObj;
+    
+    // 如果kidata包含楼层数据，设置为projectLayers
+    if (kidataObj.floors && Array.isArray(kidataObj.floors)) {
+      console.log('[KimapSDK] kidata包含楼层数据，楼层数量:', kidataObj.floors.length);
+      if (!self.projectLayers && kidataObj.floors.length > 0) {
+        self.projectLayers = kidataObj.floors[0].layers;
+        console.log('[KimapSDK] 从kidata设置楼层数据，图层数量:', self.projectLayers.length);
+      }
+    }
+    
+    console.log('[KimapSDK] ✅ Kidata文件解密成功:', {
+      version: kidataObj.version,
+      furnitureCount: kidataObj.furnitures ? kidataObj.furnitures.length : 0,
+      floorCount: kidataObj.floors ? kidataObj.floors.length : 0
+    });
+    
+    // 只加载3D家具模型
+    return self._loadFurnitureModels(kidataObj)
+      .then(function(result) {
+        console.log('[KimapSDK] ✅ 3D家具模型加载完成:', result);
+        return { success: true, loaded: result.loaded, failed: result.failed };
+      });
+  } catch (error) {
+    console.error('[KimapSDK] ❌ Kidata加载失败:', error);
+    return Promise.reject(error);
+  }
+};
+
 /**
  * 销毁 SDK
  */

package/src/core/SceneCore.js

@@ -26,6 +26,8 @@ var decryptTheme = crypto.decryptTheme;
 var extractBorderFromOBJ = parsers.extractBorderFromOBJ;
 var extractMapConfigFromOBJ = parsers.extractMapConfigFromOBJ;
 var extractColorsFromOBJ = parsers.extractColorsFromOBJ;
+var extractTextElementsFromOBJ = parsers.extractTextElementsFromOBJ;
+var extractWallOpacityFromOBJ = parsers.extractWallOpacityFromOBJ;
 
 /**
  * SceneCore 构造函数
@@ -369,12 +371,32 @@ SceneCore.prototype._loadKimapFile = function(kimapUrl, themeUrl, objLoader, mtl
           if (!materials) {
             console.log('[SceneCore] 提取到颜色信息:', colorMap);
           }
+          
+          // 提取文本元素
+          var textElements = extractTextElementsFromOBJ(objContent);
+          if (textElements && textElements.length > 0) {
+            console.log('[SceneCore] ✅ 从OBJ提取到文本元素:', textElements.length, '个');
+            self._textElements = textElements;
+          }
+          
+          // 提取墙体透明度信息
+          var wallOpacity = extractWallOpacityFromOBJ(objContent);
+          if (wallOpacity && Object.keys(wallOpacity).length > 0) {
+            console.log('[SceneCore] ✅ 从OBJ提取到墙体透明度:', Object.keys(wallOpacity).length, '个墙体');
+            self._wallOpacity = wallOpacity;
+          }
         
           // 解析OBJ内容
           var object = objLoader.parse(objContent);
           console.log('[SceneCore] ✓ OBJ解析完成，处理模型...');
           
           self._processLoadedModel(object, materials, colorMap);
+          
+          // 渲染文本元素
+          if (self._textElements && self._textElements.length > 0) {
+            self.renderTextElements(self._textElements);
+          }
+          
           resolve();
         } catch (error) {
           console.error('[SceneCore] ✗ Kimap处理失败:', error.message);
@@ -512,6 +534,8 @@ SceneCore.prototype._processLoadedModel = function(object, materials, colorMap)
  * @private
  */
 SceneCore.prototype._processMaterial = function(child, materials, colorMap) {
+  var self = this;
+  
   if (child.material && child.material.name) {
     // 已有材质，转换为PBR材质
     var mtlColor = child.material.color ? child.material.color.getHex() : 0xdddddd;
@@ -529,6 +553,16 @@ SceneCore.prototype._processMaterial = function(child, materials, colorMap) {
     } else if (child.material.name.startsWith('Wall_')) {
       roughness = 0.25;
       metalness = 0;
+      
+      // 从OBJ提取的墙体透明度数据中读取
+      if (self._wallOpacity) {
+        var wallId = child.material.name.replace('Wall_', '');
+        if (self._wallOpacity[wallId]) {
+          opacity = self._wallOpacity[wallId].opacity;
+          transparent = opacity < 1.0;
+          console.log('[SceneCore] 应用墙体透明度:', wallId, '=', opacity);
+        }
+      }
     } else if (child.material.name.startsWith('Shape_') || child.material.name.startsWith('Stair_')) {
       roughness = 0.25;
       metalness = 0;
@@ -611,6 +645,183 @@ SceneCore.prototype.onWindowResize = function() {
   this.renderer.setSize(this.container.clientWidth, this.container.clientHeight);
 };
 
+/**
+ * 创建文本精灵（用于3D场景中显示文本）
+ */
+SceneCore.prototype.createTextSprite = function(options) {
+  var content = options.content || '';
+  var fontSize = options.fontSize || 16;
+  var color = options.color || '#000000';
+  var fontFamily = options.fontFamily || 'Arial, sans-serif';
+  var bold = options.bold || false;
+  var italic = options.italic || false;
+  var borderColor = options.borderColor || '#87CEEB';
+  var backgroundColor = options.backgroundColor || '#FFFFFF';
+  var backgroundOpacity = options.backgroundOpacity !== undefined ? options.backgroundOpacity : 0.8;
+  var padding = options.padding || 8;
+  
+  // 创建高分辨率canvas用于文本纹理
+  var canvas = document.createElement('canvas');
+  var context = canvas.getContext('2d');
+  
+  // 使用更大的canvas尺寸以提高清晰度
+  canvas.width = 1024;
+  canvas.height = 512;
+  
+  // 配置字体（放大4倍以提高质量）
+  var scaledFontSize = fontSize * 4;
+  var fontStyle = (italic ? 'italic ' : '') + (bold ? 'bold ' : '') + scaledFontSize + 'px ' + fontFamily;
+  context.font = fontStyle;
+  context.textAlign = 'center';
+  context.textBaseline = 'middle';
+  
+  // 测量文本
+  var metrics = context.measureText(content);
+  var textWidth = metrics.width;
+  var textHeight = scaledFontSize * 1.2;
+  
+  // 计算背景尺寸
+  var scaledPadding = padding * 4;
+  var bgWidth = textWidth + scaledPadding * 2;
+  var bgHeight = textHeight + scaledPadding * 2;
+  
+  // 计算居中位置
+  var centerX = canvas.width / 2;
+  var centerY = canvas.height / 2;
+  var bgX = centerX - bgWidth / 2;
+  var bgY = centerY - bgHeight / 2;
+  
+  // 绘制阴影效果以增强可读性
+  context.shadowColor = 'rgba(0, 0, 0, 0.5)';
+  context.shadowBlur = 8;
+  context.shadowOffsetX = 2;
+  context.shadowOffsetY = 2;
+  
+  // 绘制背景
+  context.fillStyle = backgroundColor;
+  context.globalAlpha = Math.max(backgroundOpacity, 0.9); // 确保背景足够不透明
+  context.fillRect(bgX, bgY, bgWidth, bgHeight);
+  
+  // 重置阴影
+  context.shadowColor = 'transparent';
+  context.shadowBlur = 0;
+  context.shadowOffsetX = 0;
+  context.shadowOffsetY = 0;
+  
+  // 绘制边框（加粗以提高可见性）
+  context.strokeStyle = borderColor;
+  context.lineWidth = 6;
+  context.globalAlpha = 1;
+  context.strokeRect(bgX, bgY, bgWidth, bgHeight);
+  
+  // 绘制文本轮廓以增强对比度
+  context.strokeStyle = color === '#000000' ? '#FFFFFF' : '#000000';
+  context.lineWidth = 2;
+  context.strokeText(content, centerX, centerY);
+  
+  // 绘制文本
+  context.fillStyle = color;
+  context.fillText(content, centerX, centerY);
+  
+  // 创建纹理和sprite
+  var texture = new THREE.Texture(canvas);
+  texture.needsUpdate = true;
+  texture.minFilter = THREE.LinearFilter;
+  texture.magFilter = THREE.LinearFilter;
+  
+  var material = new THREE.SpriteMaterial({ 
+    map: texture,
+    transparent: true,
+    depthTest: true,
+    depthWrite: false,
+    sizeAttenuation: true // 启用距离衰减，使文本大小随距离变化
+  });
+  
+  var sprite = new THREE.Sprite(material);
+  
+  // 增大缩放以提高可读性（与编辑器一致）
+  var scale = 3;
+  sprite.scale.set(scale, scale / 2, 1);
+  
+  // 设置渲染顺序为最大值，确保文本始终在最上层
+  sprite.renderOrder = 999999;
+  
+  return sprite;
+};
+
+/**
+ * 渲染文本元素到场景
+ */
+SceneCore.prototype.renderTextElements = function(textElements) {
+  var self = this;
+  
+  if (!textElements || textElements.length === 0) {
+    return;
+  }
+  
+  // 创建文本组（如果不存在）
+  if (!this.textGroup) {
+    this.textGroup = new THREE.Group();
+    this.textGroup.name = 'texts';
+    this.scene.add(this.textGroup);
+  }
+  
+  // 清空现有文本
+  while (this.textGroup.children.length > 0) {
+    var child = this.textGroup.children[0];
+    this.textGroup.remove(child);
+    
+    // 释放资源
+    if (child.material && child.material.map) {
+      child.material.map.dispose();
+    }
+    if (child.material) {
+      child.material.dispose();
+    }
+  }
+  
+  // 渲染每个文本元素
+  textElements.forEach(function(textEl) {
+    if (!textEl.points || textEl.points.length === 0) return;
+    
+    var point = textEl.points[0];
+    var x = point.x / 100; // Canvas pixels to 3D meters
+    var z = point.y / 100;
+    
+    // 文本elevation单位是mm，需要按照墙面比例缩放（与编辑器预览一致）
+    var LOGICAL_WALL_HEIGHT = 3000; // 逻辑墙高3000mm（3米）
+    var RENDER_WALL_HEIGHT = 0.375; // 渲染墙高0.375米
+    var elevationMm = textEl.elevation || 8500; // 默认8500mm（850cm）
+    var y = (elevationMm / LOGICAL_WALL_HEIGHT) * RENDER_WALL_HEIGHT;
+    
+    console.log('[SceneCore] 文本元素属性:', {
+      content: textEl.content,
+      backgroundColor: textEl.backgroundColor,
+      borderColor: textEl.borderColor,
+      color: textEl.color
+    });
+    
+    var sprite = self.createTextSprite({
+      content: textEl.content || '',
+      fontSize: textEl.fontSize || 16,
+      color: textEl.color || '#000000',
+      fontFamily: textEl.fontFamily || 'Arial, sans-serif',
+      bold: textEl.bold || false,
+      italic: textEl.italic || false,
+      borderColor: textEl.borderColor || '#ADD8E6',
+      backgroundColor: textEl.backgroundColor || '#FFFFFF',
+      backgroundOpacity: textEl.backgroundOpacity !== undefined ? textEl.backgroundOpacity : 0.8,
+      padding: textEl.padding || 8
+    });
+    
+    sprite.position.set(x, y, z);
+    sprite.userData = { type: 'text', elementId: textEl.id };
+    self.textGroup.add(sprite);
+  });
+  
+  console.log('[SceneCore] ✅ 文本元素渲染完成:', textElements.length, '个');
+};
+
 /**
  * 销毁场景
  */

package/src/core/parsers.js

@@ -114,9 +114,110 @@ function extractCoordinateSystem(config) {
   };
 }
 
+/**
+ * 从OBJ内容中提取文本元素
+ * 格式示例:
+ * # ===== Text Element =====
+ * # TEXT_ID text_123
+ * # TEXT_CONTENT Hello World
+ * # TEXT_POSITION 1000 2000
+ * # TEXT_ELEVATION 8500
+ * # ===== End Text Element =====
+ */
+function extractTextElementsFromOBJ(objContent) {
+  var textElements = [];
+  var lines = objContent.split('\n');
+  var currentText = null;
+  
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i].trim();
+    
+    if (line.indexOf('# ===== Text Element =====') === 0) {
+      currentText = {};
+    } else if (line.indexOf('# ===== End Text Element =====') === 0 && currentText) {
+      textElements.push(currentText);
+      currentText = null;
+    } else if (currentText) {
+      if (line.indexOf('# TEXT_ID') === 0) {
+        currentText.id = line.split(' ')[2];
+      } else if (line.indexOf('# TEXT_CONTENT') === 0) {
+        currentText.content = line.substring(line.indexOf('TEXT_CONTENT') + 13).trim();
+      } else if (line.indexOf('# TEXT_POSITION') === 0) {
+        var parts = line.split(' ');
+        currentText.points = [{ x: parseFloat(parts[2]), y: parseFloat(parts[3]) }];
+      } else if (line.indexOf('# TEXT_ELEVATION') === 0) {
+        currentText.elevation = parseFloat(line.split(' ')[2]);
+      } else if (line.indexOf('# TEXT_FONT_SIZE') === 0) {
+        currentText.fontSize = parseFloat(line.split(' ')[2]);
+      } else if (line.indexOf('# TEXT_COLOR') === 0) {
+        currentText.color = line.split(' ')[2];
+      } else if (line.indexOf('# TEXT_FONT_FAMILY') === 0) {
+        currentText.fontFamily = line.substring(line.indexOf('TEXT_FONT_FAMILY') + 17).trim();
+      } else if (line.indexOf('# TEXT_BOLD') === 0) {
+        currentText.bold = line.split(' ')[2] === 'true';
+      } else if (line.indexOf('# TEXT_ITALIC') === 0) {
+        currentText.italic = line.split(' ')[2] === 'true';
+      } else if (line.indexOf('# TEXT_BORDER_COLOR') === 0) {
+        currentText.borderColor = line.split(' ')[2];
+      } else if (line.indexOf('# TEXT_BG_COLOR') === 0) {
+        currentText.backgroundColor = line.split(' ')[2];
+      } else if (line.indexOf('# TEXT_BG_OPACITY') === 0) {
+        currentText.backgroundOpacity = parseFloat(line.split(' ')[2]);
+      } else if (line.indexOf('# TEXT_PADDING') === 0) {
+        currentText.padding = parseFloat(line.split(' ')[2]);
+      }
+    }
+  }
+  
+  console.log('[Parsers] 提取到的文本元素:', textElements.length, '个');
+  return textElements;
+}
+
+/**
+ * 从OBJ内容中提取墙体透明度信息
+ * 格式示例:
+ * o Wall_wall123_seg0
+ * # WALL_OPACITY 0.85
+ * # WALL_COLOR #d1d5db
+ */
+function extractWallOpacityFromOBJ(objContent) {
+  var wallOpacity = {};
+  var lines = objContent.split('\n');
+  var currentWallId = null;
+  
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i].trim();
+    
+    if (line.indexOf('o Wall_') === 0) {
+      // 提取墙体ID（格式：Wall_<id>_seg<n>）
+      var match = line.match(/Wall_([^_]+)_seg/);
+      if (match) {
+        currentWallId = match[1];
+      }
+    } else if (currentWallId && line.indexOf('# WALL_OPACITY') === 0) {
+      var opacity = parseFloat(line.split(' ')[2]);
+      if (!wallOpacity[currentWallId]) {
+        wallOpacity[currentWallId] = {};
+      }
+      wallOpacity[currentWallId].opacity = opacity;
+    } else if (currentWallId && line.indexOf('# WALL_COLOR') === 0) {
+      var color = line.split(' ')[2];
+      if (!wallOpacity[currentWallId]) {
+        wallOpacity[currentWallId] = {};
+      }
+      wallOpacity[currentWallId].color = color;
+    }
+  }
+  
+  console.log('[Parsers] 提取到的墙体透明度:', Object.keys(wallOpacity).length, '个墙体');
+  return wallOpacity;
+}
+
 module.exports = {
   extractBorderFromOBJ: extractBorderFromOBJ,
   extractMapConfigFromOBJ: extractMapConfigFromOBJ,
   extractColorsFromOBJ: extractColorsFromOBJ,
-  extractCoordinateSystem: extractCoordinateSystem
+  extractCoordinateSystem: extractCoordinateSystem,
+  extractTextElementsFromOBJ: extractTextElementsFromOBJ,
+  extractWallOpacityFromOBJ: extractWallOpacityFromOBJ
 };