8th Wall AR模型光照异常问题求助

首先，GLTF Viewer里的「punctualLights」本质是加载模型内嵌的符合GLTF规范的灯光（点光、聚光、平行光），开启后亮度提升说明你的模型本身自带灯光资源，而你当前的AR场景没有加载或启用这些灯光。下面分Three.js、A-Frame、8th Wall三个场景给出解决方案：

1. 检查模型是否自带灯光 #

先确认你的GLTF模型内嵌了灯光：可以用本地的GLTF Inspector工具打开模型，查看节点树里是否有Light类型的节点。如果有，问题大概率是加载时未启用这些灯光。

2. Three.js 中的处理 #

GLTFLoader默认会加载模型内的灯光，但有时会因为配置问题未启用。加载时手动遍历启用并调整参数：

import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

const loader = new GLTFLoader();
loader.load('your-model.gltf', (gltf) => {
  scene.add(gltf.scene);
  
  // 遍历启用所有内嵌灯光，并调整强度
  gltf.scene.traverse((node) => {
    if (node.isLight) {
      node.enabled = true;
      node.intensity = 2; // 根据实际效果调整
    }
  });
});

3. A-Frame 中的处理 #

使用gltf-model组件时，默认会加载模型内的灯光，但如果没生效，可以手动复现模型自带灯光的参数，或强制启用内嵌灯光：

<!-- 方式1：强制启用模型内嵌灯光 -->
<a-entity gltf-model="#yourModel" gltf-animations="playAll: true"></a-entity>

<!-- 方式2：手动添加匹配参数的灯光 -->
<a-entity gltf-model="#yourModel">
  <!-- 假设模型内是位置在(0,2,0)的点光，强度3 -->
  <a-entity light="type: point; intensity: 3; position: 0 2 0"></a-entity>
</a-entity>

4. 8th Wall 专属优化 #

8th Wall提供了xr-lighting组件，可以实时估计摄像头环境的光照参数，让模型光照更贴合真实场景，比手动加灯光效果更好：

<a-scene xrweb>
  <!-- 启用环境光照估计 -->
  <a-entity xr-lighting="estimateEnvironment: true"></a-entity>
  <a-entity gltf-model="#yourModel" position="0 0 -1"></a-entity>
</a-scene>

额外排查要点 #

• 确认模型材质是PBR材质：PBR材质对环境光、光源强度和环境贴图（envMap）敏感度高，若没有合适的envMap，即使加了灯光也会显得暗淡。
• 检查手动添加的灯光参数：平行光的direction是否指向模型，环境光的intensity是否足够（建议设为1-3）。
• 阴影设置：如果模型需要阴影，确保灯光开启castShadow，模型Mesh开启receiveShadow。

内容的提问来源于stack exchange，提问作者Benjamin Zaufall