cAReality

AR-Car-Scanner auf Basis von Unity + Vuforia mit zwei implementierten Fahrzeug-Targets (Pagani und Bugatti) und iOS-Deployment-Flow über Xcode.

Technical Features

• Unity LTS Projekt mit fester Editor-Version.
• Vuforia Engine als lokales Package (Packages/com.ptc.vuforia.engine-10.22.5.tgz).
• Zwei produktive Szenen im Build: Assets/Scenes/CarScannerStartUpScreen.unity und Assets/Scenes/CarScanner.unity.
• Image-Target-basierter AR-Flow für Pagani/Bugatti.
• Kleines Easter Egg mit Audio-Trigger im CarScanner-Setup.

Funktionsübersicht

• Startscreen mit Szenenwechsel: Über den StartScanner-Button erfolgt der Wechsel von CarScannerStartUpScreen in die Hauptszene CarScanner.
• AR-Scan von zwei Fahrzeugen: Scannen der Targets für Bugatti und Pagani mit Anzeige des jeweiligen 3D-Autos im AR-Modus.
• Info-Tafel pro Fahrzeug: Beim Tippen auf das erkannte Auto wird eine Info-Tafel mit Fahrzeugdaten ein-/ausgeblendet.
• Konfigurationen durchwechseln: Über den Change Color-Button werden mehrere Material-/Look-Konfigurationen zyklisch gewechselt.
• Auto drehen: Rotation des Fahrzeugs über den Rotations-Slider um die Y-Achse zur Betrachtung aus verschiedenen Winkeln.
• Soundcheck: Es gibt SoundCheck-Buttons, mit denen Audio pro Fahrzeug gestartet/gestoppt werden kann.
• Fahr-Animation/Bewegung: Ein Drive-Button triggert eine kurze Fahrsequenz mit Beschleunigung und automatischem Reset auf die Startposition.
• UI-Switching: Toggle-Elemente schalten Fahrzeug-/UI-Zustände sichtbar/unsichtbar, damit der Scan-Flow klar bleibt.

Projektstruktur

.
├── Assets
├── Packages
├── ProjectSettings
├── QCAR
└── README.md

Benötigte Versionen

• Unity Editor: 2022.3.33f1 (aus ProjectSettings/ProjectVersion.txt)
• Xcode: aktuelle, iOS-kompatible Version auf macOS
• Apple Account: für Signing und Installation auf physischem iPhone

Quick Start

1. Repository klonen.
2. Projekt in Unity Hub hinzufügen.
3. Projekt mit Unity 2022.3.33f1 öffnen.
4. Prüfen, dass Packages und ProjectSettings korrekt importiert wurden.

iOS Build & Deployment auf iPhone

Voraussetzungen

• macOS mit Xcode
• iPhone per Kabel
• Apple-ID/Team für Code Signing

1. iOS-Plattform in Unity aktivieren

1. File > Build Settings öffnen.
2. iOS auswählen und Switch Platform ausführen.
3. Sicherstellen, dass aktiv sind: Assets/Scenes/CarScannerStartUpScreen.unity und Assets/Scenes/CarScanner.unity.
4. In Player Settings setzen: Bundle Identifier, Product Name, Company Name und Kamera-Beschreibung für AR.

2. Xcode-Projekt erzeugen

1. In Unity auf Build klicken.
2. Ausgabeordner wählen (z. B. Builds/iOS).
3. Erzeugte .xcodeproj in Xcode öffnen.

3. Signing in Xcode

1. Haupt-Target öffnen.
2. Signing & Capabilities konfigurieren.
3. Team auswählen und Automatically manage signing aktivieren.
4. Bundle Identifier auf Eindeutigkeit prüfen.

4. Auf iPhone installieren

1. iPhone als Run Target wählen.
2. In Xcode Run starten.
3. Falls nötig auf dem iOS-Gerät Entwickler-Modus/Vertrauen aktivieren.
4. Danach startet die App direkt auf dem iPhone.

Implementierte Fahrzeuge

Pagani

Bugatti

Easter Egg

Hinweis: In Assets/Scenes/CarScanner.unity ist ein kleines Easter Egg versteckt.

Hilfe

• Unity Dokumentation: https://docs.unity3d.com/
• Unity iOS Build Docs: https://docs.unity3d.com/Manual/iphone-BuildProcess.html
• Vuforia Developer Docs: https://developer.vuforia.com/library/

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Siehe LICENSE.

Maintainer

• GitHub: @marcdon2002
• Repository: https://github.com/marcdon2002/cAReality