scopedvr-playtest/SIDELOAD-ANLEITUNG.md

4.4 KiB
Raw Permalink Blame History

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

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 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 → 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 → 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.