Local Spatial Anchors Tutorial

1. Open the Basic Passthrough Tutorial project
2. Open Edit > Project Settings > (in Plugins section) > Meta XR.
3. Enable Anchor Support, Scene Support, and Passthrough Enabled

1. In the ContentBrowser tab, click + Add > Blueprint Class > Actor to create an actor. Name it BP_NewAnchor
2. Double click to edit BP_NewAnchor.
3. Under Components click + Add > Cube
4. Set Transform > Scale to (0.2,0.2,0.2).
5. Save and return to the Level Editor.
6. In the ContentBrowser tab, click + Add > Blueprint Class > Actor to create an actor. Name it BP_OldAnchor
7. Double click to edit BP_OldAnchor.
8. In the new opened editor window, under Components click + Add > Sphere
9. Set Transform > Scale to (0.2,0.2,0.2).
10. Save and return to the Level Editor.

1. Open Edit > Project Settings... > (in Engine section) > Input.
2. Add a new Action Mappings for CreateAnchor mapping to Oculus Touch (R) A Press.
3. Add a new Action Mappings for LoadAnchor mapping to Oculus Touch (R) B Press.
4. Return to the Level Editor.

1. In the ContentBrowser tab, click + Add > Blueprint Class > ALL CLASSES > search > SaveGame. Name it BP_SaveGame.
2. Double click to edit BP_SaveGame.
3. Under My Blueprint > VARIABLES > click + to create a new variable. Name it AnchorIds.
4. On the Details panel:
   • Set AnchorIds’s Variable Type to String.
   • Make it an Array.
   • Tick Instance Editable.
5. Click Save and Compile.
6. Return to the Level Editor.

1. Click Blueprint on the toolbar and click Open Level Blueprint.
2. Under My Blueprint > VARIABLES > click + to create a new variable. Name it tempAnchors.
3. On the Details panel:
   • Set AnchorIds’s Variable Type to OculusXRUUID.
   • Make it an Array.

1. On the Level Blueprint, right-click to create an InputAction CreateAnchor and link it with Spawn Actor from Class to spawn a BP_NewAnchor.
2. Create a Random Point in Bounding Box with Center = (0, 0, 0) and Half Size = (100, 100, 100) to generate random locations for your new Anchor.
3. Create a Make Transform and connect Random Point in Bounding Box > Make Transform > SpawnActor BP New Anchor.
4. Create an OculusXR Async Create Spatial Anchor and connect SpawnActor BP New Anchor, Make Transform for input.
5. Now users can create anchors by Oculus Touch (R) A Press.
6. Your Level Blueprint should look like this:

1. On the Level Blueprint, create an OculusXR Async Save Anchor and Connect to the previous Blueprint flow.
2. After saving the Anchor in Oculus, the next step is to store the Anchor UUID within your game so that you can use it to retrieve the anchor from Oculus when needed.
3. Use Save Game to store the Anchor UUID:

1. On the Level Blueprint, right-click to create an InputAction LoadAnchor and link it with Load Game from Slot.
2. Save Game has all persisted Anchor UUIDs, which can be used to load Anchors, detailed Blueprint setup can be found in the below screenshot.
3. Use OculusXR Async Query Anchors to load anchors by anchor UUIDs.
4. Use the Query result to Spawn BP_OldAnchor. Your Level Blueprint should look like this:

1. Save project.
2. Under platforms click Meta Quest device. Unreal will deploy and run APK on the device.
3. Press your right controller’s A in the game to place anchors into the scene.
4. Stop the Game and restart the Game.
5. Press your right controller’s B in the game to load anchors into the scene.
   

• For a guide to the Spatial Anchors API with C++ examples, see Use Spatial Anchors.
• For the full list of Blueprint nodes, see Spatial Anchors Blueprint Reference.
• For a complete working implementation, see the Unreal-SpatialAnchorsSample⁠ on GitHub.