Setup Guide

Setting Up the Unity Development Environment
Installing MAXST AR SDK for Unity
Running the Sample App (Unity Editor)
Building a Sample App (Android)
Building a Sample App (iOS)

Setting Up the Unity Development Environment

Requirements

  • We recommend Unity 2017 or later for the MAXST AR SDK for Unity.

  • To use MAXST AR SDK for Unity, you need basic knowledge of Unity development tools and Unity development.

  • For more information on Unity development tools, visit Unity Website.

Installing MAXST AR SDK for Unity

  1. Download MAXST AR SDK for Unity.

  2. Open the Unity project or create a new one.

※ If you want to run Unity in Windows, you must give the -force-opengl option.

  1. Right-click Unity icon and Select Attribute.

setUpOpenGL

  1. Add -force-opengl to the executable path in the Properties window.

setUpOpenGLPref

  1. The graphics library used when running Unity can be found at the top of the editor.

setUpEditorApi

  1. Import MAXST AR SDK for Unity by double-clicking the downloaded MAXST AR SDK Package or by selecting 'Assets / Import Package / Custom Package' from the Unity Editor menu and selecting the downloaded Package.

Running the Sample App (Unity Editor)

To run the MAXST AR SDK sample app for Unity, follow these steps.

  1. Install MAXST AR SDK for Unity.

  2. In Unity Editor, select 'File > Build Settings'

  3. In the Project View, add scenes from the 'Assets > MaxsARSamples > Scenes' folder to 'Build Settings > Scenes In Build'

    setUpAddScene

  4. In Project View, double-click the Home scene in the Assets > MaxsARSamples > Scenes folder.

  5. Press the Play button on the Toolbar.

    setUpToolBar

※ Moving from the Target scene to the Home scene is possible with the esc key.

Building a Sample App (Android)

To build the MAXST AR SDK sample app for Unity, follow these steps.

  1. Install MAXST AR SDK for Unity.

  2. In Unity Editor, select 'File > Build Settings'.

  3. In the Project View, add scenes from the 'Assets > MaxsARSamples > Scenes' folder.

    setUpAddScene

  4. Place Home Scene at the top.

    setUpHomeScene

  5. In the Platform window, select Android and click the Switch Platform button.

    setUpSwitchPlatform

  6. In the Platform window, click the Player Settings button.

    setUpPlayerSet

  7. Uncheck the Auto Graphics API in the Inspector window, then move OpenGLES2 to the top.

    setUpGraphicAPI

  8. In the Inspector window, enter Package Name.

    setUpOtherSet

  9. Enter the license key.

  10. After connecting the device, select 'File > Build&Run'

    ※ If the Android SDK is not properly configured, the file selection window of the message(Select Android SDK root folder) may appear. You can do this by choosing Edit> Preferences from the Unity Editor menu bar.

    setUpPref

Building a Sample App (iOS)

To build the MAXST AR SDK sample app for Unity, follow these steps.

  1. Install MAXST AR SDK for Unity.

  2. In Unity Editor, select 'File > Build Settings'.

  3. In the Project View, add scenes from the 'Assets > MaxsARSamples > Scenes' folder.

    setUpAddSceneiOS

  4. Place Home Scene at the top.

    setUpHomeSceneiOS

  5. In the Platform window, select Android and click the Switch Platform button.

    setUpSwitchPlatformiOS

  6. In the Platform window, click the Player Settings button.

    setUpPlayerSetiOS

  7. Uncheck the Auto Graphics API in the Inspector window, then move OpenGLES2 to the top.

    setUpGraphicAPIiOS

  8. In the Inspector window, enter ‘8.0' in Target minimum iOS Version and ‘description' in Camera Usage Description .

    setUpiOS

  9. In the Inspector window, enter Bundle Identifier.

    setUpOtherSetiOS

  10. Enter the license key.

  11. Select 'File > Build'

  12. Run the generated xcode project file.

    setUpiOSBuild

  13. Connect a test phone / configure the Signing and build.

    setUpiOSSign