82 lines
4.4 KiB
Markdown
82 lines
4.4 KiB
Markdown
# ScopedVR auf der Meta Quest 3 installieren (Sideload-Anleitung)
|
||
|
||
Diese Anleitung ist für Einsteiger ohne Technik-Vorkenntnisse geschrieben. Zeitaufwand: ca. 15–20 Minuten (einmalig; spätere Updates gehen in 2 Minuten).
|
||
|
||
## Was du brauchst
|
||
|
||
- Meta Quest 3
|
||
- Windows-PC oder Mac
|
||
- USB-C-Kabel (das Ladekabel der Quest funktioniert, es muss ein **Datenkabel** sein)
|
||
- Die APK-Datei: `scopedvr-client_v0.1.0-m2b.apk` — Download-Link siehe [README](README.md)
|
||
|
||
---
|
||
|
||
## Schritt 1: Entwicklermodus aktivieren (einmalig, für beide Methoden nötig)
|
||
|
||
1. Auf dem Handy die App **„Meta Horizon“** öffnen (früher hieß sie „Oculus“; kostenlos im App Store / Play Store)
|
||
2. Deine Quest 3 ist dort unter **Geräte** verbunden (dein Meta-Account)
|
||
3. Headset auswählen → **Headset-Einstellungen** → **Entwicklermodus** auf AN schalten
|
||
- Falls der Schalter fehlt oder grau ist: Einmal auf [developer.oculus.com](https://developer.oculus.com) mit demselben Meta-Account eine **Entwickler-Organisation anlegen** (kostenlos, der Name ist egal — z. B. dein Spitzname). Danach erscheint der Schalter.
|
||
4. Quest 3 **neu starten** (ein-/ausschalten), sonst ist der Modus nicht aktiv
|
||
|
||
## Schritt 2: USB-Debugging zulassen
|
||
|
||
1. Quest per USB-C an den PC anschließen
|
||
2. **Brille aufsetzen** — im Headset erscheint ein Dialog: **„USB-Debugging zulassen?“** → **Zulassen** (falls angeboten: „Immer von diesem Computer“ anhaken)
|
||
3. Ohne diesen bestätigten Dialog kann keine Software von außen installieren — dieser Schritt ist der häufigste Stolperstein
|
||
|
||
---
|
||
|
||
## Methode A (empfohlen): SideQuest
|
||
|
||
1. Auf dem PC herunterladen: [sidequestvr.com/download](https://sidequestvr.com/download) → installieren → öffnen
|
||
2. Quest per USB verbinden (Schritte 1–2 oben). Oben links in SideQuest erscheint ein grünes Gerät/Häkchen, wenn die Verbindung steht
|
||
3. In SideQuest die Kachel **„Install APK file from folder on device“** anklicken — oder die APK-Datei einfach **per Drag & Drop** ins SideQuest-Fenster ziehen
|
||
4. Die heruntergeladene `scopedvr-client_v0.1.0-m2b.apk` auswählen → warten, bis **„Installed“** erscheint
|
||
5. Weiter unten bei **„Erster Start in der Quest“** lesen
|
||
|
||
## Methode B (Alternative): Direkt per ADB (ohne SideQuest)
|
||
|
||
1. Die **Platform-Tools** herunterladen: [developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools) → ZIP entpacken, z. B. nach `C:\platform-tools`
|
||
2. In diesem Ordner ein Terminal öffnen (Windows: den Ordner öffnen, in die Adressleiste des Explorers `cmd` eintippen, Enter)
|
||
3. Prüfen, ob die Quest erkannt wird:
|
||
|
||
```
|
||
adb devices
|
||
```
|
||
|
||
→ Es muss ein Gerät mit dem Status **device** gelistet werden (sonst Schritt 1–2 oben wiederholen)
|
||
4. Installieren:
|
||
|
||
```
|
||
adb install -r scopedvr-client_v0.1.0-m2b.apk
|
||
```
|
||
|
||
→ **„Success“** = fertig. (Pfad zur Datei ggf. anpassen, z. B. `adb install -r C:\Downloads\scopedvr-client_v0.1.0-m2b.apk`)
|
||
|
||
---
|
||
|
||
## Erster Start in der Quest
|
||
|
||
1. App-Bibliothek öffnen (Leiste unten in der Kopfleiste)
|
||
2. Rechts oben im Filter **„Unbekannte Quellen“** („Unknown Sources“) auswählen
|
||
3. **ScopedVR** starten
|
||
4. Beim ersten Start fragt die App nach **Mikrofon-Berechtigung** → zulassen (wird für Voice im Spiel gebraucht)
|
||
5. **Nickname** vergeben
|
||
6. Wrist-Panel öffnen → **Server-Browser** → offiziellem Server beitreten
|
||
|
||
---
|
||
|
||
## Probleme?
|
||
|
||
| Problem | Lösung |
|
||
|---|---|
|
||
| SideQuest/`adb devices` zeigt kein Gerät | Datenkabel prüfen (kein reines Ladekabel), Dialog „USB-Debugging zulassen“ im Headset bestätigen, Entwicklermodus (Schritt 1) prüfen + Quest neu starten |
|
||
| App nach der Installation nicht zu finden | App-Bibliothek → Filter **„Unbekannte Quellen“** |
|
||
| Installation schlägt fehl, Meldung wie `INSTALL_FAILED_UPDATE_INCOMPATIBLE` | Erst die alte Version entfernen: `adb uninstall de.slyphax.questtest` — dann neu installieren |
|
||
| „Verbindung fehlgeschlagen“ im Server-Browser | Quest braucht Internet (WLAN). Kurz warten und **Aktualisieren** drücken; falls es dauerhaft scheitert, Sly Bescheid geben |
|
||
| Neue Version installieren | Gleiche Methode wie oben — die neue APK überschreibt die alte, Einstellungen bleiben erhalten |
|
||
|
||
## Sicherheits-Hinweis
|
||
|
||
Diese APK kommt direkt von Sly und ist selbst signiert — sie steht **nicht** im Meta-Store. Warnt Android/Quest vor „unbekannter Quelle“, ist das bei Sideloads normal und hier genau der Sinn der Sache.
|