CarlaAir录制工具包教程:从车辆、无人机轨迹录制到Demo Director回放,3步产出高质量演示视频

原创2026-10-14 19:51:21820 阅读

CarlaAir录制工具包教程:从车辆、无人机轨迹录制到Demo Director回放,3步产出高质量演示视频

CarlaAir空地一体仿真场景:车辆、无人机、行人与多模态传感器

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,说明服务器未启动。

CarlaAir的CARLA与AirSim坐标系换算关系图

无人机走 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 窗口里的飞行控制:

  1. 先通过 CarlaAir 窗口的 H 菜单手动起飞无人机到 20~50m 高度;
  2. 运行脚本后飞到起始位置,在终端按 Enter 开始录制;
  3. 飞完再按 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 循环播放。

CarlaAir各城市地图在不同天气下的效果一览

导演模式支持 --map Town01~Town10HD 与 --weather sunset/night 等参数,同一轨迹可切换多张地图、多种天气反复拍摄。

4. 第三步:5种推荐 Demo 拍摄方案

  1. 空地协同追踪(最经典):record_vehicle.py --map Town10HD 录 30 秒直行 → H 菜单起飞后 record_drone.py 平行伴飞 30 秒 → 导演模式侧方 45° 俯视同框拍摄。
  2. 天气变换:--loop 循环回放,录制中依次按 1(晴天)→ 4(暴雨)→ 6(夜晚),一条视频展示多天气。
  3. 传感器可视化:导演模式按 Tab 打开 RGB / Depth / Semantic 三窗格再按 F 录制,突出多模态数据能力。
  4. 多地图展示:分别在 Town01(小镇)、Town03(郊区 sunset)、Town05(城市 night)录制+拍摄,拼接成对比视频。
  5. 大规模交通:--no-trajectories --traffic 30 --walkers 50,不录轨迹,直接用 AI 背景交通自由航拍。

无人机向车辆降落的过程:视频帧、3D轨迹、高度与误差曲线

CarlaAir空地场景演示动图

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 的汇报与论文素材制作。

登录后查看全文
CarlaAir