Skip to content

Student Project Guide

haleyrequa edited this page Oct 6, 2023 · 18 revisions

This is a guide for post secondary students working on the Wall. Your application will run on a single virtual machine, which spans 3 Multitaction touch screens. It will be part of a larger student exhibit, where multiple student games will run along side each other. You will not be required to do any networking or camera cropping. The size of the physical screen that your game will be displayed on is 2m wide by 1.2m tall.

alt text


Installation Instructions:

  1. Open a new or existing Unity project.

  2. 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.
  1. Import the student wall package into your project:
  • Important: This package must be installed last, other packages will be partially overwritten.
  • Download the latest StudentWall.unitypackage from https://github.com/EPLibrary/UnityWallPackage/releases/tag/Student_1.0
  • Within unity, navigate to Assets > Import Package > Custom Package
  • Select the StudentWall.unitypackage from your downloads folder, then import all.

Unity Setup

Unity Game View

Within the Unity Editor, setup a custom aspect ratio to view your game. Then your workspace will match the wall. The viewport will span 3 Multitaction touch screens, each of these screens has a resolution of 1080x1920. The total game viewport should be set to 3240x1920.

  1. 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.
    alt text
  2. Label the new viewport "3 Panels", set the type to Fixed Resolution, set the width to 3240 and height to 1920.
    alt text

Package Tools

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. Make sure this is the prefab from the EPL package, not the one from the TUIO touchscript package (you should see a Remapper script on the prefab).
  • Add the PositionWindow.cs script as a component on your main camera in the scene. The script is located at Assets/Scripts/PositionWindow.cs.
  • Add a StandardLayer component to your main camera in the scene.

Touch

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.


Create a Video

We would like you to create a short 10-30 second video of your game. This will be played on the large upper planar screen. There will be a loop that cycles through all of the student game videos. The Xbox Game Bar is a free resource that can record your screen while you play your game.


Tips

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.

Clone this wiki locally