TUTORIAL：Unity Asset building instructions
arcAstroVR is programmed using Unity, and the program source (unitpackage format) can be obtained from the Download page. The following is a description of how to build the program.
Get & build the code
arcAstroVR is programmed in Unity. This section describes the setup from a new Unity project (any template is acceptable, but 3D Core is recommended).
Asset Installation
arcAstroVR requires the following Unity Assets
Input System (Unity Registry：Free)The new INPUT SYSTEM of Unity is used to support various input devices. It is not installed by default and requires additional installation.
Localization (Unity Registry：Free)The LOCALIZATION of Unity is used for multilingual support. It is not installed by default and requires additional installation.
XR Interaction Toolkit (Unity Registry：Free)The XR INTERACTION TOOLKIT of Unity is used for HMD support. It is not installed by default and requires additional installation.
3rd Person Controller + Fly Mode (Asset Store：Free)This is a free 3rd-party asset for 3rd-person avatar control, available from the Asset Store.
JSON Object (Asset Store：Free)Free 3rd party assets used for JSON communication with Stellarium, available from the Asset Store.
Dome Tools（Asset Store：Free）Free 3rd party assets for dome projection, available from the Asset Store.
TriLib2 (Asset Store：$49.50)3rd party paid assets for loading 3D models, available from the Asset Store.
Follow these steps to install and setup Assets.
Select Window > Asset Store from the menu bar to open the Asset Store.
Search for 3rd Person Controller + Fly Mode and press the Add to My Asset button to obtain the Asset.Free and Mobile versions are available, but the Free version will be used.
Search for JSON Object and press the Add to My Asset button to obtain the Asset.Use the one created by Defective Studios.
Search for Dome Tools and press the Add to My Asset button to obtain the Asset.Use the one created by At-Bristol.
Search for TriLib 2 and press the Buy Now button to obtain the Asset.Use the one created by Ricardo Reis.
Select Window＞Package Manager from the Unity menu bar to open the Package Manager.
From the Package tab, select Unity Registry , then click Input System from the list on the left hand side and click the Install button.Select YES when the RESTART WARNING appears.
From the +▼ tab, select Add package by name ... and enter com.unity.localization in the Name field and click the Add button.You can also install by selecting Localization from the list as well as Input System , but if you have an older version (Version 1.0.5), please install the latest version by the method described above.
From the +▼ tab, select Add package by name ... and enter com.unity.xr.interaction.toolkit in the Name field and click the Add button.When the Update request comes, click the I Made a Backup, Go Ahead ! button.
Click the XR Interaction Toolkit in the left-hand list and click the Import button under Samples Starter Assets .
From the Package tab, select My Assets , then click the JSON Object in the left-hand list and click the Import button. Import button.
Click the 3rd Person Controller + Fly Mode in the left-hand list and click the Import button. When a Warning appears asking if you want to Switch Project, click the Import button. After that, the Import list will be displayed, but since it is not necessary to change the project settings, remove the check mark from ProjectSettings and click the Import button.
Click the Dome Tools in the left-hand list and click the Import button.
Click the TriLib2 in the left-hand list and click the Import button. In the Import list, we know that Newtonsoft.Json.dll in Packages causes a conflict error, so remove the check mark from Packages and click the Import button.
Download the arcAstroVR unitypackage .
Select the arcAstroVR unitypackage from Assets>Import Package>Custom Package in the menu bar and click the open button. After that, when the Import list is displayed, click the Import button.
Project Settings
Select Edit＞Project Settings... from the menu bar to open the Project Settings.
Click the Localization in the left-hand list and select Localization Settings from ActiveSettings.
Click the Player in the left-hand list and select Localization Settings from ActiveSettings. Select Input System Package (New) for Other Settings : Configuration : Active Input Gandling .
Click the XR Plugin Management in the left-hand list and click Install XR Plugin management .InitializeXR on Startup checkbox. OpenXR checkbox. *Windows only *For Mac, all the above checks should be unchecked since it does not yet support the OpenXR.
Click the Preset Manager in the left-hand list and click Add Default Preset .*Windows only ：Component>XR>XR Controller(Action based) .(none) , Preset : XRI Default Continuous Move (none) , Preset : XRI Default Continuous Turn (none) , Preset : XRI Default Snap Turn Left , Preset : XRI Default Left Controller Right , Preset : XRI Default Right Controller For Mac, all the above XR controller settings are not necessary since the XR function is not yet supported.
Program execution
Open the scene file Assets/arcAstroVR/Scences/arcAstroVR from the Project folder.
Click the Run Button
References and Assets
The arcAstroVR asset is programmed based on the Unity Asset "stellarium-unity" developed by Georg Zotti (LBI ArchPro Vienna), John Fillwalk (IDIA Lab, Ball State University), David Rodriguez (IDIA Lab, Ball State University ), and Neil Zehr (IDIA Lab, Ball State University).
License
Released April 1, 2022 under GPLv3.