Академический Документы
Профессиональный Документы
Культура Документы
Guide
For Unity 3D +Android
Alpha Version 1.032a
All trademarks, service marks, trade names, trade dress, product names and logos appearing on
this documentation are the property of their respective owners.
Copyright 2015 ImmersiON-VRelia Inc. All Rights Reserved.
Contents
1.
Overview, 3
1.1. About this SDK, 3
1.2. Features, 3
1.3. Required Software, 3
1.4. Installation, 4
1.5. Basic Usage, 7
1.6. Sample Project, 9
1.7. Differences between Unity Free and Unity Pro, 9
2.
Editor, 10
2.1. Menu, 10
2.2. ImmersiON-VRelia Components, 10
2.3. Folder Structure, 11
2.4. VR Parameters, 12
3. Project Configuration, 14
3.1. Android Setup, 14
3.2. AlterSpace Connectivity, 16
4.
5.
Performance and Stereoscopic Comfort, 20
5.1. Optical correction, 20
5.2. Image Effects, 20
5.3. Dynamic Convergence, 20
5.4. Tips, 21
1. Overview
1.1. About this SDK
ImmersiON-VRelia offers a free Unity 3D SDK to greatly simplify VR
development for our
hardware devices and enable seamless and consistent integration into our VR
ecosystem. This SDK will handle device based calibration, simplify 3D side by
side rendering, and allow users to tweak stereoscopic parameters at run time.
With some of the hard stuff out of the way, developers can focus on creating
the best quality content.
We are going to constantly improve this SDK and add new features making easy
for you to get the best of your work on our devices.
1.2. Features
Easy integration.
Presets for first and third person controllers.
Compatible with a large number of devices - mobile and VR.
Advanced sensor based head tracking.
Standard gamepad compatibility.
1.4. Installation
To start a new Unity VR project using this SDK:
Open or create a new Unity 3D project.
Select File -> Build Settings and set the compilation platform to Android.
Use the import option from Assets -> Import Package -> Custom
Package.
2. Editor
2.1. Menu
The SDK creates a new menu in the Unity application menu bar called
ImmersiON-VRelia.
It adds a convenient way to add the most commonly used SDK assets which can
be found in Assets / ImmersiON-VRelia / Prefabs.
ImmersiON-VRelia Main
ImmersiON-VRelia Menu
ImmersiON-VRelia Player Controller
ImmersiON-VRelia Camera Controller
10
Scripts:
ImmersiONVRelia Main.
Controls the real time execution of the SDK. VR parameters
can be configured in the Unity inspector (Please check the
VR parameters section).
Camera:
ImmersiONVRelia MouseLook.
Provides mouse based movement of the camera when no
accelerometer/gyroscope is available. (Like the Editor).
ImmersiONVRelia Tracker.
Provides precise head tracking based on a mobile phones
sensors. It works great with devices like the ImmersiON-VRelia
GO.
Example Project: Full sample project with all its assets and resources.
Example Scripts: Sample scripts to use with the SDK.
Materials: Materials used by the SDK basic scene.
Prefabs: Basic game objects useful in setting up your VR scenes.
Resources: Resources included in the SDK.
Scenes: Basic sample scene included with the SDK.
Scripts: Script components that the SDK uses.
Textures: Textures that the SDK uses.
You can find the libraries used by the SDK in Assets / Plugins. The Assets /
Plugins /Android folder contains an AndroidManifest.xml file.
Once configured, this manifest file can be used to easily integrate with our
AlterSpace virtual environment. Please check the Android Manifest
Configuration section.
11
2.4. VR Parameters
These parameters are included in the ImmersiON-VRelia_Main script. You can
use them to
configure your VR scenes. We provide tooltips in the Unity inspector for each
of these.
12
13
3. Project Configuration
Here are some steps to follow for Android project configuration and AlterSpace
compatibility.
14
For
15
in your Company Name and Product Name and in Other Settings the
Bundle Identifier.
16
17
18
4.
The SDK provides some scene managers which are coordinated through
the ImmersiON-Vrelia Main object:
Input Manager: The SDK uses a personalized Input Manager to
control the proprietary menus and the custom controller.
The following controls are included by default with this SDK, and they are
optimized for use with the ImmersiON-VRelia ViaPlay official gamepad.
Gamepad
Keyboard
SDK
Left Stick
W,A,S,D
Movecontroller
Horizontal, Vertical
Right Stick
9,I,O,P
Rotate player
Horizontal2, Vertical2
D-pad
8,4,6,2(numpad)
Modify menu
HorizontalDPad,
VerticalDPad
--
BtnY
--
BtnX
--
BtnB
--
BtnA
Start
Return
Show/hide menu
Show/hide menu
Select
Backspace
--
Select
Home
--
--
--
Menu
--
--
--
Back
--
--
--
L Shoulder Axis
--
LShoulderAxis
R Shoulder Axis
--
RShoulderAxis
L Shoulder Button
--
LShoulderButton
R Shoulder Button
--
RShoulderButton
19
20
5.4. Tips
We suggest to import the SDK TimeManager.asset and use their
Fixed Timestep and
Maximum Allowed Timestep to get better
performance with Unity physics.
Please setGraphics Level to the value Force Open GL ES 2.0 in
PlayerSettings / Other Settings option.
21