Development mode

This page describes how to enable the development mode to simplify usage of spARcl during development.

During development, it may become annoying when relocalisation of the device is needed after every reload of the app. While it is fast over Wifi, it is a repitive step that gets boring quickly. The need to use the tools of the discovery services in use definitely kills the development flow.

The development mode gets rid of both requirements. As there is no localisation done, content is automatically placed around the first pose reported from WebXR.

Follow these steps to setup development mode:

Open Dashboard with a tap at the top right corner of the screen (there will be a more obvious way to do so in the future)

Find setting for ARMode in Application state and select Development

Setup Chrome remote debugging

You can use port forwarding found in the chrome inspect page using localhost URLs over HTTPS. This has the advantages that no certificates are needed, and all features that regularily need secure context can be used without problems.

The fake GeoPose response together with the fake content response that are used in this mode can be found in the source file src/core/locationTools.js. The constant to look for is fakeLocationResult. The format of the content record is defined in the OSCP Spatial Content Discovery repository.

Happy coding :)