Unity Game Engine Camera System

A guide to installing, running, and adding your own settings to the igloo 360 unity camera system.

Prerequisites

Before staring you must have completed the following steps.

1. Downloaded the current Igloo Camera package from Igloo Vision.
2. You should have unity installed, and updated (to whichever camera package you require) 
3. Extract the igloo camera package to somewhere accessible, such as your desktop.

Installing the package

It is recommended that you first import the camera package into a new Unity project, this helps eliminate potential issues during installation. To import the camera package from within the Unity Editor go to Assets > Import Package > Custom Package and open the file with a ‘.unitypackage’ extension included in the zip folder.

Configure Project Settings

Go to Edit > Project Settings > Player and apply the following changes

• Default is Fullscreen = False
• Run In Background  = True
• Display Resolution Dialog = Enabled

The Igloo camera package requires some custom Input settings to be compatible with an Xbox controller. This can be done one of two ways;

1. If you are importing the camera package to a new Unity project then you can replace the InputManager.asset file found in YourProjectDirectory > ProjectSettings > InputManager.asset with the one included in the camera package.
2. If you are importing the camera package to an existing project you may need to manually add the required input axes. If you have not made any changes to the Input manager you can simply replace the InputManager.asset file as described above. Alternatively you should create a new Unity project and replace the InputManager.asset file as described above, then copy the Input Manager settings found in Edit > Project Settings > Input to your project.
3. You must change the 

Scene Setup

For an example of how to set up a scene to be compatible with an Igloo, open the demo scene found in IglooTools > Scenes > DynamicCameraCreation
There are two main prefabs Igloo and IglooPlayer. Which can be found in IglooTools > Prefabs

The Igloo Camera can also be created and destroyed via code using the public functions defined in the IglooCameraCreator.cs script.

CreateCamera(int index) - Takes one parameter of type int which specifies which camera type will be created, if an Igloo camera already exists in the scene it will be automatically be destroyed before a new one is created.

DestroyCamera() - Takes no parameters and destroys the Igloo camera if one exists in the scene

Follow Transform

You can assign a Game Object for the Igloo Camera to follow. If you are using the IglooPlayer prefab it will be followed automatically and no GameObject needs to be assigned.

IglooPlayer -  You don't need the custom Igloo controller but it makes navigation within the igloo much much easier as can be seen in this video.

This works using a custom Xbox controller with a gyroscope attached to it, which provides orientation data via OSC, so the direction the user is facing in the Igloo is known.   Using the custom Xbox controller creates a natural pointing device on the screen so that when you press forward on the xbox controller you move in the direction you are physically facing.

The IglooFirstPersonController component attached to the IglooPlayer prefab has a number of control methods depending on which hardware controller is being used (Keyboard Mouse, GyrOSC, Igloo Custom Xbox) these can be specified using the drop down menus under the ‘Igloo Settings’ section of the parameters.

Keyboard and Mouse

Use the following settings on Igloo IglooFirstPersonController

Rotation Input - MOUSE

Movement Input - UNITY

GyrOSC

Use the following settings on IglooFirstPersonController

Rotation Input - GYROSC

Movement Input - GYROSC

For testing purposes we use an iOS app called GyrOSC which allows us to steam gyroscope data from a mobile device to Unity over a network, here’s how

• Download the GyrOSC (iOS) app.
• Join the same wifi network on your computer running unity and your phone running GyrOSC
• Open GyrOSC and copy the settings below, replacing Target IP Address with the IP address of the computer running Unity.
• When Unity is running the numerical buttons control movement {1- Forward, 2- Backward, 3- Left, 9- Right}

Building the project

When building the project for the first time, follow the following procedure. 

Run Scene

Included in the package is an app for previewing the output of the 360 Camera, Igloo Preview. When running your Unity scene you should see the 360 degree view being displayed in the Igloo Preview app, similar to the image below.

Command Line Arguments

To use command line arguments, create a shortcut of the built .exe, then right click > properties then add any arguments to the 'Target' text field.

The following command line arguments can be used

OSC Protocol

Player

Camera

System