Skip to content
This repository was archived by the owner on Feb 1, 2022. It is now read-only.

Commit

Permalink
Finish README
Browse files Browse the repository at this point in the history
  • Loading branch information
Jonathan (Alex) Jones authored Apr 16, 2019
1 parent 2898e92 commit 85b2e1c
Showing 1 changed file with 15 additions and 4 deletions.
19 changes: 15 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,11 @@ Configure the port forwarding by selecing the `Port forwarding...` button. Add t
- `localhost:1234` for the http that forwards to localhost:1234
- `localhost:64320` which is how Parcel does it's live updating stuff

Be sure to check the `Enable port forwarding` box at the bottom of the `Port forwarding...` modal.

In order for the port forwarding to work on your device, there are some settings you need to enable.

*settings info here*
Please follow the instructions [`at this site`](https://www.embarcadero.com/starthere/xe5/mobdevsetup/android/en/enabling_usb_debugging_on_an_android_device.html) to enable USB debugging on your android device.

Now, connect an Android device with Daydream support via a USB cable and install and open Chrome Dev on your device. There are a couple flags that need to be enabled. Go to `chrome://flags` and ensure the following flags are enabled:
- WebXR Device API
Expand All @@ -35,7 +37,7 @@ Configure the port forwarding by selecing the `Port forwarding...` button. Add t
Go to `localhost:1234`. Click the 'check it out' button and you're in! There should be an 'EnterVR' button in the top left of the screen. Click it to enter immersive VR mode.

## Working with HMDs (VIVE/Oculus)
*Currrently, there are some issues with using/setting up HMDs. We met with our client in person on April 5th and he was able to get it working on his VIVE. However, we are unable to manage to get it working with the steps he provided us (down below). For now, we recommend only testing using a Daydream device, although feel free to attempt to get it working using the instructions given.*
*Currrently, there are some issues with using/setting up HMDs. We met with our client in person on April 5th and he was able to get it working on his VIVE. However, we are unable to manage to get it working with the steps he provided us (down below). At the moment it appears to be an issue with the WebXR API itself. For now, we recommend only testing using a Daydream device, although feel free to attempt to get it working using the instructions given.*

In order to use an HMD (head mounted display), such as a VIVE or Oculus Rift, you first need to download Steam and SteamVR. Assuming you have connected your device, start up SteamVR and then open `localhost:1234` in your Chrome Dev browser. Ensure that the following flags are enabled by going to `chrome://flags` and enabling:
- WebXR Device API
Expand All @@ -45,9 +47,18 @@ In order to use an HMD (head mounted display), such as a VIVE or Oculus Rift, yo

At `localhost:1234` click 'check it out' to load the home room. There should be an 'EnterVR' button in the top left of the screen. Click it to enter immersive VR mode.

## Scene not loading?
For unknown reasons, the scene you are trying to enter may not load the first time you try to enter it. If you observe a blank screen when entering a room, all you have to do is back navigate to the previous room/page then try again.

# How to use the experiments:
## The Falling Objects Scene
Once you enter the falling objects scene you should be able to see a table with a cube and a sphere on it. Clicking either of these will generate a new object that you can interact with that falls from a chute in the ceiling. The newly created objects can be thrown around and used to interact with the other objects in the scene.
## Movement
To move around a scene (except the planets scene) in magic window sessions, drag the small circle in the bottom left portion of the screen. In immersive sessions, you can move about the scene by selecting a point on the floor to teleport instantaneously to that spot.

## The Home Scene
This room can be accessed by selecting `Check it out!` on the landing page. In this room you will find four doors. Each are labled with their respective scene. Selecting a door (either through touch or VR controller) will navigate you to the scene behind the door.

## The Kinematic Sandbox Scene
Within the kinematic sandbox scene you should be able to see a table with a cube and a sphere on it. Clicking either of these will generate a new object that you can interact with that falls from a chute in the ceiling. The newly created objects can be grabbed with your laser, thrown around and used to interact with the other objects in the scene. Beyond the table is a pair of two buttons that enable and disable earth gravity. Selecting the ON button sets the gravity in the scene to 9.8 m/s while selecting the OFF button sets the gravity in the scene to 0.0 m/s.

## The Pendulum Scene
Once you enter the pendulum scene, you should see two pendulums on a table and a list of planet's on your left. The lighter blue planet icon is the planet that you are currently on. You can drag the pendulum's swings to start them swinging. If you want to stop the pendulums swinging you can either switch planets or pickup the pendulum and then place it back on the table.
Expand Down

1 comment on commit 85b2e1c

@vercel
Copy link

@vercel vercel bot commented on 85b2e1c Apr 16, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sign in to comment.