1. Create an AR scene #
In the admin area of our Online Editor, open the “AR Scenes” menu.
Click the + in the card header to create a new AR scene.
First, enter a name for the scene.
The Remote ID is assigned automatically. You will need it later.
2. Add AR models #
Expand the AR scene using the cube icon and click + in the “AR Models” section.
The model dialog shows a live preview on the left and the settings form on the right.
First, select the type. This determines which options are available afterward.
2.1 Our AR types #
Type | What players see | Trigger image | Content file |
AR Image | An image appears on the recognized trigger image. | Required | Image (jpg, png, webp) |
AR Video | A video plays on the recognized trigger image. | Required | Video (mp4, webm) |
AR Overlay | A colored overlay appears on the recognized trigger image. | Required | None — you only select the color |
AR Text | 3D text appears in the room or on the trigger image. | Optional | None — you enter the text directly in the dialog |
AR 3D Model | A 3D object appears in the room or on the trigger image. | Optional | 3D file (glb, gltf, usdz) |
Please note:
A scene can contain multiple models, for example a 3D object combined with explanatory text, or several trigger images where players only need to find one of them.
3. Anchoring – with or without a trigger image #
3.1 With a trigger image: content is anchored to the image #
As soon as you set a trigger image, the recognized image becomes the anchor. The content appears directly on it and follows its position, orientation, and size.
For AR image, AR video, and AR overlay, no additional settings are required. Images and videos automatically adapt to the trigger image, while for an overlay you only select the color.
For AR text and AR 3D models with a trigger image, scaling and rotation can still be adjusted. The position fields are hidden because the trigger image determines the position.
What makes a good trigger image?
The camera recognizes images most reliably when they have strong contrast and plenty of distinct visual details.
Photos, illustrations, and posters with many clearly distinguishable features work well. Solid-colored areas, repetitive patterns, very small text, and glossy or reflective surfaces are more difficult to recognize.
If possible, print trigger images on matte material, place them in a well-lit location, and test recognition on site under real lighting conditions.
3.2 Without a trigger image: free placement in the environment #
Without a trigger image, our scavenger hunt app places the content on a surface detected by the camera.
First, choose an orientation:
Horizontal – on a horizontal surface such as a floor or table.
Vertical – on a vertical surface such as a wall.
Floating – freely floating in the room.
The following settings are available only for the 3D types, AR text and AR 3D model, with the exception of the color setting for overlays:
|
Setting |
Applies to |
Meaning |
|
Scale |
Text, 3D Model |
Size factor, default 1. For 3D models, the file contains its original size in meters; use the scale setting to adjust it (0.5 = half the size). |
|
Position (X, Y, Z) |
Text, 3D Model (without trigger) |
Offset in meters from the placement point — only visible for freely placed content. |
|
Rotation (X, Y, Z) |
Text, 3D Model |
Rotation in degrees around the respective axis. |
|
Text, Color, Depth |
Text |
The displayed text and its color; “Depth” controls how three-dimensional the letters appear. |
|
Color |
Overlay |
The color of the area displayed over the trigger image. |
4. 3D models: GLB and the iOS file format USDZ #
Android and iOS use different file formats for 3D objects. Android displays GLB files, while iPhones and iPads require USDZ files.
Our CMS handles most of this automatically.
Simply upload your GLB file as the display file. The Online Editor automatically generates the corresponding USDZ version for iOS directly in the browser.
Wait until the message “Generating USDZ for iOS …” disappears. Saving is disabled while the conversion is running.
You can also upload your own USDZ file in the “USDZ (optional)” field. This replaces the automatically generated version.
Once you have uploaded your own USDZ file, it will remain in place even if you replace the GLB file, until you delete it manually.
Animated Models: Pay Attention to the Warnings
The automatic conversion from GLB to USDZ cannot preserve animations. The dialog will display a warning if an animation is detected.
For animated models, the object will therefore appear static on iOS.
For models with skeletal animations, also known as rigged models, the generated USDZ file may even become completely unusable.
In both cases:
For animated models, we recommend converting the file externally, for example with Apple’s free Reality Converter, and then manually uploading the USDZ file in the “USDZ (optional)” field.
If the automatic conversion fails completely, the model will not be displayed on iOS until you provide a USDZ file manually.
5. Additional tips for 3D files #
Use standard exports from common tools such as Blender or models from established 3D libraries.
Files with unusual or non-standard structures may cause problems on some devices.
Keep file sizes small — ideally only a few megabytes. Players may need to download them while using a mobile data connection.
Before your event goes live, test each model at least once on both an Android and an iOS device.