Unity-ARFoundation-echo3D-demo-Pin-Location

Map pin location demo with Unity, ARFoundation, and echo3D.

Register

If you don't have an echo3D API key yet, make sure to register for FREE at echo3D.

Setup

Basics

• Clone Unity-ARFoundation-echo3D-example repo and follow the instructions on documentation page to get your project up and running.

PinLocation Package

• Clone this repo
• In your existing project of Unity-ARFoundation-echo3D, from the toolbar on top select Assets > Import Package > Custom Package...
• Select echo3D-PinLocation.unitypackage located in this repo and click Open
• Click All and then Import
• From the Project tab in Unity, go to Assets > AR Foundation > Scenes > PinLocation
• Open the scene PinLocationAR
• Edit ShareButtonHandler.cs file in the same directory
• Find the ShareLocation() function and place your API key and optional configurations
• From the project tab, go to Assets > AR Foundation > Scripts
• Overwrite PlaceOnPlane.cs with the corresponding file in this repo

echo3D Console

• In the Content page under Manage, select the option to upload new files
• Upload both files in the directory MapPinConsoleObject located in this repo

Note

• This project utilizes Native Share for Android & iOS from the Unity Asset Store
• In your Unity project, go to Asset Store and download the asset above in its entirety

Run

• Save, build and run the project just as you would for Unity-ARFoundation-echo3D

Note: These instructions assume that you are familiar with building and running the project for your desired platform (iOS, Android...) Please consult external resources if you are having difficulties in this process.

• In Build Settings, after selecting iOS, ensure that you have selected the correct scene that is AR Foundation/Scenes/PinLocation/PinLocationAR. If this option is not available, click Add Open Scenes and try again by looking at the end of the list.

Usage

When share button at the bottom-center of the screen is touched, user location is determined with LocationService in Unity. The location is sent within an HTTP POST request to echo3D’s API.

• In the echo3D console, go to Data tab under Manage
• The location should be seen in the Global database table on this page

Screenshots

Pin

Share

Attributions

• "Map Pin" (https://skfb.ly/6SVFx) by Ilyas.King is licensed under Creative Commons Attribution (http://creativecommons.org/licenses/by/4.0/).

Support

Feel free to reach out at support@echo3D.co or join our support channel on Slack