Embodied Code

A Platform for Embodied Coding in Virtual and Augmented Reality

Overview Documentation Web Editor

Getting Started (non-developer)

Getting started with Embodied Code on the Quest 2 headset:

Using the Embodied Coding Environment:

Sharing Your Experience:

Put your headset in developer mode

Follow this guide to setting up developer mode on your headset. Roughly:

  1. Register as a developer with Oculus
  2. Use the Oculus App on your phone to connect to your headset and enable developer mode
  3. Reboot your headset and verify the settings menu now shows developer settings
  4. Make sure to enable the USB connection dialog in developer settings

Install our App

  1. Download the latest release [here](https://github.com/xrdesign/EmbodiedCoding/releases/) or

    obtain an APK from the dev team.

  2. Download SideQuest - SideQuest is an application that lets you install applications that have not been registered with Oculus and checked for viruses. Only sideload applications from people that you trust, as this bypasses a lot of security.
  3. Connect your headset to your computer. You headset should ask you if you want to allow USB Debugging on the device you just connected. Click Allow/Always. SideQuest should now show a green icon in the top left indicating that it has successfully connected. What you have done is allowed your computer (and SideQuest which runs on your computer) to control your headset, install software, uninstall software, read your files, etc.
  4. In the top right of SideQuest, there is a list of icons, click on the “Install APK” button and find the .apk file you downloaded in step 1.
  5. SideQuest should notify you when the install succeeds/fails.

Launch the App

  1. In the Quest 2 home screen, open the Apps Drawer (grid of squares)
  2. In the top right, there is a drop down menu that allows you to filter your applications. By default it is set to “All Applications”. This is misleading. Click the dropdown, and filter by “Uknown Sources”.
  3. Select the EmbodiedCode application and it will launch.

You are now running the Embodied Code system.

Updating the app

To update the app we will need to delete the current APK, and then copy the new APK. This assumes you have a copy of the APK downloaded from our website.

Delete the current APK

  1. Connect your device to your computer. In the headset, allow USB access to data.
  2. In sidequest, click the Currently Installed Apps button in the upper right.
    • image
  3. Under the list of apps, click the Gear icon next to xrdesign.embodiedcode to open up the app details
    • image
  4. Under Manage App, select Uninstall App
    • image

Install a new APK

  1. With your quest still connected, in Sidequest click the “Install APK from folder on your computer”
    • image
  2. Select the new APK you have downloaded above (likely devel.apk). And click install.

Using the Embodied Coding Environment

Intro Tutorial

For a brief introduction, start the app and follow the introductory tutorial. Click “yes”.

This tutorial will walk you through making a node (object_cubes) and UI element (ui_slider_integer), connecting them up, and using these to create in-game geometry you can manipulate with physics.

Press the menu button on your left controller to access the main menu. Check out detailed decriptions for each section on this page. image

Popcorn Example

To continue to an intermediate level example, click “Load Scene”:

You should see the Popcorn example. Exlore the different nodes and try to ascertain what the system is doing.

Streaming Your Headset

You can stream your Quest 2 view to a compatible web browser (Chrome, Edge, or similar). Make sure your browser and headset are on the same wifi network.

In your browser, go to https://www.oculus.com/casting:

On your Quest 2, press the Oculus Button, go to Sharing, select Cast, select Computer, and your stream should show up in the browser!

You can share this in Zoom or similar via screenshare.