01Spatial Documentation

Machine-readable: manifest · index · English Markdown

Launch AR on iOS

01Spatial uses an App Clip on iPhone. Scanning the QR code launches a lightweight ARKit client without requiring the full app, and loads the current map's web Content.

Requirements

  • An ARKit-capable iPhone, preferably running iOS 16.4 or later.
  • Camera permission and a stable network connection.
  • A Ready map with saved Content.

Launch

  1. Select Launch in the Space Studio top bar.
  2. Select iOS. The tab is hidden if iOS launch is not enabled in the current deployment.
  3. Scan the QR code with the iPhone system Camera.
  4. Select the App Clip card shown by iOS, then open the experience.
  5. Grant camera access, face a detailed mapped area, and move slowly while the map aligns.

Android and iOS may share the same AR URL. iOS recognizes the associated domain and invokes the App Clip. Do not treat this QR code as an App Store download code, and do not scan it with a third-party app before copying the URL into Safari; that can bypass the system App Clip flow.

Acceptance and troubleshooting

  • The App Clip card does not appear: use the system Camera, verify network access, and confirm that the link belongs to the current deployment.
  • Content is unstable: wait for ARKit tracking to stabilize, then face fixed visual detail and localize again.
  • Alignment has a constant offset: verify the map Origin and Content coordinates in Space Studio. Do not move the AR camera to compensate.

The QR code contains map access credentials and should be shared only with authorized viewers.