在 macOS 上构建 AirSim#

目前仅在 macOS Catalina (10.15) 上进行了测试。理论上,AirSim 应该可以在更高版本的 macOS 和 Apple Silicon 硬件上运行,但此路径未得到官方支持。

我们有两种选择——你可以在 docker 容器内构建,也可以在你的主机上构建。

Docker#

请参阅此处的说明

主机#

预构建设置#

下载虚幻引擎#

  1. 下载 Epic Games Launcher。虽然虚幻引擎是开源且可免费下载的,但仍需要注册。
  2. 运行 Epic Games Launcher,打开左侧窗格中的Library选项卡。点击Add Versions,它应该会显示下载 Unreal 4.27 的选项,如下所示。如果你安装了多个版本的虚幻引擎,请通过点击版本旁边 Launch 按钮的向下箭头,确保 4.27 被设置为current

注意:AirSim 也适用于 UE >= 4.24,但是我们推荐 4.27。注意:如果你有 UE 4.16 或更旧的项目,请参阅升级指南来升级你的项目。

构建 AirSim#

  • 克隆 AirSim 并构建它
# go to the folder where you clone GitHub projects
git clone https://github.com/Microsoft/AirSim.git
cd AirSim

默认情况下,AirSim 使用 clang 8 进行构建,以与 UE 4.25 兼容。安装脚本将安装正确版本的 cmake、llvm 和 eigen。

在 Apple Silicon 上构建需要 CMake 3.19.2。

./setup.sh
./build.sh
# use ./build.sh --debug to build in debug mode

构建虚幻环境#

最后,你需要一个虚幻项目来承载你的车辆环境。AirSim 自带一个“Blocks Environment”环境,你可以使用它,或者你可以创建自己的环境。如果你想设置自己的环境,请参阅设置虚幻环境

如何使用 AirSim#

  • 浏览到AirSim/Unreal/Environments/Blocks
  • 从终端运行./GenerateProjectFiles.sh ,其中UE_PATH是虚幻引擎安装文件夹的路径。(默认情况下,这是/Users/Shared/Epic\ Games/UE_4.27/)该脚本会创建一个名为 Blocks.xcworkspace 的 XCode 工作区。
  • 打开 XCode 工作区,然后点击左上角的“构建并运行”按钮。
  • 虚幻编辑器加载后,点击“播放”按钮。

有关 AirSim 用法的各种选项,请参阅使用 APIsettings.json

提示

转到“编辑”->“编辑器首选项”,在“搜索”框中输入“CPU”,并确保“在后台时减少 CPU 使用率”未选中。

[可选] 设置遥控器(仅限多旋翼)#

如果你想手动飞行,需要一个遥控器。有关更多详细信息,请参阅遥控器设置

或者,你可以使用API进行编程控制,或者使用所谓的计算机视觉模式通过键盘移动。