CarlaAir录制工具包教程:从车辆、无人机轨迹录制到Demo Director回放,3步产出高质量演示视频
CarlaAir录制工具包教程:从车辆、无人机轨迹录制到Demo Director回放,3步产出高质量演示视频
CarlaAir 是一个空地一体的具身智能仿真平台:车辆和行人在地面行驶,无人机在 CARLA 城市上空伴飞。它自带的录制工具包(位于 examples/recording/)可以帮你以「录制轨迹 → 导演拍摄 → 输出视频」三步工作流,快速产出可用于论文、汇报或演示的高质量 Demo 视频。
🎯 核心工作流:录制轨迹(JSON) → Demo Director 回放 + 自由摄像机 → 按 F 导出 MP4
1. 准备工作:环境与启动
- 系统:Ubuntu 20.04 / 22.04,NVIDIA GPU(推荐 8GB 以上显存),32GB+ 内存
- Python:3.8 ~ 3.10(推荐 3.10)
- 依赖:
carla、airsim、pygame、numpy、opencv-python
一键安装与验证
pip install -e .
python -c "import carla; import airsim; import pygame; import cv2; print('All OK!')"
启动 CarlaAir 服务器
在一个终端中启动,等待出现 CARLA server ready on port 2000 字样:
./carlaAir.sh
⚠️ 录制脚本要在另一个终端执行。若提示
time-out while waiting for the simulator,说明服务器未启动。
无人机走 AirSim 通道(NED、米),车辆/行人走 CARLA 通道(左手系、厘米),工具包会在回放时自动完成坐标校准,你不需要手动换算。
2. 第一步:录制轨迹(车辆 / 无人机 / 行人)
三个录制脚本都在 examples/recording/ 目录,共同点:20Hz 采样、输出 JSON 到 trajectories/ 目录、F1 保存退出、ESC 丢弃。
2.1 车辆:record_vehicle.py
W/S 油门刹车,A/D 转向,Space 手刹,R 倒车,滚轮调转向灵敏度。
# 默认 Tesla Model3;可换地图、天气、车型、出生点
python examples/recording/record_vehicle.py --map Town03 --weather sunset --vehicle vehicle.audi.a2
小技巧:起步后等 2~3 秒再加速,避免车辆穿地;建议录 20~40 秒,沿主路直行最容易拍好。
2.2 无人机:record_drone.py
该脚本不连接 AirSim API(零侵入),从 CARLA 侧读取无人机位姿,不干扰 CarlaAir 窗口里的飞行控制:
- 先通过 CarlaAir 窗口的 H 菜单手动起飞无人机到 20~50m 高度;
- 运行脚本后飞到起始位置,在终端按 Enter 开始录制;
- 飞完再按 Enter 保存,可继续录下一段,输入
q退出。
小技巧:匀速直线飞行效果最好;如果要与车辆同框,尽量平行于道路方向伴飞。
2.3 行人:record_walker.py
FPS 风格操控:WASD 走动、鼠标转向、Shift 奔跑、Space 跳跃。
python examples/recording/record_walker.py --speed 3.0 --map Town03 --weather rain
公共辅助函数(世界清理、轨迹加载、幽灵车回放等)统一放在 trajectory_helpers.py。
3. 第二步:Demo Director 回放拍摄
examples/recording/demo_director.py 是核心工具:加载所有轨迹 JSON,车、人、无人机同框同步回放,你扮演导演用自由摄像机拍摄。
# 回放单条轨迹
python examples/recording/demo_director.py trajectories/vehicle_*.json
# 人+车+无人机同框,1080p 30fps 高清录制
python examples/recording/demo_director.py --res 1920x1080 --fps 30 trajectories/*.json
导演键位速查
| 类别 | 键位 | 功能 |
|---|---|---|
| 摄像机 | 鼠标 / WASD / E / Shift |
朝向、前后平移、上下升降 |
| 跟随 | C / X |
循环跟随角色 / 脱离回自由镜头 |
| 回放 | P、←/→、[/]、Home |
暂停、跳帧、0.25x~4x 变速、回开头 |
| 天气 | 1~0 |
晴天/多云/小雨/暴雨/浓雾/夜晚/日落/黎明/夜雨/自动轮播 |
| 录制 | F / G |
开始/停止 MP4 / 截图 PNG |
| 传感器 | Tab / V |
打开 RGB/Depth/Semantic 面板、切换布局 |
💡 回放结束时:
P暂停 +Home回开头再P继续;或启动时加--loop循环播放。
导演模式支持 --map Town01~Town10HD 与 --weather sunset/night 等参数,同一轨迹可切换多张地图、多种天气反复拍摄。
4. 第三步:5种推荐 Demo 拍摄方案
- 空地协同追踪(最经典):
record_vehicle.py --map Town10HD录 30 秒直行 → H 菜单起飞后record_drone.py平行伴飞 30 秒 → 导演模式侧方 45° 俯视同框拍摄。 - 天气变换:
--loop循环回放,录制中依次按1(晴天)→4(暴雨)→6(夜晚),一条视频展示多天气。 - 传感器可视化:导演模式按
Tab打开 RGB / Depth / Semantic 三窗格再按F录制,突出多模态数据能力。 - 多地图展示:分别在 Town01(小镇)、Town03(郊区 sunset)、Town05(城市 night)录制+拍摄,拼接成对比视频。
- 大规模交通:
--no-trajectories --traffic 30 --walkers 50,不录轨迹,直接用 AI 背景交通自由航拍。
5. 常见问题 FAQ
ModuleNotFoundError: No module named 'carla'→ 确认激活了安装依赖的 conda 环境。Version mismatch/std::bad_alloc→ CarlaAir 是 CARLA 定制分支,必须使用同一次编译的carla-*.whl(如包内PythonAPI/carla/dist/),不能与 PyPI 的carla==0.9.16混用。- 回放时角色位置不对 → 录制和回放必须使用同一张地图,轨迹文件里记录了地图名。
- 视频不够流畅 → 导演模式加
--res 1920x1080 --fps 30。 - 多车/多人同框 → 每种类型多跑几次录制脚本,导演模式用
trajectories/*.json全量加载。
📁 更多细节可查阅:examples/recording/README.md、examples/recording/demo_director.py、examples/recording/trajectory_helpers.py。
按「录轨迹 → 导演拍 → 出视频」这三步,几分钟就能得到一段车辆、行人、无人机同框的高清演示视频,非常适合 CarlaAir 的汇报与论文素材制作。




