Building the game

To build the game, you have to copy the repository and have the prerequisite tools for building the game:

Unity 5.5.2f1 (with Microsoft SDK)

Visual Studio 2017 or Visual Studio 2015 Update 3

1. Visual Studio 2017 has to have the Universal Windows Platform development workload, Game Development with Unity workload.
2. Visual Studio 2015 has to have Tools (1.4) and Windows 10 SDK (10.0.10586) if using custom install, under Universal Windows App Development Tools node.

(Optional) HoloLens Emulator (requires Hyper-V)

Once you have the tools, you can open the project in Unity – just select one of the top-level directories in the repository from within Unity’s open project dialogue. Once you have the project opened, head into File -> Build settings -> Build… and select a directory where you would like to put the generated Visual Studio project (can be a new directory, we usually use “App” as the directory name). After waiting for the files to be generated, you can now open the “.sln” file inside the top-level of the directory you picked previously. It will have the same name as the Unity project. Once inside Visual Studio, make sure the build settings are set for Release/x86 and then select your preferred target: ‘Device’ for testing on the HoloLens, ‘HoloLens Emulator’ for testing on the emulator (of course). The HoloLens is most efficiently connected via the USB cable provided – you will have to enable developer mode on the HoloLens to use this feature (guide by Microsoft for this and also for deploying over Wi-Fi: https://developer.microsoft.com/en-us/windows/mixed-reality/using_visual_studio). Afterwards the game can be found in the installed programs, so that it can be started without the HoloLens necessarily being attached to a computer.

Running the game

After building the game, or managing to directly sideload the app bundle (https://docs.microsoft.com/en-gb/windows/uwp/packaging/packaging-uwp-apps#sideload-your-app-package), the game should be loaded onto the HoloLens. A spatially mapped mesh of the room should appear after a while, along with highlighted areas in white, where the game recommends the level to be placed. You can now walk around the room to map the room to as high of a quality as you would like. When you are satisfied, you can look at a suitable place (the cursor tells you where the HoloLens thinks you are looking) and air-tap to place the level. Afterwards, you can rotate the level by tapping and holding it and moving your hand on the horizontal. When you are satisfied, just simply tap on the level plane (big white plane underneath the level). This should cause the plane to disappear and the level should now be playable. The menu should also appear.

Controls

Say “show” to make the menu appear and “hide” to make the menu disappear.

Tap on buttons in the menu to play the level, pause the level, reset the level, select a different level, or close the application. The level can only be reset when it is not being played.

Use printed markers to place objects within the game scene. Alternatively, you can move the objects by tapping and dragging them around and double-tapping them to make them rotate 90 degrees – although the marker tracking method is preferable.

Goal

The goal of each level is to get the ball to the goal.