跳到主要内容

故障排查

授权相关​

Output Log 出现 LICENSE VALIDATION FAILED​

  • 尚未激活：请按激活流程完成激活。
  • 激活码与产品不匹配：确保使用该产品对应的激活码（IADataSDG / SDGToolSet / IAGaussianRenderer 各自独立）。
  • 更换机器 / 重装系统后授权可能失效：请重新激活。

仍无法激活或授权异常，请带上 Output Log 通过联系我们的邮箱或 QQ 群反馈。

试用已到期​

试用到期后功能停用。需要继续使用请联系我们获取正式授权。

IADataSDG 采集相关​

采集中止，提示与 Nanite / IA.SDG.Detect 相关​

启用实例分割（InstanceSegmentation）时，被标记为 IA.SDG.Detect 的物体必须关闭 Nanite，否则采集会中止（headless 下直接退出）。

处理：在这些物体的静态网格资产或其组件上关闭 Nanite。

  • 仅几何 Box3D 检测（不采集实例分割、不需要实例对应）时为软警告，采集可继续。
  • 全场景的 MaterialSegmentation 属另一类约束（whole-scene），与上面的实例分割硬门禁不同。

采集到 0 张相机图像（但帧数在涨）​

通常是相机过滤/发现问题，不是渲染没出图。排查顺序：

  1. 确认关卡中放置的是 AIASDGCameraSensor / AIASDGFisheyeSensor / AIASDGPanoramaSensor 传感器 Actor（而非普通 CameraActor），且已被子系统发现（查日志 DiscoverSensors / Filtered N pinhole camera(s)）。
  2. 确认 sensors.camera.instances 与场景相机对应（instances[].name 与传感器 SensorName 对齐）。
  3. 确认 sensors.camera.modalities 中至少启用了一个相机模态（如 RGB）。

自动化 / headless 采集的时钟配置​

自动化与无人值守采集请保持默认的 "clock": { "booster": true }（固定仿真步长，与墙钟时间解耦）。旧版 clock.mode = "scalable" 已退役（等价于 booster: false，仅供编辑器内人在环交互使用）。

热红外整场景近似等温（看不出材质差异）​

热物性由物理材质资产（PM_NV_*，UIANonVisualMaterial）授权。未授权的材质不会报错，而是按默认发射率读成接近环境温 —— 表现为整张热图几乎没有对比度。

排查：查看采集启动日志里的覆盖率行

[Thermal] Material physics: 90 material(s), 84.4% authored (asset 76, config 2, tag 0, dsl 0) | inferred 12 | unresolved 2
  • 存在 inferred（靠语义推断）或 unresolved（完全没有来源）时，该行会是警告，并在预检报告中按场景占比列出材质名。
  • 处理：给这些材质指派对应的 PM_NV_* 物理材质资产。同一个资产同时承载 LiDAR 与热感物性，指派一次即完成两种传感器的授权。
  • 临时验证可用 thermal.material_properties（按材质名覆盖），但它是逐 config 的临时手段，不是授权。

热红外看不到"日落后仍有余温"​

表面温度带热惯性，但帧 0 的初始状态默认就是当前平衡态。傍晚/夜间采集若不预演热历史，所有表面会直接落在气温附近。

处理：设置 thermal.inertia_spin_up_seconds（预演的热历史时长，建议 28800 = 8 小时）。同时确认 thermal_inertia 未被置为 false。

日志提示场景太阳与配置时刻不符​

这是警告，不是错误。热感以场景中实际的定向光为准（这样热图阴影与配对 RGB 帧的阴影一致），但会把"你要的是 20:00、关卡的太阳却在 45.7°"这件事说出来。

处理：若需要时刻真正生效，请让场景的太阳由 Ultra Dynamic Sky 的 Time of Day 驱动。

热红外在 ERP / 全景 / 超广鱼眼上没有输出​

已知限制：热红外当前只支持 pinhole 与常规（atlas）鱼眼投影；wide fisheye / ERP / cubemap 路径会记录警告并跳过热模态。

OpticalFlow 全为 0​

  • OpticalFlow 仅含可动物体速度，需 r.VelocityOutputPass=1。
  • 需要同时包含相机与物体运动时，请启用 GlobalOpticalFlow。

IADataSDG GNSS 相关​

采集中止，提示地理锚点缺失或不一致​

GNSS 需要明确场景在地球上的经纬高原点。请在关卡中放置 AGeoReferencingSystem Actor（推荐），或在 sensors.gnss 中配置 site_anchor，并保持各处锚点参数一致。详见系统要求。

室内 / 隧道场景仍然输出定位​

未开启 horizon。在室内、隧道或建筑密集区采集时，请设置 horizon.enabled: true，使被顶棚或建筑遮挡的卫星退出解算。

开启 nlos 后没有多径反射记录​

nlos 依赖天际线遮挡立面，请同时开启 horizon.enabled: true 与 nlos.enabled: true。

开启 acquisition 后全程无有效定位​

warm（25–35 s）与 cold（30–60 s）启动模式需要等待星历下载完成后才会输出首个有效定位。若采集时长较短，请延长 capture.duration 或改用 acquisition.start_mode: "hot"（1–5 s）。

高度场烘制提示场内无几何​

请确认 AIASDGGnssSensor 位于场景建筑几何范围内（而非远离场景的世界原点空白处），或调大 horizon.field_half_extent_m。

IADataSDG 语义标注相关​

语义/材质分类未运行或 semantic_coverage=0​

  • 检查 IADataSDG/Content/Models/ 下的 ONNX 模型是否完整（GTE ~416 MB + SigLIP2 ~355 MB，约 771 MB），以及引擎插件 NNERuntimeORT 是否启用。模型或推理运行时不可用时，插件会在日志与 capture_report.json（gte_unavailable_reason）中明确报错并跳过 auto_classify，不会静默降级。
  • 不需要 CUDA；编码器通过 DirectML（DX12 GPU）或 CPU 运行。详见系统要求。

IAGaussianRenderer 渲染相关​

高斯泼溅画面发虚/模糊​

splat 无运动矢量，TAA / Bloom / MotionBlur 会使其模糊。开启 Actor 的 bDisableBlurringPostProcess（关闭 TAA/TSR、Bloom、MotionBlur）以获得锐利输出。

UE 网格无法遮挡高斯点云​

已知限制：splat 不写深度缓冲。详见使用指南 · 限制。

仍未解决？请带上 Output Log 与复现步骤联系我们。