Skip to content

ViveSoftware/Jelbee-MR-Demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jelbee MR Demo

Copyright 2024, HTC Corporation. All rights reserved.

About

Jelbee MR Demo is an MR experience example for VIVE XR Elite. It demonstrates MR applications such as virtual room setup, gestures, interactions, and grabbing objects into MR. There are four experiences in the Demo:

  • Whack-A-Mole on the desk
  • Bubbling with OK gesture
  • MR Portal
  • Grabbing planets into MR

Requirements

  • VIVE XR Elite, VIVE Focus Vision
  • Unity 2019.4.28f1 or newer
  • VIVE Wave XR Plugin 5.2.1-r.1 or newer
  • VIVE Input Utility 1.18.0 or newer

Settings & Build Setup

  • Set Build Settings > Platform to Android
  • Import [Customizable Planet Shaders] package into project.
  • Set BaseScene as the starting scene
  • Check WaveXR in Project Settings > XR Plug-in Management > Initialize XR on Startup

How to Walk Through the Game Flow in Editor

  1. After opening the project, open the Base Scene and click the play button.
  2. Press the Spacebar to simulate pressing the virtual start button.
  3. Level 1 Desktop Whack-A-Mole : Press the spacebar to simulate pat Jelbee.
  4. Level 2 Bubbling OK gesture : Use cursor to control the direction of the bubble spray.
  5. Level 3 MR Portal-Forest : Use the cursor to draw circle and shoot the portal, it can only be shot on the virtual wall.
  6. Level 3 MR Portal-Universe : Press the Spacebar to generate planet.

How to Play with XR Elite

  1. First of all, you need to setup the environment in Settings / Boundary / MR Room Setup, this demo requires surrounding walls, a table and a window.
  2. Build the project as an Android apk and install it with adb.
  3. Start the app, press the A button on the right controller to set pivots in the environment. You need to specify the pivots of a wall, a window on another wall and a table.
  4. Put down the controller and directly press the virtual start button on the table by your hand.
  5. Level 1 Whack-A-Mole : Pat Jelbee with your hand, hit Jelbee three times to enter the next level.
  6. Level 2 Bubbling : Use the OK gesture to make bubbles, make bubbles to Jelbee three times to enter the next level.
  7. Level 3 MR Portal-Forest : Draw a circle towards the wall to create a portal. The first portal only shows the forest outside, and it will be closed automatically after 10 seconds.
  8. Level 3 MR Portal-Universe : Draw a circle towards the wall to create a portal. The second portal is the space environment, when the sun appears, make fist gesture to grab a planet in, when you open your hand, the planet will join the solar system.

Developer Guidelines

  • MRFlowManager.cs : The main game flow.
  • SceneComponentManager.cs : Load the plane data which users created in MR Room Setup.
  • PivotManager.cs : Allows developers to customize keys and pivot for the planes needed in the game, also specify the required plane by reading the configuration file. For example, the key "Desk" can get the virtual desktop pivot position specified by the user.
  • SetupManager.cs : Let user specify the plane corresponding to the key.
  • PortalSceneManager.cs : The flow of the MR Portal levels and the drawing method of the portal.
  • PortalBallBehaviour.cs : If you want to add a new portal, you need to inherit this script, such as UniversePortalBall.cs.
  • Hand Occlusion : Virtual hand model already support occlusion and virtual lighting (play on planet of Level 3 MR Portal-Universe). If you want to realize occlusion sample, you can follow material on the hand mode prefab Arts / CutsomHand.
    1. Hand Shadow (preview)
      In this version, you can turn on shadow setting to feel immersive virtual interaction.

    2. Hand Virtual Lighting (preview)
      In this version, you can use lighting effect overlap on the real hand to feel immersive virtual interaction.

Third Party Assets

License

See LICENSE.pdf for more information.

Contact Us

Email: [email protected]