📲Deploy Experience

Learn how to use our system with Google Scene Viewer.

Google Scene Viewer enables you to view your 3D models on any surface in your environment through a web browser or app.

Before using Google Scene Viewer make sure that your iOS device is compatible with ARKit or that your Android device has ARCore or Google Play Services for AR installed.

Adding 3D Content

Add a model asset or image asset through the console. You can choose any type of target. Here's how:

Add Content

Launching the Scene Viewer App

Option 1: Scan a QR code

Once the 3D asset is set you can view it instantly with Scene Viewer.

Click on the icon to generate and show the QR codes.

Make sure the tab or tab is selected and shows a QR code that can be detected by the camera.

Scan the QR code with your phone's camera app or with a QR reader app.

Latest iOS and Android phones are able to read QR code with their default camera apps.

Click the pop-up message to get redirected to our website.

Option 2: Go directly to website

Instead of scanning the QR code, you can click the icon to automatically copy a short link to the model into your clipboard.

You can browse directly to the short link:

https://go.echo3D.co/<CODE>

Alternately, you can also browse directly to:

https://api.echo3D.com/webar?key=<YOUR_API_KEY>&entry=<ENTRY_ID>

Seeing 3D Content in AR

Click the button.

Move the phone around until it detects the surface around you. The 3D model should appear on top of the detected surface. You might need to scale the model to make it fit the screen view.

Switching between 3D Content

You can instantly view all 3D assets in a particular project through Scene Viewer.

Viewing multiple assets is only available on the Pro and Custom plans.

Go directly to:

https://api.echo3D.com/webar?key=<YOUR_API_KEY>

If your project includes more than one 3D asset, a carousel of 3D assets will appear at the bottom of the screen. Set up a configurator by uploading similar models with different theming and configurations.

Switch between the assets by clicking their thumbnail in the asset carousel.

The carousel of 3D assets can also appear in the AR view but only on Android devices.

Changing the Default AR Mode or Placement

Different AR modes allow for different features (such as occlusion, UI, wall placement, etc.) to take effect in the web AR viewer

If you'd like to change the default AR mode or placement used to view the 3D content, go back to the console and add metadata to change the default mode or placement. After adding metadata, relaunch the experience.

The following metadata keys are words the system uses as pre-defined metadata keys to set the default AR mode or placement:

Keyword	Type	Options	Effect
arMode	String	Either 'webxr' of 'scene-viewer'. Default value is 'webxr'.	Sets the AR mode to the provided mode.
arPlacement	String	Either 'floor' or 'wall'. Default value is 'floor'.	Sets the AR placement of the surface type on which the 3D model is projected.
arScale	String	Either 'auto' or 'fixed'. Default value is 'auto'.	Set the AR scale mode which allows you to scale the model by pinching the screen (auto) or disables scaling (fixed).
shadowIntensity	String	A number between '0' to '1'. Default value is '1' for models with 'arPlacement' set as 'floor' and '0' for 'wall'.	Set the intensity of the shadow around the 3D model that appears.
shadowSoftness	String	A number between '0' to '1'. Default value is '1'.	Set the softness of the shadow around the 3D model that appears.
exposure	String	A number between '0' to '1'. Default value is '1'.	Set the intensity of the light emitted of the 3D model that appears.
environmentImage	String	'neutral', 'legacy'. Default value is 'neutral'.	Set one of two baked-in lighting environments: (1) neutral lighting environment that is evenly lit on all sides (roughly calibrated to render colors at their baseColorMap RGB values), or (2) legacy lighting primarily for frontward viewing.
minPitch	Float	A number between '0' and '180'.	Set the minimum camera pitch in the 3D preview webpage.
maxPitch	Float	A number between '0' and '180'.	Set the maximum camera pitch in the 3D preview webpage.
minYaw	Float	A number between '-180' and '180'.	Set the minimum camera yaw in the 3D preview webpage.
maxYaw	Float	A number between '-180' and '180'.	Set the maximum camera yaw in the 3D preview webpage.
minFOV	Float	A number between '0' and '180'	Set the minimum field of view of the camera in the 3D preview webpage, corresponding to maximum zoom-in
maxFOV	Float	A number between '0' and '180'	Set the maximum field of view of the camera in the 3D preview webpage, corresponding to maximum zoom-out

Remember to relaunch the experience after adding metadata with Scene Viewer experiences for the change to take effect.

Getting 3D Content based on Location

You can choose to retrieve only 3D assets that include a geolocation target set to a specific location around a specific radius.

Viewing assets around a location is available in the Pro and Custom plans.

Go directly to:

https://api.echo3D.com/webar?key=<YOUR_API_KEY>&location=<LAT>,<LONG>&radius=<RADIUS>

Where the query parameters are:

Keyword	Description	Examples
location	A pair of GPS coordinates in the form of LAT,LONG or a location name that will be converted to GPS coordinates.	40.713054, -74.007228 New York
radius	The acceptable distance in miles between the location and the the entry's location. If radius isn't specified, a default 1 mile radius is used.	0.01

Password-Protecting Content

You can password-protect WebAR experiences so that users that access the experience will be prompted to enter a password.

If you'd like to password-protect the 3D content, go back to the console and add metadata to set a password. After adding metadata, relaunch the experience.

The following key is a word the system uses as pre-defined metadata keys to password-protect content:

Keyword	Type	Example
passwd	String	1a2B3c4D5e6