Use the ** ARCore Cloud Anchor API**, or the ARCore Cloud Anchor service, to build AR experiences that Android and iOS users can share.
If you are new to working with anchors, see Working with anchors for an introduction.
The following steps assume that you have already installed and configured the ARCore SDK for Unity to target Android.
If not, see the ARCore SDK Quickstart for Android for installation and environment configuration instructions.
Use Cloud Anchors
Set up your development environment for working with Cloud Anchors and try out the sample app.
About Cloud Anchors ID sharing
Apps with Cloud Anchors capabilities need a way to share cloud anchor IDs between devices.
The CloudAnchors sample app uses Unity's Networking feature for sharing Cloud Anchors IDs between devices on the same network. You can use a different solution in your own apps.
Add an API Key
To use the ARCore Cloud Anchor API in your app, you'll need an API Key.
Obtain an API Key. See Setting up API keys in the Google Cloud Platform Console Help Center if you are new to working with API keys.
Enable the ARCore Cloud Anchor API for your Google Cloud Platform project.
Add your API key to your project:
- In Unity, go to Edit > Project Settings > Google ARCore.
- Add your API key to the Cloud Anchor API Keys field.
Open the sample
The CloudAnchors sample is included with the ARCore SDK for Unity.
- In the Unity Project window, you can find the CloudAnchor scene
Try out the sample
Build and run the CloudAnchors sample app to try out hosting and resolving Cloud Anchors.
Make sure that developer options and debugging are enabled on your phone.
Connect your phone to your development machine via USB.
Click Play in Unity.
The sample app launches on your phone using Instant Preview.
Create a room with the host device. The app will display a room code which can be used to join this room from another device.
Move your phone around until ARCore starts detecting and visualizing planes.
Tap a plane to create an anchor object on it. A host request is sent to the ARCore Cloud Anchor API. The host request includes data representing the anchor's position relative to the visual features near it.
After the Cloud Anchor is successfully hosted, subsequent taps will create Star objects, which will be synchronized across devices using Unity Multiplayer Services.
Launch the example from a new device, and join the room you created previously. A request is sent to the ARCore Cloud Anchor API to resolve the pose of the cloud anchor. When this request returns successfully, the sample app renders the anchor using the pose.
Both devices will now be able to tap the screen to place Stars.