AirSim 无人机仿真：30分钟跑通仿真环境

AirSim 无人机仿真30分钟跑通仿真环境【免费下载链接】AirSimOpen source simulator for autonomous vehicles built on Unreal Engine / Unity, from Microsoft AI Research项目地址: https://gitcode.com/gh_mirrors/ai/AirSim终端里滚过一行unable to connect你盯着它不知道下一步该敲什么。别急——AirSim 是基于 Unreal Engine 的开源无人机与车辆仿真器用游戏引擎当仿真引擎画质和传感器都很真这篇文章带你从克隆仓库到让无人机离地全程只走一条路卡点都有备选。 动手前先想三件事你的机器上有独立显卡吗敲一行nvidia-smi -L验证。有独显后面直接在本机跑二进制最省事没有独显或者是台没装显示器的服务器就得绕道 Docker 无头模式——这决定了你后面走哪条岔路。你的目的是验证算法还是改造仿真器本身只是喂图像、收点云、试控制算法预编译二进制包就够用了它像一份预制菜开袋复热直接上桌只有当你想改 C 里的传感器逻辑或物理参数才值得花几个小时去源码编译。是单人实验还是多人共用同一套环境如果实验室里有三四个人都要跑我机器上能跑会变成一种病Docker 容器给项目套个一次性手套不污染宿主机能根治它。想清楚这三件事下面所有岔路你都能自己选。主路径实战跑通 AirSim 仿真环境我们走阻力最小的路预编译的 Blocks 环境仓库自带的一个方块世界地图中央停着一架四旋翼 Python 客户端。全程四步。第1步拿到代码和客户端这段把仓库克隆下来并给 Python 客户端装好依赖。git clone https://gitcode.com/gh_mirrors/ai/AirSim cd AirSim pip install -r PythonClient/requirements.txt你预期看到requirements.txt里的依赖逐个装完最后一行是Successfully installed ...。如果pip报权限错误先加--user或者用虚拟环境别急着sudo。第2步拿预编译的 Blocks 环境包这段从项目最新 release具体版本号以仓库 release 页为准下载 Linux 版 Blocks 压缩包解压到仓库根目录。注意部分大环境的压缩包会拆成.zip.001、.zip.002分卷务必下全解压时对第一个分卷执行7zz x Blocks.zip.001即可。cd AirSim 7zz x Blocks.zip你预期看到解压出一层Blocks/目录里面有启动脚本和Binaries子目录。这一步和 clone 没有依赖关系可以并行挂着下。第3步启动仿真窗口这段执行环境包里的启动脚本让方块世界在窗口里转起来。cd AirSim/Blocks ./Blocks.sh -windowed你预期看到几秒到几十秒的加载后出现一个方块构成的场景画面中央的地面上停着一架四旋翼这就是 AirSim 无人机仿真的标准起点。如果窗口一闪就没了多半是显卡驱动或 Vulkan 库的问题直接跳到文末的启动阶段排查节先补vulkan-utils再试-opengl参数。第4步Python 连上并起飞这段写一个最小飞行脚本连接、接管控制权、解锁、起飞、降落。import airsim client airsim.MultirotorClient() client.confirmConnection() client.enableApiControl(True) client.armDisarm(True) client.takeoffAsync().join() # ... 省略10行作用为悬停数秒后执行 landAsync() 并打印状态 client.landAsync().join() print(client.getMultirotorState().landed_state)你预期看到仿真窗口里螺旋桨开始转动、机体升空几秒后落回地面终端打印0表示已着陆。岔路口无显示器的服务器切到 Docker 无头模式如果你需要在一台没有显示器的 GPU 服务器上跑比如夜里批量采数据在这里换一种做法。仓库的docker/目录已经把构建脚本备好了先构建镜像cd AirSim/docker python build_airsim_image.py ./download_blocks_env_binary.sh再运行末尾加-- headless让引擎用离屏渲染不占真实显示器./run_airsim_image_binary.sh airsim_binary:10.0-devel-ubuntu18.04 \ Blocks/Blocks.sh -windowed -ResX1080 -ResY720 -- headless你预期看到终端里滚动 Unreal 引擎日志而没有窗口弹出但 Python 客户端照样能连上。它像把整个机房搬进集装箱——宿主机上只多了一个容器不多了别的。岔路口要改 C 源码切到编译路径如果你需要改传感器实现或加自定义接口预编译包帮不了你。回到仓库根目录cd AirSim ./setup.sh ./build.shsetup.sh会装 clang-8、下载 rpclibAirSim 的通信中间件负责客户端和引擎之间传指令和 Eigen 数学库build.sh编译 AirLib 库。注意完整源码路径还要求你先编译一个 Unreal Engine 4.27 以上的引擎仓库文档docs/build_linux.md有详细步骤需要注册 Epic 账号获取源码权限耗时以你的磁盘和耐心为准。你预期看到最后输出编译成功、AirLib/bin下生成 so 文件。核对 AirSim 跑通仿真环境的体检清单仿真跑起来不等于真的跑通了。下面六项逐条打勾任何一项不绿都回对应阶段找原因。✅ 你应看到nvidia-smi -L打印出显卡型号而不是 command not found。 ✅ 你应看到python -c import airsim不输出任何内容即无报错。 ✅ 你应看到启动 Blocks 后窗口里中央地面上停着一架四旋翼。 ✅ 你应看到client.confirmConnection()后终端打印Connected!。 ✅ 你应看到takeoffAsync().join()返回后画面里机体离地、螺旋桨转速满格。 ✅ 你应看到悬停中执行print(client.getMultirotorState().landed_state)得到1空中落地后变0。拧动 AirSim 的三颗性能旋钮装完只是拿到仪表盘跑起来之后才谈得上调参。三颗旋钮都拧在命令行或settings.json上每颗给你三档代价也写清楚。旋钮一分辨率。这是帧率的第一大户。默认值环境包原始分辨率通常 1080p 起步推荐值./Blocks.sh -windowed -ResX1080 -ResY720极限值./Blocks.sh -ResX640 -ResY480 -windowed调到极限档你会牺牲什么图像 API 回给你的每一帧都变糊做视觉算法的数据质量跟着打折——它只适合先验证能飞不适合交付数据。旋钮二帧率上限。物理步数跟着渲染帧走帧率失控时 CPU 会先累倒。默认值不设上限推荐值client.simRunConsoleCommand(t.MaxFPS 30)极限值t.MaxFPS 10调到极限档你会牺牲什么仿真和真实世界的比例被拉慢做时延敏感的算法实验时记住这个时间被拉长的事实。旋钮三图形质量。写在settings.json里的GraphicsMode放在 Blocks 目录旁生效{ SettingsVersion: 1.2, SimMode: Multirotor, GraphicsMode: Medium }默认值Epic全特效阴影和反射都开推荐值Medium极限值Low调到极限档你会牺牲什么光照和材质细节明显变平靠阴影做定位或避障的算法结果会偏。改完记得重启仿真窗口这份配置只在启动时读取。分层诊断 AirSim 启动与运行报错报错按出现阶段分层链式排查别一上来就重装环境。依赖阶段看到pip install装依赖时版本冲突 → 先查 Python 版本python --versionAirSim 的 wheel 对 2.x 和 3.x 不通用装错版本必冲突 → 不行再试换用 conda 建一个干净的 3.8 虚拟环境重来。看到nvidia-smi: command not found→ 先查显卡驱动是否装好ls /usr/lib/x86_64-linux-gnu/libcuda*看有没有驱动库 → 不行再试走 Docker 路径容器里由--gpus all接管显卡绕开宿主机驱动。启动阶段看到窗口白屏或闪退 → 先查 Vulkan 运行库apt-get install -y libvulkan1 vulkan-utils→ 不行再试给启动命令追加-opengl仓库文档docs/use_precompiled.md明确建议显存分配报错时切换图形 API。看到服务器上没有窗口、Python 也连不上 → 先查echo $DISPLAY是否为空无头机器必然为空 → 不行再试改用上面 Docker 的-- headless离屏模式。运行阶段看到confirmConnection()卡住后抛unable to connect→ 先查仿真窗口是否还活着进程还在吗还是早就崩了→ 不行再试显式指定地址airsim.MultirotorClient(ip127.0.0.1)默认端口 41451 被其他程序占走时换端口启动并同步改客户端参数。看到takeoffAsync()调用后纹丝不动 → 先查是不是漏了client.enableApiControl(True)控制权没接管时飞控拒绝一切指令 → 不行再试client.resetAsync().join()把可能已坠机的机体复位再重新走一遍起飞流程。下一步你可以把 Blocks 换成更复杂的环境地图或者照着仓库PythonClient/multirotor/里的示例navigate.py、orbit.py给无人机编一条航线从能飞走到会飞。【免费下载链接】AirSimOpen source simulator for autonomous vehicles built on Unreal Engine / Unity, from Microsoft AI Research项目地址: https://gitcode.com/gh_mirrors/ai/AirSim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考