updated README

This commit is contained in:
tom.hempel
2025-09-17 14:33:31 +02:00
parent 37efbe8719
commit 00168cf8a2

View File

@ -10,6 +10,40 @@
- `VR_Charades_Paper.pdf` - Research paper
- `Einverstaendniserklaerungen.pdf` - Consent forms
## Installing the VR Application
### Sideloading via SideQuest
Before running experiments, you need to install `app.apk` on your Quest Pro headsets using SideQuest:
#### Prerequisites
1. **Enable Developer Mode** on your Quest Pro:
- Create a Meta Developer account at https://developer.oculus.com/
- Install the Meta Quest mobile app on your phone
- Add your Quest Pro to your account
- Go to Settings → Developer Mode and enable it
2. **Download and Install SideQuest**:
- Download SideQuest from https://sidequestvr.com/
- Install SideQuest on your computer (Windows/Mac/Linux)
#### Sideloading Steps
1. **Connect Quest Pro to computer** via USB-C cable
2. **Put on the headset** and allow USB debugging when prompted
3. **Open SideQuest** on your computer
4. **Verify connection** - SideQuest should show your Quest Pro as connected (green dot)
5. **Install the APK**:
- Click the "Install APK from folder" button in SideQuest
- Navigate to and select `app.apk`
- Wait for installation to complete
6. **Launch the app**:
- In VR: Go to App Library → Unknown Sources → VR Charades
- Or use SideQuest's "Currently Installed Apps" section to launch it
#### Repeat for All Headsets
- Install the APK on all Quest Pro headsets that will participate in the experiment
- Ensure all headsets are connected to the same Wi-Fi network
## Running Experiments
### Prerequisites
@ -161,3 +195,27 @@ Mode format: `<show_head>;<show_facial_expression>;<show_eye_rotation>;<show_han
- **Dynamic modes**: Real-time face/hand tracking
- **Static modes**: Participants use controllers instead of natural movement
## Unity Project Details
### Unity Version
- **Unity Editor**: 6000.0.49f1 (2024.1.19f1)
### Key Dependencies
- **Meta XR SDK Core**: 76.0.1
- **Meta XR SDK Interaction**: 76.0.1
- **Meta XR SDK Movement**: 76.0.1 (local file dependency)
- **Unity XR Interaction Toolkit**: 3.1.1
- **Unity XR Hands**: 1.5.0
- **Unity XR Management**: 4.5.1
- **Unity OpenXR**: 1.14.1
- **Universal Render Pipeline**: 17.0.4
- **Unity Input System**: 1.14.0
- **Unity Timeline**: 1.8.7
### Build Requirements
- Unity 6000.0.49f1 or compatible
- Meta XR SDK 76.0.1
- Android Build Support module
- OpenXR support enabled
- Quest Pro development setup