Configure hunt objects — AR mode
Set an object to AR First mode, prepare the mobile asset formats, and test the participant experience.
In this article, you'll configure a Treasure Hunt Object in AR First mode and prepare the object for real mobile-device testing.
Prerequisites
- The parent Treasure Hunt already exists.
- You have the object's GLB model ready.
- You have a USDZ version ready for iPhone and iPad if you want the best iOS AR experience.
- You can test on the mobile devices your participants are most likely to use.
AR availability depends on the device
When a device or browser does not support the AR handoff, participants can still open the in-page viewer, but they will not see the AR button.
Configure the object
Open the object from Objects to find
Open the parent hunt, then go to Objects to find.
Create a new object or open the object you want to change.
Fill the object basics
Complete the participant-facing information first:
TitleSubtitleDescriptionLocation Hint
If the hunt uses a map, also set the object's map location.
Set Experience Mode to AR First
Choose AR First when the participant should be guided toward the augmented-reality experience first.
This is the right option when the object should feel placed into the real environment instead of only viewed in the page.
Attach the 3D asset
Select the object's asset and make sure the mobile formats are ready:
GLBis required for the AR setupUSDZis strongly recommended for iPhone and iPad
If you are launching on both Android and iOS, prepare both formats before final testing.
Configure the interaction
Choose the participant interaction that follows the AR view:
DirectMulti ChoiceText Answer
The same interaction rules apply here as in 3D-first objects, so validate the question setup before launch.
Test on real devices
Test the object on the actual phones you expect participants to use.
Check:
- whether the AR button appears on supported devices
- whether the object still opens in the viewer on unsupported devices
- whether the interaction works after the AR or viewer step
Participant behavior to expect
| Device state | What participants see |
|---|---|
| AR supported and asset ready | The object opens with the AR-first experience available. |
| AR not supported | The participant can still open the in-page viewer, but the AR button is not shown. |
| Asset incomplete | The object may fail validation or not be ready for launch. |
Common validation issues
| Validation message | What it means | Fix |
|---|---|---|
Treasure hunt object '{{treasure_hunt_object_name}}' in {{visualization_mode}} mode requires an asset | The object has no usable asset attached. | Select the object asset before testing or publishing. |
Asset '{{asset_name}}' for treasure hunt object '{{treasure_hunt_object_name}}' is missing a GLB 3D model file | The AR setup is missing the GLB file. | Upload the GLB version of the object. |
Asset '{{asset_name}}' for treasure hunt object '{{treasure_hunt_object_name}}' is missing a USDZ 3D model file | The asset does not include the iOS-friendly file. | Upload the USDZ version so iPhone and iPad users get the best AR experience. |
Treasure hunt object '{{treasure_hunt_object_name}}' is missing interactivity configuration | The object does not yet know what happens after it opens. | Configure Direct, Multi Choice, or Text Answer. |
Related
Configure hunt objects — 3D mode
Use 3D First when you want the in-page viewer to be the default experience.
Asset management for hunts
Prepare the file set you need before you try to launch on several device types.
Configure interactivity (questions and answers)
Apply the right question rules after the AR view step.
3D/AR rendering issues
Troubleshoot missing AR buttons, asset issues, or device support problems.