AirSim unter macOS erstellen#

Derzeit wurde nur macOS Catalina (10.15) getestet. Theoretisch sollte AirSim unter höheren macOS-Versionen und auf Apple Silicon-Hardware funktionieren, aber dieser Pfad ist nicht offiziell unterstützt.

Wir haben zwei Optionen: Sie können entweder innerhalb von Docker-Containern oder auf Ihrer Host-Maschine erstellen.

Docker#

Anweisungen finden Sie hier

Host-Maschine#

Vorbereitung vor dem Erstellen#

Unreal Engine herunterladen#

  1. Laden Sie den Epic Games Launcher herunter. Obwohl die Unreal Engine Open Source und kostenlos herunterladbar ist, ist eine Registrierung dennoch erforderlich.
  2. Starten Sie den Epic Games Launcher, öffnen Sie den Tab Library im linken Bereich. Klicken Sie auf Add Versions, um die Option zum Herunterladen von Unreal 4.27 anzuzeigen, wie unten gezeigt. Wenn Sie mehrere Versionen von Unreal installiert haben, stellen Sie sicher, dass 4.27 als current eingestellt ist, indem Sie auf den Dropdown-Pfeil neben der Schaltfläche Launch für die entsprechende Version klicken.

Hinweis: AirSim funktioniert auch mit UE >= 4.24, wir empfehlen jedoch 4.27. Hinweis: Wenn Sie UE 4.16 oder ältere Projekte haben, lesen Sie bitte die Upgrade-Anleitung, um Ihre Projekte zu aktualisieren.

AirSim bauen#

  • AirSim klonen und erstellen
# go to the folder where you clone GitHub projects
git clone https://github.com/Microsoft/AirSim.git
cd AirSim

Standardmäßig verwendet AirSim clang 8 zum Erstellen für die Kompatibilität mit UE 4.25. Das Setup-Skript installiert die richtige Version von cmake, llvm und eigen.

CMake 3.19.2 ist für die Erstellung auf Apple Silicon erforderlich.

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

Unreal-Umgebung erstellen#

Schließlich benötigen Sie ein Unreal-Projekt, das die Umgebung für Ihre Fahrzeuge beherbergt. AirSim wird mit einer integrierten "Blocks Environment" geliefert, die Sie verwenden können, oder Sie können Ihre eigene erstellen. Bitte lesen Sie Einrichtung der Unreal-Umgebung, wenn Sie Ihre eigene Umgebung einrichten möchten.

AirSim verwenden#

  • Navigieren Sie zu AirSim/Unreal/Environments/Blocks.
  • Führen Sie im Terminal ./GenerateProjectFiles.sh <UE_PATH> aus, wobei UE_PATH der Pfad zum Unreal-Installationsordner ist. (Standardmäßig ist dies /Users/Shared/Epic\ Games/UE_4.27/) Das Skript erstellt einen Xcode-Workspace namens Blocks.xcworkspace.
  • Öffnen Sie den Xcode-Workspace und drücken Sie die Schaltfläche "Build and run" oben links.
  • Nachdem der Unreal Editor geladen ist, drücken Sie die Play-Schaltfläche.

Siehe Verwendung von APIs und settings.json für verschiedene Optionen, die für die AirSim-Nutzung verfügbar sind.

Tipp

Gehen Sie zu 'Edit->Editor Preferences', geben Sie im Feld 'Search' 'CPU' ein und stellen Sie sicher, dass 'Use Less CPU when in Background' deaktiviert ist.

[Optional] Fernsteuerung einrichten (nur Multirotor)#

Eine Fernsteuerung ist erforderlich, wenn Sie manuell fliegen möchten. Weitere Informationen finden Sie in der Einrichtung der Fernsteuerung.

Alternativ können Sie APIs für die programmgesteuerte Steuerung verwenden oder den sogenannten Computer Vision-Modus nutzen, um sich mit der Tastatur zu bewegen.