AirSim unter Linux bauen#

Die derzeit empfohlene und getestete Umgebung ist Ubuntu 18.04 LTS. Theoretisch können Sie auch auf anderen Distributionen bauen, wir haben es jedoch nicht getestet.

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

Docker#

Bitte siehe Anweisungen hier

Host-Maschine#

Vorbereitende Einrichtung#

Unreal Engine bauen#

  • Stellen Sie sicher, dass Sie bei Epic Games registriert sind. Dies ist erforderlich, um Zugriff auf den Quellcode der Unreal Engine zu erhalten.

  • Klonen Sie Unreal in Ihren bevorzugten Ordner und bauen Sie es (dies kann eine Weile dauern!). Hinweis: Derzeit unterstützen wir nur Unreal >= 4.27. Wir empfehlen die Verwendung von 4.27.

# go to the folder where you clone GitHub projects
git clone -b 4.27 git@github.com:EpicGames/UnrealEngine.git
cd UnrealEngine
./Setup.sh
./GenerateProjectFiles.sh
make

AirSim bauen#

  • Klonen Sie AirSim und bauen Sie es.
# 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 Bauen, um die Kompatibilität mit UE 4.27 zu gewährleisten. Das Setup-Skript installiert die richtige Version von cmake, llvm und eigen.

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

Unreal-Umgebung bauen#

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

AirSim verwenden#

Sobald AirSim eingerichtet ist

  • Wechseln Sie in den Installationsordner von UnrealEngine und starten Sie Unreal, indem Sie ./Engine/Binaries/Linux/UE4Editor ausführen.
  • Wenn Unreal Engine zur Auswahl eines Projekts oder zur Erstellung eines neuen Projekts auffordert, wählen Sie "Browse" und wählen Sie AirSim/Unreal/Environments/Blocks (oder Ihr benutzerdefiniertes Unreal-Projekt).
  • Alternativ kann die Projektdatei als Kommandozeilenargument übergeben werden. Für Blocks: ./Engine/Binaries/Linux/UE4Editor <AirSim_path>/Unreal/Environments/Blocks/Blocks.uproject
  • Wenn Sie aufgefordert werden, das Projekt zu konvertieren, suchen Sie nach "More Options" oder der Option "Convert-In-Place". Wenn Sie aufgefordert werden, zu bauen, wählen Sie "Yes". Wenn Sie aufgefordert werden, das AirSim-Plugin zu deaktivieren, wählen Sie "No".
  • Nachdem der Unreal Editor geladen ist, drücken Sie die Play-Schaltfläche.

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

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.