This project is a simulation of an underwater environmet using VR. the simulation is built using Unreal Engine, and the main point of the project is to use real data, to educate people about the reefs. Currently, this version of the project only has one environment model loaded. The environment model was built using the photogrammetry software Reality Capture and supplied images of the environment courtesy of Flying Fish Technologies. The intended purpose of this project is for it to be deployed in environments like an aquarium in order to educate users about the reef, fish and coral. To download the full version of this code go to this link : https://www.dropbox.com/scl/fi/jqwojqiaae1a42oq8cimz/project17.zip?rlkey=ttnc49c82u7761qk4l3l5w2z8&st=e8uncuju&dl=0. Please note that the file size is several gigabytes.
- Unreal Engine (version 5.4 or later) link : https://www.unrealengine.com/en-US/download
- Meta Quest Link app : https://www.meta.com/en-gb/help/quest/articles/headsets-and-accessories/oculus-rift-s/install-app-for-link/
- Meta Quest VR headset
- SteamVR : https://store.steampowered.com/about/ For an alternative approach
If you are having trouble installing Unreal Engine watch this guide here : https://www.youtube.com/watch?v=ODxm8iuOVak
Download and Unzip the codebase, then double click the Unreal Engine project file to open the project. Now click the content drawer to view all the files. The files we made changes to or created are:
- FirstPerson/Blueprints/BP_FirstPersonCharacter : Contains code for the first person pov, how it interacts with items. Changes made, Created function looking.
- View_fish/Items/Item_1 : A grabbable fish item that has code on how the user interacts with it and what it should do if interacted with. Created by us
- View_fish/UI/Display_help : Widget code. Created by us
- View_fish/UI/Inspection : Widget for first person POV. Created by us
- View_fish/UI/InspectionVR : Widget for VR POV. Created by us
- VRTemplate/Blueprints/VRPawn : Contains code controlling the VR pov as well as actions and functions. Changes made, Created functions are looking, toggleinspect, areacheck, stopinspect
For the UI widgets look at the top right and click Graph to view the blueprint.
In the content drawer, navigate to Stage/level to view the completed level. It is possible to run without a VR headset.
If you are having trouble installing steam watch this guide here : https://www.youtube.com/watch?v=zkETI3ITNHc
Make sure your Meta Quest VR headset is already setup before beginning.
You will have to link your Meta Quest VR headset to the PC Meta Quest Link app on your computer to the using either a cable or via air link. First you will have to download and setup the Meta Quest Link app on your PC. Make sure to use the same account that you use for your actual Meta Quest VR headset on the Meta Quest Link app. If you're struggling refer to the video here: https://www.youtube.com/watch?v=BTCtMrEbZQo&t=20s
Then you can link your Meta Quest VR headset to your PC using either air link or a cable. If you are having trouble linking your VR headset to your PC, follow the guide on the official Meta Quest page here: https://www.meta.com/en-gb/help/quest/articles/headsets-and-accessories/oculus-link/connect-with-air-link/
Now download the Unreal Engine file and unzip. Now open the entire project by double clicking the Unreal Engine project file.
In order to setup the Meta Quest VR headset to link with the Unreal Engine, make sure to set the camera mode to VR in the project settings -- TODO: DOUBLE CHECK SETTING NAMES. For more information, this guide gives a good breakdown of what you should do to setup the file so it can be previewed in VR: https://www.youtube.com/watch?v=Z4sClxhgsxk
Once thats all done, click the content browser in the bottom left of the Unreal Engine and open the file called Stage. Then click on the file called level. This should open the currently setup VR environment.
If you setup the link level beforehand so that you could run the level in VR, You should see the green triangle in the top. Click this to then run the enviroment, allowing you to test and experience the prototype. Otherwise, you could also open your desktop in the Meta Quest 2 Link on the headset itself and press the green arrow with the controller, which will also run the project in VR directly.
Feel free to reach out if you have any issues.
- Fish Collection by shedmon : https://sketchfab.com/3d-models/fish-collection-84a4238a77e541f0ae7db54ccf9f6d8e No changes made
- Yellow tang by JayNme : https://sketchfab.com/3d-models/oxidane-yellow-tang-5750f70ac6734728b0eb3ed81de9bb2d No changes made
- Triggerfish by Jivo3dAssets : https://3dexport.com/3dmodel-triggerfish-416259.htm Some changes made
- Coral beauty fish : https://free3d.com/3d-model/coral-beauty-angelfish-v1--473554.html No changes made