Unity Editor Plugin (Tutorial)

Follow

In this tutorial, you will discover how to edit and publish your 3D experiences from ARGO/unity plug-in to the native mobile app ARGOplay (Bêta)

Requirements

  • Unity Hub
  • Unity Editor. It's located in the Installs tab of Unity Hub. Make sure that you use the latest LTS Unity version, currently it's 2020.3.**. (2020.3.13f1)
  • Make sure that you have build support modules installed:
  1. iOS Build Support
  2. Android Build Support
    * Android SDK & NDK Tools
    * Open JDK

Restrictions

ARGO Services use AssetBundles + Prefabs for UnityScene assets. This means that you, as a content creator, have to rely on Unity AssetBundles Manual during the asset creation process. Please read the guide carefully before you start.

In short there are few things you have to know. An AssetBundle is an archive file that contains platform-specific non-code Assets, such as:

  • Models
  • Textures
  • Prefabs
  • Audio clips
  • and even entire Scenes

Useful links

 

NB: if you already installed Unity latest version on your desktop you can directly jump to STEP 2 - ARGO/Unity plug-in.

 

STEP 1 - Unity installation

 

  1. Download Unity software on your desktop: to do so, you’ll have to download Unity Hub* (click on link)

    *The Unity Hub is a standalone application that streamlines the way you find, download, and manage your Unity Projects and installations. In addition, you can manually add versions of the Editor that you have already installed on your machine to your Hub.
  2. Double click on UnityHubSetup.dmg file to start installing

    Capture_d_e_cran_2021-07-07_a__16.39.13.png

  3. Follow installation instructions: you know have Unity Hub installed on your desktop

    Capture_d_e_cran_2021-07-07_a__16.40.52.png

  4. Open unity Hub and login with your credentials if you already have ones or sign in and create new ones if you don’t.

    Capture_d_e_cran_2021-07-07_a__16.42.53.png

  5. Create Unity ID, validate your email address and log in.
    Select the kind of licence you want and activate it.

    Capture_d_e_cran_2021-07-07_a__16.44.24.png

  6. Install recommended Unity version.
    Install tabs > ADD

    Capture_d_e_cran_2021-07-07_a__16.46.13.png

    Capture_d_e_cran_2021-07-07_a__16.48.26.png

  7. Make sure to add modules Android Build Support (Android SDK & NDK tools, Open JDK) and IOS Build Support.

    Capture_d_e_cran_2021-07-07_a__16.50.02.png

  8. Wait until complete download

    Capture_d_e_cran_2021-07-07_a__16.51.19.png

  9. Congratulations! You successfully downloaded Unity editor on your desktop

    Capture_d_e_cran_2021-07-07_a__16.52.20.png

 

STEP 2 - ARGO/Unity plug-in

 

  1. Start by downloading the Unity Editor Plugin.
    We'll use it later.
  2. Open Unity hub

    Capture_d_e_cran_2021-07-07_a__16.55.16.png

  3. Create new project (recommended) or open an existing one

    Capture_d_e_cran_2021-07-07_a__16.56.15.png

  4. Click on "Create": Unity editor opens

    Capture_d_e_cran_2021-07-07_a__16.57.55.png

  5. Click Assets > Import Package > Custom Package...

    unnamed.png

  6. And look for the Unity package you previously downloaded (unity_editor_plugin package)
    Click on open

    Capture_d_e_cran_2021-07-06_a__18.16.41.png

  7. Check that all files from the plugin are selected and click on Import.

    Capture_d_e_cran_2021-07-05_a__16.21.28.png

1 - Sign in

  1. In Unity Editor tab bar, click on ARGO/Sign in

    Capture_d_e_cran_2021-07-07_a__17.07.20.png

  2. in Sign In window, fill in your ARGO Web Manager/Editor credentials.

    Capture_d_e_cran_2021-07-09_a__13.54.47.png

  3. Click on Sign in

 

2 - Create and configure a scene

 

  1. Click on ARGO > new scene

    Capture_d_e_cran_2021-07-07_a__17.12.25.png

  2. In Create New Scene window, fill in the numerical marker ID of the marker you want to augment.

    Capture_d_e_cran_2021-07-05_a__16.42.47.png

    P.S: you’ll find this marker ID in ARGO Editor. Open ARGO editor on your targeted campaign. Select the marker you want to augment with unity and retrieve your marker ID (page ID) in the Editor URL.

    Capture_d_e_cran_2021-07-09_a__14.50.12.png

  3. Click on Create. Your marker will be loaded and attached to the scene origin

    argo.jpg

  4. Create or import your 3D object/unity package

    To create your own 3D object from scratch:

    • Click on GameObject/3D Object/Cube or Capsule or whatever. Object will appear on the scene

      Capture_d_e_cran_2021-07-09_a__14.03.18.png

    • Adjust object size and position

      Capture_d_e_cran_2021-07-09_a__14.05.21.png

    • Select Assets folder in projects window.
      Select object in "sample scene" and drag and drop it in project window (in Asset folder). Unity will generate a prefab for you.



    To import a unity package with a prefab:


    • Click on Assets/Import Package/Custom Package... and choose the file on your computer (*.unitypackage). Unity will show you list of the objects to be imported.
    • Click on Import button at the bottom of this window
    • Find in Project window a prefab from this package and drag and drop it on the scene
    • Adjust object size and position
    • In Inspector window, under the Layer and to the right of the Prefab, there is an Overrides button. Click on it and click Apply in the pop-up window. It will apply changes from the scene on the prefab.

 

3 - Build and deploy scene

 

  1. Once prefab is ready, select it and click ARGO/Build and Deploy

    Capture_d_e_cran_2021-07-08_a__10.23.57.png

  2. In Build Scene window you should see your prefab(s) in Selected objects section

    Capture_d_e_cran_2021-07-09_a__14.54.51.png

    Files will be generated at Assets/AssetBundles/*architecture* and pushed to ARGO API.

    P.S: ARGO Manager does not yet allow to display the scenes created within Unity editor. However, when you open your marker in ARGO editor, you will notice that a new “frame”  appears in the Interactions window. This is your Unity prefab.


  3. You can now scan your marker with ARGOplay Bêta app and enjoy your Unity creation ((All your campaigns created with ARGO editor are also compatible with ARGOplay Beta version)

    Download ARGOplay Bêta

    Download IOS version 

    (Download ARGOplay Beta from the Testflight application by clicking on the link above. If you already have the ARGOplay app installed on your mobile, follow the installation process proposed by Testflight. The old version of the app will be overwritten by the new Beta version (No risk). To leave the ARGOplay Beta version, simply reinstall the ARGOplay application from the app store, it will overwrite the Beta version)


    Download Android version
    Register as a beta user on the ARGOPlay application page in Google play store. You will then be able to install the ARGOplay Beta version compatible with Unity.
    To exit the Beta version, simply exit the Beta user mode from the application page and reinstall the previous version of the ARGOPlay application.

    Test ARGOplay Bêta
    Print the attached marker and scan it with the ARGOplay Beta app to test an Augmented Reality scenario for retail designed with the ARGO Unity plug-in.
    ARGOPlay Unity demo marker

Give us your feedback

 

Dear user,

You are experimenting our application in Beta version.
In order to offer this version to as many people as possible, we ask you to provide us with your feedback. The entire ARGO team thanks you warmly for your participation.
Just click on the link below.

>> I GIVE MY FEEDBACK

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.