Unity - Arkio

Importing models from and to Unity requires a Plus, Pro or Enterprise license. You can learn more about our paid licenses on our website and can start a free trial from Arkio to try this feature.

To install the latest Arkio plugin for Unity download and install it from the Unity Asset Store. Once installed a Tools/Arkio menu will appear on the top Unity toolbar.

Using our Unity plugin you can import your Unity scene with all the visible GameObjects and Prefabs. You can edit, move or add new geometry on this scene from Arkio and invite others to join you to collaborate on this scene from any device. Once you are done with your changes the scene can be exported back to Unity to update the original GameObjects and Prefabs to their new location/size and import the created or loaded geometry from Arkio.

Unity to Arkio on PC

Exports from Unity can be done to Arkio locally on your PC or to the cloud for easier uploads to mobile devices like the Quest or your phone. Once your Unity scenes are loaded in Arkio you can plan a meeting by inviting others and exploring designs with your team. You can export your current Unity scene with all its visible GameObjects/Prefabs by selecting Arkio>Export to Arkio PC. This will show a dialog that will ask you to save the scene (needed to store the element ID’s for round trips) 

Once the scene has been exported you can import the scene to Arkio using the Arkio PC client from the import panel tab in the Create tool. Place the Unity scene in Arkio by selecting “Locked at origin”.

This will place each GameObject and Prefab in the scene as an Arkio object so you can move these around. You can share this scene with other users and devices by starting a meeting inside Arkio.

Arkio to Unity on PC

You can export your Arkio scene back to unity using the export button found under your scenes tab.

In Unity, you can select "Import from Arkio PC" to browse to the desired exported file in the Documents\Arkio\Export\Unity directory. See the workflow chapter for more details on the update procedure.

Unity to Arkio via cloud

Cloud exports allow access to your files directly from Arkio on mobile devices.
You can link the Arkio plugin using a 6 digit keycode from “Tools > Arkio > Link plugin to Arkio cloud”

After this, you can export your current Unity scene using "Tools > Arkio > Sync to Arkio cloud"

You can fill the keycode in Arkio on the create tool drawer Cloud>Unity import tab. Your unique keycode can be copied/pasted from the Unity console and saved somewhere for future reference.

The available downloads for your keycode will show when correctly linked. Clicking “get” will download the file to your device and process it as a normal Arkio resource. Once processed you can find the new file under your "Create > Import" tab. (depending on the size of your file it might take a while for the file to download and process)

Arkio to Unity via cloud

You can export the Arkio scene to Unity from non-PC devices by selecting the export "Unity via Cloud" button found in the scene overview.

To import this file to Unity and update your existing scene, select Arkio > Update from Arkio cloud. This will show a new menu where you can select the file to download and update in the scene. See the workflow chapter for more details on the update procedure.

Workflow and best practices

Using our plugin all elements visible in your Unity scene will be exported to a GLB file that will be used as the intermediate exchange file between Arkio and Unity.

• For optimal performance make sure the scene isn’t larger than 1000 GameObjects, 500K triangles, or has more than 50 textures
• GameObjects will be imported as individual Arkio objects
• Geometry inside Prefabs will be combined into a single Arkio object
• If you have scenes with lots of segmented meshes it's best to combine the parts that belong together and you want to move in Arkio into one parent prefab

When exporting Arkio models to Unity we pack all the geometry and imported meshes and textures into a GLB file that can be loaded back to Unity.

• Newly added Arkio geometry will get the name (Arkio_...) and existing Unity GameObjects/Prefabs that made a round trip from Unity>Arkio>Unity will be named (Unity_…)
• All the geometry from Arkio will be converted to meshes with the materials and textures embedded
• The existing Unity geometry in the scene will be compared and updated by transform, rotation and scale to the re-imported Unity (ghost) objects. After this update, the duplicated ghost objects will be hidden inside the GLB prefab to avoid duplicates.
• Arkio primitive shapes painted with the Unity collider and trigger materials will have a script attached that hides the shape on runtime and can be extended with your own custom behavior

Special Arkio Unity materials

Inside Arkio you can create special geometry that will create collider and trigger areas when imported back into Unity. You can find these in the “Special” tab in the materials drawer. The Unity collider material will convert the Arkio geometry to Unity colliders that could be used for various bounding volumes and the Unity trigger material could be used to draw trigger zones and shapes for Unity. The Unity materials can be applied to all arkio base geometry in the scene. You can also select this material then create new geometry using Arkio primitives.

Any geometry tagged with this special material will be visible in the Unity editor but become invisible at runtime through the use of a script attached to the game object. You can customize the behavior of this material by editing this script for your own usage.

Troubleshooting file issues

If you are experiencing problems with the Unity imports taking too long it's likely caused by the size of your export for your device. The files need to be manually removed from the Import folder and resources for Arkio's resource system to operate as expected again.

Known issues

• Export supports a maximum of 2000 GameObjects. Avoid exporting scenes larger than 1000 GameObjects as it could lead to performance issues in Arkio on mobile devices.
• Custom shaders may not translate correctly to Arkio, use standard Unity materials if your textures fail to import
• Unity terrain is not exported to Arkio (Warning is shown when exporting terrain)
• Unity>Arkio currently only supports exporting of uniform scaled game objects
• Round trips from Arkio>Unity>Arkio skip importing/updating Arkio originated solid geometry to prevent duplicates