系统要求
引擎与平台
| 项 | 要求 |
|---|---|
| Unreal Engine | 5.8(.uplugin 声明 EngineVersion: 5.8.0) |
| 平台 | Windows 64 位(Win64) |
| 图形 API | DirectX 12(D3D12) |
IADataSDG 的采集管线通过渲染线程提取 G-Buffer,需运行在 D3D12 下。
GPU
- 采集 / 渲染需要支持 DirectX 12 的 GPU。
- CUDA / NVIDIA 专属环境不是必需(见下方 ONNX 说明)。IAGaussianRenderer 的高斯泼溅渲染同样基于标准 UE 渲染路径,不依赖 CUDA。
IADataSDG 语义标注(ONNX)与 GPU
IADataSDG 的语义标注通过 UE 神经网络引擎(NNE)的 ONNX Runtime 运行,依赖引擎插件 NNERuntimeORT(IADataSDG 已声明并启用该依赖)。关键事实:
- 推理使用 CPU 与 DirectML 两种执行提供器(Execution Provider),因此可在任意 DirectX 12 GPU 上运行——不需要 CUDA。
- SigLIP2 视觉编码器:优先使用 GPU(DirectML),不可用时自动回退 CPU。
- GTE 文本编码器:仅 CPU。
- 随 IADataSDG 分发约 771 MB 的 ONNX 模型,位于
IADataSDG/Content/Models/(GTE ~416 MB + SigLIP2 ~355 MB)。 - 推荐配备一块 DX12 GPU(主要利好视觉编码器),但并非强制;无合适 GPU 时视觉编码器回退 CPU,文本编码器本就在 CPU 运行。
- 若模型缺失,引擎干净回退到仅规则路径(能力下降,不崩溃)。
详见产品文档 · 语义标注。
IADataSDG GNSS 与 GeoReferencing
GNSS 接收机把场景坐标与地球坐标互相换算,这一层直接使用引擎自带的 GeoReferencing 插件(IADataSDG 已声明并启用该依赖)。关键事实:
- 该插件随引擎分发,由 PROJ 驱动,客户无需另行安装任何地理库。
- 它在 UE 5.8 里默认不启用,因此 IADataSDG 显式声明依赖 —— 与
NNERuntimeORT同一处理方式。 - 纯 CPU,不占用 GPU,不需要 CUDA。
- 关卡需要恰好一个
AGeoReferencingSystemActor;GNSS 也支持从采集配置的site_anchor兜底(会告警)。两个锚点不一致会中止采集而不是静默取一个。
授权与网络
- 授权按机器绑定,每台机器需单独激活;激活完成后插件运行时不再访问我们的服务器。
- 更换机器或重装系统后授权失效,需要重新激活。
网络要求(只有激活那一刻需要):
| 场景 | 需要的出站访问 |
|---|---|
| 在线激活 | 到我们激活服务器的一次 HTTPS(443)请求,点按钮时才发起 |
| 离线激活 | 无。机器码 / 激活码人工交换即可 |
| 试用授权运行期 | 启动时读取一次公共网站的 HTTPS 时间头用于校验到期时间(不连我们的服务器,不发送任何信息);不可达时按本地防回拨机制判定 |
| 永久授权运行期 | 无 |
不需要开放任何入站端口,不驻留后台进程。激活请求遵循系统代理设置。发送内容的完整清单见安装与激活。
从源码编译(可选)
商业插件以二进制形式交付,正常使用无需编译。若你获得源码版并需自行编译,需要 Windows 下的 Visual Studio 2022(MSVC 工具链)与对应 UE 5.8 引擎环境。
场景准备要求(非硬件)
以下不是硬件要求,而是关卡侧需要准备到位的前提,否则对应模态的输出会退化:
| 前提 | 影响的能力 | 说明 |
|---|---|---|
| 被检测物体关闭 Nanite | 实例分割(InstanceSegmentation) | 启用实例分割时被 IA.SDG.Detect 标记的物体必须关闭 Nanite,否则采集中止 |
材质已指派物理材质资产(PM_NV_*) | 热红外 与 LiDAR | 未授权材质不会报错,而是读成默认物性 —— 热图会近似整场景等温,LiDAR 强度用默认反射率。一个资产同时承载两种传感器的物性,指派一次即可 |
| 太阳由 Ultra Dynamic Sky 驱动 | 热红外的时刻/昼夜/热惯性 | 场景太阳不受 UDS 驱动时,热感仍按实际光源计算并给出警告,但配置里的时刻不会真正生效 |
关卡有 AGeoReferencingSystem(或配置给了 site_anchor) | GNSS | 两者都没有时接收机无法确定自己在地球上的位置,采集中止 —— 没有可降级的东西。两者不一致同样中止 |
| 传感器位于场景几何之中 | GNSS 地平线 / NLOS | 地平线的高度场以传感器起始位置为中心。关卡若没有可驱动的载具、传感器落在世界原点的空地上,烘制会报"场内没有任何几何"并退回无天空模型 |