Documentation

Publishing & sharing

When your project is ready, publish it to get a public link and QR code that open your experience in AR on any phone. On Android it can also play in our AREngine app.

Publishing

  1. Click Share in the top bar.
  2. Click Publish & create link. Your link and QR code appear right away. AR Works then prepares each scene's target image on the server in the background so it recognises fast on phones - you can close the dialog or keep editing while it finishes, and the dialog shows a green “AR target ready” note when it's done.
  3. You get a link (ar.works/view.html?s=…) and a QR code. Copy the link or let people scan the code.
After publishing you get a link and a QR code to share.

Tip

Every time you publish, and periodically as you work, AR Works refreshes the thumbnail on your project's dashboard card from a snapshot of your scene - so your dashboard always shows what each project looks like.

Updating a published project

You can keep editing after publishing - your changes save automatically. If you change a target image, AR Works rebuilds it in the background so the live experience catches up. The share link stays the same, so anything already shared keeps working.

Unpublishing

Open Share and click Unpublish to take the experience offline. The link stops working until you publish again.

Choosing the tracking engine

Once a project is published, the Share dialog has a Tracking engine choice. It decides how the link and QR code below it play your project on a phone.

  • AREngine is our own engine and the default. It adds hand tracking, physics and the surface lock, which tries to keep world scenes pinned in the camera view.
  • Classic engine is the viewer as it was before AREngine: image tracking, and world scenes in immersive AR on Android or in a view that turns with the phone elsewhere. It asks less of a phone, so choose it for older devices.

The choice is part of the link, so both links work at the same time. You can give the classic link to people with older phones and the AREngine link to everyone else. Links you shared before this choice existed use AREngine.

Heads up

Hand interaction and physics need AREngine. With the classic engine, objects set up for them are ordinary objects: they stay where you put them and nobody can pick them up.

Custom loading screen (Pro & Education)

By default the viewer shows AR Works branding while it loads. On the Pro and Education plans (and for school members), the Share dialog has a Loading screen section where you can upload your own image - your logo, say. It is optimised automatically before upload.

Heads up

If the Share dialog reports that the AR target couldn't be built, your image is probably too plain or too large. Choose a more detailed image (see Choosing a target image) and use Try again. Your project stays published and the viewer still opens either way - it just compiles the target on the phone instead.

Export & backup (.works files)

You can download any project as a single .works file - a portable copy of everything in it: scenes, objects, logic, animations, all your imported assets, the prepared AR targets and the project thumbnail. Use it as a backup, keep milestones of your work, or hand a project to someone else. It's also the format AR Works Studio - the offline desktop editor - opens and saves.

  • Export lives in the editor top bar, and as Export .works in a project's Details dialog on the dashboard.
  • To bring a file back, use New project → Import a .works file on the dashboard. Importing always creates a new project (nothing is overwritten), and it counts towards your project and storage limits.

Tip

The prepared AR targets travel inside the file, so an imported copy of a published project is ready to publish straight away - no waiting for its target images to be prepared again.

Play it in the AREngine app (.arengine files)

A .arengine file is the whole project in one file, just like a .works file: scenes, objects, logic, animations, assets and the prepared AR targets. It is made for the AREngine app on Android, which plays the scene natively in the app itself, without a browser. The app opens .works files too.

To make one, open Share and click Download .arengine file. A file needs no link, so the button is there whether or not the project is published, as soon as the project can open on a phone. Your latest changes are saved first, so the file matches what you see.

Note

The AREngine app is new and is still being tested. It is not in an app store yet. Until then, you can download it on an Android phone as an APK from the AREngine page. From version 0.1.2 the app also runs a Fade node, whatever is wired to After animation on Play Animation, and the Opacity slider in the Inspector. If your scene uses them and the app is older, download it again from the AREngine page. From version 0.1.5 the app also hides a model's deleted materials, lets a hand take an animated object and places objects inside other objects correctly. It also uses a world scene's Start spot from 0.1.5, where older versions place the scene on the point that was tapped.

More about the app, and the platforms it is coming to, is on the AREngine page.