Manual
If you just want to run the apk, install it with SideQuest:
[How to install the App? · cgtuebingen/spatial_xr Wiki · GitHub]
If you want to open and modify it in Unity you need to have Unity (2022.3.30f1 or higher) installed. To open the project, clone our repository or download the "UnityProjekte" folder with everything in it. Now open your Unity Hub and press add project from disk. Then select the folder where you have downloaded the project and select the folder inside the "UnityProjekte" folder. Then the project should appear in the list of available projects. Run it and have fun with it!
If you want to use your own api key, search in the unity project for a script named "APIKey" and insert your own key there. We are using the free api version from https://openweathermap.org/ in the build apks.
If you you are using another api, please make changes, if needed in the "WeatherGetter" script.
To build the modified app, go to the top bar in Unity > File > Build Settings and make sure that you have selected the same settings as shown in the image below. If everything is fine, hit the build button and select a folder to save the apk-file, which you can install on your device. Another option is to build directly to the device, here you need to select a "Run Device" in the Build Settings and hit "Build And Run".
The simplest way to select a location is to use your hands (or controllers) and to just press on a location on the globe. This will open the "Zoom map" right next to the globe, where a more detailed map view will appear. You can select a more precise location by tapping the map. On the zoom map you can scroll by swiping your hand/controllers.
To type in a location's name you just need to hit the text, which says "Loading" or where the currently selected city is displayed. There is a hitbox set, as shown in the picture below.
By clicking the city a keyboard will appear in front of you, where you can type in the name of another city. Hit enter on the keyboard and it will disapear and the weather in the now selected city should be shown. Beware of spelling mistakes, there is no auto-correction!
To rotate the globe, take a look at it's base. There, you will two buttons on the sides. If you hit the right one, the globe will spin clockwise. The left button will rotate the globe counterclockwise. If you cant find the buttons, take a look at the images below.
To move the globe to a different location, you need to grab it at the holo projector, which is located below the globe in the center of the base ring. You can grab it with the hands or with the grip/grab button on the controller:
With the controller you can also aim at the holo from a distance and move it with a ray.
To zoom in and out, when using the zoom map, take a look at the base ring with the clock. Next to the clock, there are 2 buttons. To the right you have a "+"-Button to zoom in, to the left you have a "-"-Button to zoom out. Use them, when the map is open, to zoom in or out.
Take a look at the digital clock, shown below the globe. It has the layout:
[hh : mm | DD.MM.YYYY]
You have 2 active hit boxes, where you can change the time and date. One is for the hours, the other one is for the days. The api that we use allows forecasts up to 7 days.
