Skip to content

Commit

Permalink
Updated README, updated AndroidManifest, changed build organization, …
Browse files Browse the repository at this point in the history
…removed Git from the repository, and removed controller support from the app
  • Loading branch information
juchong committed Dec 8, 2024
1 parent eb17a4b commit 6f27dca
Show file tree
Hide file tree
Showing 8 changed files with 477 additions and 69 deletions.
22 changes: 8 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,9 +85,11 @@ At it's heart, QuestNav is merely a VR app designed to push data to Network Tabl
3. Configure the following settings on your Quest headset:
- Enable travel mode ([link](https://www.meta.com/help/quest/articles/in-vr-experiences/oculus-features/travel-mode/) to instructions)
- Set the display timeout to 4 hours in `Settings > General > Power > Display off`
- Enable battery saver mode in `Settings > General > Power > Battery saver mode`
- Disable WiFi in `Settings > WiFi`
- **NOTE:** Be sure to completely turn off WiFi, otherwise the headset will constantly disconnect from the robot network as it tries to look for the internet.
- **NOTE:** Be sure to completely turn off WiFi, otherwise the headset will constantly disconnect from the robot network as it tries to look for the internet
- Disable Bluetooth in `Settings > Bluetooth`
- **NOTE:** Disabling Bluetooth will break the companion app functionality
- Disable the guardian for development purposes `Settings > Advanced > Experimental Settings > Enable Custom Settings` and **TURN OFF** `Physical Space Features`, `MTP Notification`, and `Link Auto Connect`
- These settings might also be located in `Settings > Developer > Experimental Settings > Enable Custom Settings` on some older OS builds
4. Plug the headset into your PC and install the example .apk using MQDH or adb (`adb install QuestNav.apk`)
Expand Down Expand Up @@ -136,15 +138,6 @@ The main editing window will only open if a project is active.
- Click on the newly imported project
- Wait for Unity to compile assets and open the main interface

### Install the Git for Unity plugin

Git for Unity is included in the project, but you may need to re-initialize it the first time that the project is imported.

- Open the asset manager by selecting `Asset Store > My Assets`
- Remove and reinstall the `Git for Unity` and `Git for Unity UI` packages
- Close and open Unity
- Git for Unity should now detect your forked repository

### Install the MessagePack plugin for Unity

This package is required by the C# Network Tables library.
Expand All @@ -157,11 +150,12 @@ This package is required by the C# Network Tables library.

Be sure to resolve any Project Setup Tool warnings that appear in the `Console` tab! You need to look for warnings in both the `PC` and `Android` tabs to successfully build your Unity project.

### Change the build target to Android and ttempt to build the project
### Build your project using the OVR build tool

- You may need to change the build target to Android in `File > Build Profiles`
- Click `Build` and cross your fingers
- If everything works, then you should be good to go!
- The build tool is located in `Meta > OVR Build > OVR Build APK...`
- Set your desired OVR build path and click `Build`
- This tool prioritizes build speed above all else, so it will consume all CPU resources for a few minutes!
- If everything works, then upload the .apk to your headset!

### Link Unity to Visual Studio for debugging

Expand Down
7 changes: 5 additions & 2 deletions unity/Assets/Plugins/Android/AndroidManifest.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,12 @@
</activity>
<meta-data android:name="unityplayer.SkipPermissionsDialog" android:value="false" />
<meta-data android:name="com.samsung.android.vr.application.mode" android:value="vr_only" />
<meta-data android:name="com.oculus.ossplash.background" android:value="black" />
<meta-data android:name="com.oculus.ossplash.background" android:value="passthrough-contextual" />
<meta-data android:name="com.oculus.telemetry.project_guid" android:value="dad159d0-f6e9-449e-b113-ef571c59c4e1" />
<meta-data android:name="com.oculus.supportedDevices" android:value="quest|quest2|questpro|quest3|quest3s" />
<meta-data android:name="com.oculus.supportedDevices" android:value="quest2|questpro|quest3|quest3s" />
</application>
<uses-feature android:name="android.hardware.vr.headtracking" android:version="1" android:required="true" />
<uses-permission android:name="com.oculus.permission.USE_ANCHOR_API" />
<uses-feature android:name="com.oculus.feature.PASSTHROUGH" android:required="false" />
<uses-permission android:name="com.oculus.permission.USE_SCENE" />
</manifest>
Loading

0 comments on commit 6f27dca

Please sign in to comment.