从入门到精通：AirSim settings.json 核心配置项实战解析

1. 初识AirSim settings.json：你的仿真控制中心

第一次打开AirSim的settings.json文件时，我仿佛看到了一个飞行控制台的简化版。这个不到100KB的JSON文件，实际上掌控着整个仿真环境的行为模式。记得去年做无人机避障算法测试时，因为没吃透这个配置文件，白白浪费了两天时间调试错误的环境参数。

settings.json本质上就是AirSim的"大脑配置文件"，它存放在C:\Users\[你的用户名]\Documents\AirSim路径下（Linux/Mac路径类似）。这个文件的神奇之处在于，它用简单的键值对就能控制：

• 选择仿真模式（无人机/汽车/纯视觉）
• 配置摄像头视角和参数
• 设置环境光照和天气
• 控制数据记录行为
• 调整物理引擎参数

新手最容易犯的错误是直接复制别人的配置文件。有次我用了同事的赛车仿真配置来测试无人机，结果视角一直锁定在第三人称追尾模式。后来才发现是ViewMode参数没改，这就是为什么理解每个配置项如此重要。

2. 基础配置实战：从Hello World开始

2.1 最小化配置模板

刚开始接触时，建议从最简配置入手。新建settings.json文件，写入以下内容：

{ "SettingsVersion": 1.2, "SimMode": "Multirotor" }

这个配置只包含两个必填项：

• SettingsVersion：指定配置版本（1.2是当前稳定版）
• SimMode：决定仿真器类型

SimMode支持三种基础模式：

• "Multirotor"：多旋翼无人机（默认）
• "Car"：自动驾驶汽车
• "ComputerVision"：纯视觉模式（无物理引擎）

2.2 模式选择实战技巧

在无人机开发中，我习惯设置为"Multirotor"模式。但有个小技巧：如果设为空字符串""，启动时会弹出模式选择对话框，特别适合需要频繁切换的场景。

汽车仿真时要注意，某些摄像头参数在Car模式下默认值不同。比如ViewMode默认会变成"SpringArmChase"，这是第三人称追尾视角，更适合观察车辆运动。

3. 视觉配置全解析：让仿真器"看见"世界

3.1 ViewMode：你的仿真眼睛

ViewMode决定了默认摄像头行为，对算法测试影响巨大。去年测试SLAM算法时，就因为没搞清这些模式，导致采集的数据集视角不符合要求：

"ViewMode": "FlyWithMe"

常用模式包括：

• "FlyWithMe"：六自由度跟随（无人机默认）
• "GroundObserver"：地面固定高度跟踪
• "Fpv"：第一人称视角（像戴了VR眼镜）
• "SpringArmChase"：弹簧臂追尾（汽车默认）
• "Manual"：手动控制相机
• "NoDisplay"：不渲染主窗口（省资源）

实测发现，"GroundObserver"模式在建筑巡检仿真中最实用，它能保持固定高度，同时自由旋转视角。而"NoDisplay"模式在批量生成数据集时能提升30%以上的帧率。

3.2 多窗口配置技巧

AirSim支持同时显示多个摄像头画面，这个功能在比较不同算法时特别有用：

"SubWindows": [ { "WindowID": 0, "CameraName": "front_center", "ImageType": 3, "Visible": true }, { "WindowID": 1, "CameraName": "bottom_center", "ImageType": 5, "Visible": true } ]

每个窗口可以独立配置：

• WindowID：窗口编号（0-2）
• CameraName：对应车辆配置中的摄像头名称
• ImageType：图像类型（0=场景，3=深度图，5=红外等）
• Visible：是否默认显示

4. 环境与物理配置：打造逼真虚拟世界

4.1 时间与光照控制

TimeOfDay参数让我又爱又恨。有次做全天候测试，设置了自动变化的光照：

"TimeOfDay": { "Enabled": true, "StartDateTime": "2023-07-01T17:00:00", "CelestialClockSpeed": 120 }

• Enabled：启用动态时间
• StartDateTime：初始时间（ISO 8601格式）
• CelestialClockSpeed：时间流速（120表示现实1秒=仿真120秒）

注意：过快的时钟速度可能导致光照突变，建议测试时先用低速（如10），再逐步提高。

4.2 风速与物理参数

无人机抗风能力测试离不开风场设置：

"Wind": { "X": 5, "Y": 3, "Z": 0 }

这表示设置了一个(5,3,0)m/s的风速（NED坐标系）。实测发现Z轴（垂直方向）风速对四旋翼影响最大，设置超过3m/s就会明显影响悬停稳定性。

物理引擎参数可以这样调整：

"PhysicsEngine": { "MaxSubsteps": 5, "SubstepTime": 0.02 }

增大MaxSubsteps能提高碰撞检测精度，但会降低性能。在车辆碰撞测试中，我通常设为8-10。

5. 高级配置技巧：面向特定场景的优化

5.1 数据采集专用配置

做计算机视觉研究时，这个配置模板能最大化数据采集效率：

{ "SettingsVersion": 1.2, "SimMode": "ComputerVision", "ViewMode": "NoDisplay", "Recording": { "RecordOnMove": true, "RecordInterval": 0.1, "Cameras": ["front_center", "right_center"] } }

关键优化点：

• 使用NoDisplay模式节省渲染开销
• 设置RecordOnMove自动记录移动时的数据
• 指定0.1秒的采集间隔（10FPS）
• 只启用必要的摄像头

实测这套配置能让RTX 3060显卡的采集帧率提升到45FPS以上，而默认配置通常只有25FPS左右。

5.2 多车辆协同仿真

在车路协同测试中，需要配置多个车辆：

"Vehicles": { "Car1": { "VehicleType": "PhysXCar", "X": 5, "Y": 0, "Z": -2 }, "Car2": { "VehicleType": "SimpleCar", "X": -5, "Y": 0, "Z": -2 } }

每个车辆可以：

• 指定不同类型（PhysXCar支持更复杂物理）
• 设置初始位置（NED坐标系，Z通常为负值）
• 独立配置传感器

注意：多车仿真时建议关闭不必要的传感器，否则容易导致帧率骤降。