Here's an easy demo that lets you share a certain location AR using with Unity, ARFoundation, and echoAR.. The full demo can also be found on echoAR's GitHub.
Register
If you don't have an echoAR API key yet, make sure to register for FREE at echoAR.
Setup
Basics
- Clone Unity-ARFoundation-echoAR-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-echoAR
, from the toolbar on top selectAssets > Import Package > Custom Package...
- Select
echoAR-PinLocation.unitypackage
located in this repo and clickOpen
- Click
All
and thenImport
- From the
Project
tab in Unity, go toAssets > 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
echoAR 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-echoAR
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, clickAdd 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 echoAR’s API.
- In the echoAR console, go to
Data
tab under Manage - The
location
should be seen in theGlobal database
table on this page
Attributions
“Map Pin” (skfb.ly/6SVFx) by Ilyas.King is licensed under Creative Commons Attribution (creativecommons.org/licenses/by/4.0).
Support
Feel free to reach out at support@echoAR.xyz or join our support channel on Slack.
echoAR (echoAR.xyz; Techstars ’19) is a cloud platform for augmented reality (AR) and virtual reality (VR) that provides tools and server-side infrastructure to help developers & companies quickly build and deploy AR/VR apps and experiences.