Advanced Developer Guide
This guide is NOT for students, please refer to the Student Guide.
This is a guide for developers creating new applications for the Wall. Your application will run on multiple virtual machines, please familiarize with the wall setup. The EPL package will provide camera matrix cropping scripts which allow you to create one continuous scene across all of the virtual machines. It also has modifications to the TUIO input package which will allow the touch input to span across 3 MultiTaction screens. You will be required to network objects that move across the virtual machines.
Open a new or existing Unity project.
Import TUIO touchscript:
- Download the TouchScript.unitypackage from https://github.com/TouchScript/TouchScript/releases/tag/9.0.
- Within unity, navigate to Assets > Import Package > Custom Package
- Select the TouchScript.unitypackage from your downloads folder, then import all.
- Allow Unity to update the package.
- The TouchScripts Settings window should appear. Check the Enable TUIO box. Then you can close the settings window.
- Import the advanced developer wall package into your project:
- Important: This package must be installed last, other packages will be partially overwritten.
- Download the latest EPLWall.unitypackage from https://github.com/EPLibrary/UnityWallPackage/releases/tag/Developer_1.0
- Within unity, navigate to Assets > Import Package > Custom Package
- Select the EPLWall.unitypackage from your downloads folder, then import all.
Within the Unity Editor, setup a custom aspect ratio to view your game. Then your workspace will match the wall.
- Click the aspect ratio dropdown in the game view (by default it might say "Free Aspect"), then click to plus sign to add a new viewport.
- Label the new viewport "3 Panels", set the type to Fixed Resolution, set the width to 3240 and height to 1920.
- Create new viewports for each of the following aspect ratios.
You will need to modify your scene to include the tools from the wall package.
- Add the TouchManager prefab to the scene. It is located in the Project folder, Assets/Prefabs/TouchManager.
You can either use the EPLCamera.prefab as your main camera, or make the following additions to your camera:
- Add the PositionWindow.cs script as a component on your main camera in the scene. The script is located at Assets/Scripts/Tools/PositionWindow.cs.
- Add a StandardLayer component to your main camera in the scene.
- Add the camera cropping script.
If your application is going to span across the full zone, then you'll need to use the Chop script to split the camera matrix. Refer to the Camera Guide for more details.
You will be required to use the Touch Package referenced in the installation. There are several examples of touch gestures included in the touch package.
The MultiTaction touch screens use TUIO input sources. This means that the native Unity inputs for touch do NOT work. Do not use this interface in your application. It is designed for smaller touch screens like phones or monitors.
Be flexible with your scene setup. Running the app on your computer is way different running it on the wall, so you may need to adjust things after you've tried it out in person. For instance, since it is such a large space, the player may have to take a few steps to get from one side of the view to the other. So if the UI has buttons on opposite ends, the player probably cannot interact with them both at the same time. Also children cannot reach as far up, so if the game mechanics rely on touching the top of the screen, it will not be accessible for all user.
The wall is not connected to the internet, so make sure your app does not rely on it.