Importing into Unity and Creating a Package

​

Importing Models

Accessing the Import Settings window

1. Open the Project window and the Inspector so that you can see both at once.
2. Select the Model file you want to import from the Asset folder in the Project window. The Import Settings window opens in the Inspector showing the Model tab by default.

Setting Model-specific and general importer options Use Scale Factor to adjust the model scale, real-world scale is preferable. Click the Material tab from the Import Settings window. From the Material Creation Model drop-down menu, choose ‘Use External Materials (Legacy)’ option. Click ‘Apply’ to confirm your settings

​

Creating a Unity Package

Altoura separates its content into two Unity prefabs: Dollhouse & Realscale. Dollhouse is the three dimensional miniature version of your space. The Dollhouse allows you to see the entire space at a smaller scale, and to teleport around the space. In a head mounted display like HoloLens, you will see the Dollhouse at about waist height, surrounded by a ring when you anchor a project. On a screen device, like an iPhone or PC, you will see this model when you first open the project. Realscale is the version of the model that a user will physically or virtually around in in the app. The content in this prefab will appear at “real-scale.” The goal is to organize the content into these two chunks so that the app will organize teleportation and anchoring for you. In the Altoura Toolkit there is a scene called ‘Basic Scene’ that you can copy an example of the Realscale and Dollhouse prefab. In the example prefabs we use the Cube and Sphere as placeholder content. The two things required in each the Dollhouse and Realscale prefabs are:

• Floor: defines the walkable area in the space.
• DefaultMeeplePosition: the location that the user will start at when entering the space

Keep these objects identical in both prefabs. Once you have your Dollhouse and Realscale prefabs, select both in the Unity editor Project window and export them as a Unity Package. Now your content is ready to upload to the Altoura Portal!

​

Testing Tips & FAQ

If you’re have an issue with your content in Altoura after you’ve uploaded to a space in the Altoura portal, run through the steps above to make sure you’ve set up your asset bundle correctly. It may be one of these: Space Isn’t Loading? This could be a few things:

• You may be building on a too new or too old version of Unity, ensure you are building on a Unity 2019.3 variation.
• You may have scripts on objects in your prefabs, Unity asset bundles do not process with scripts. Remove the script components from your objects and rebuild.

Start Location Isn’t Correct? You likely have a mismatch between the position of your DefaultMeeplePosition object in your Dollhouse vs Realscale prefabs. Teleportation Location Doesn’t Match Your Dollhouse Location? You likely have a mismatch between the position/size/rotation of your Floor object or content in your Dollhouse vs Realscale prefabs. Dollhouse is Tiny? This is likely because you have large scaled GameObject(s) that are disabled in your Dollhouse prefab. Altoura will scale all of the content in your Dollhouse prefab down in order to fit inside the dollhouse ring, including the content that may be disabled when the asset bundle is first unloaded. Still Stuck? Post a question in the Discussions tab and one of our team members will respond ASAP.