Build a Basic Surface Tracking Experience

Construction of an AR experience using SLAM

Introduction

This guide walks you through the construction of a basic scene built using A-Frame and the WebAR SDK. The output will be a 3D Astronaut model fixed to the identified surface ()

To simply display 3D models no knowledge of A-Frame beyond what's outlined below is necessary. However if you want to make more advanced experiences, familiarity with A-Frame will be very helpful. You can find out more about A-Frame in their

Process

Complete the below mentioned steps to create and launch an AR experience using Blippar WebAR SDK and A-frame integration

Step:1 Create an HTML File & Include the WebAR SDK

Create a HTML document in your favourite editor.
Include AFrame Script before WebAR SDK.
To include the WebAR SDK in this, we drop in a <script> tag under the <head> tag pointing to the WebAR SDK.
The exact form of the below will look different depending on how you installed the WebAR SDK. The example which follows assumes you downloaded the WebAR SDK and extracted it so that the script file - webar-sdk-v1.5.3.min.js and libs folder is in the same location as your HTML file. Follow the instructions in theto find the right tag for your setup.
Also a models folder containing a test GLB model file is assumed to be in the same location as your HTML file. To begin with this example, use this GLB model in for testing.
The final folder structure should look like this:

<html>
  <head>
    <title>WebAR SDK Basic Scene</title>
    <script src="https://aframe.io/releases/1.3.0/aframe.min.js"></script>
    <script src="./webar-sdk-v1.5.3.min.js"></script>
  </head>

  <body>
  </body>
</html>

From Webar SDK v1.1.0-beta and above, A-frame script has to be included separately
Supports A-frame version 1.3.0

Step 2: Create a WebAR Scene

To turn a normal scene entity into a WebAR Scene we add an A-Frame <a-scene> and add a few specific components.
The other components will just make sure everything is setup correctly.

Remember to change the key value or you will receive an "invalid key" error when you deploy.

...

<body>

  <a-scene
    webar-scene="key: xxxxxxxx-1111-2222-3333-yyyyyyyyyyyy"
    vr-mode-ui="enabled: false"
    device-orientation-permission-ui="enabled: false"
    loading-screen="enabled: false">
  </a-scene>
</body>

Step 3: Add a WebAR Camera

Within the <a-scene> entity add an A-Frame <a-camera> entity and give it a webar-camera component.

<body>
  ...

    <a-camera webar-camera></a-camera>

  </a-scene>
</body>

Step 4: Load your 3D Assets

Add an <a-assets> entity and load any model files to be used as <a-asset-item> entities. Included with the downloaded WebAR SDK is a model of an astronaut to use as an example.

<a-scene 
    ... 
    ...>

    <a-assets>    
      <a-asset-item
        id="astronaut"
        src="models/astronaut.glb">
      </a-asset-item>
    </a-assets>

  </a-scene>

Step 5: Add a WebAR Stage

Next we add a webar-stage entity, this will be the parent to all the 3D models and represents the tracked surface. Any models placed onto the webar-stage will be displayed on the tracked surface. This is where all the action happens.
Within the <a-scene> entity add an A-Frame <a-entity> entity and give it a webar-stage component:
A 3D model placed under a webAR stage will be displayed on a detected surface.

<body>
   
   ...

    <a-entity webar-stage>
       <!-- Read the next step to place 3D AR models here -->
    </a-entity>

  </a-scene>
</body>

Step 6: Add a 3D Model

To the webar-stage we add our preloaded model.
Add the 3d model asset <a-entity gltf-model=”#astronaut”> under the parent <a-entity webar-stage> element.
Also add the webar-loadmonitor attribute to the entities to display the loading progress screen before starting the surface tracking. See the webar-loadmonitor properties table for more details.

<body>

  ...

    <a-assets>
      <a-asset-item
        id="astronaut"
        src="models/astronaut.glb">
      </a-asset-item>
    </a-assets>

    <a-entity webar-stage>
        <!-- Place 3D AR models here -->
        <a-entity gltf-model="#astronaut" id="astronaut_1" 
                  rotation="0 0 0" position="0 0 0" scale="0.25 0.25 0.25"
                  webar-loadmonitor="elType: glb"></a-entity>
    </a-entity>

  </a-scene>
</body>

Full Source Code

In case we lost you along the way, here is the whole thing:

<!DOCTYPE html>
<html>
<head>
  <title>Blippar Web Surface Tracking</title>
  <script src="https://aframe.io/releases/1.3.0/aframe.min.js"></script>
  <script src="./webar-sdk-v1.5.3.min.js"></script>
</head>

  <body>
   <a-scene
      webar-scene="key: xxxxxxxx-1111-2222-3333-yyyyyyyyyyyy"
      vr-mode-ui="enabled: false"
      device-orientation-permission-ui="enabled: false"
      loading-screen="enabled: false">

      <a-camera webar-camera></a-camera>

      <a-assets>
        <a-asset-item
          id="astronaut"
          src="models/astronaut.glb">
        </a-asset-item>
      </a-assets>

      <a-entity webar-stage>
        <!-- Place 3D AR models here -->
        <a-entity gltf-model="#astronaut" id="astronaut_1" 
                  rotation="0 0 0" position="0 0 0" scale="0.25 0.25 0.25"
                  webar-loadmonitor="elType: glb"></a-entity>
      </a-entity>
    </a-scene>
  </body>
</html>

Deployment

Your website must have https enabled, this is to enable the browser to access your camera.

Launching the Experience

Resulting Surface Tracking Experience

PreviousA-frame Integration NextBuild a Marker Tracking Experience

Last updated 1 year ago

Introduction

This guide walks you through the construction of a basic scene built using A-Frame and the WebAR SDK. The output will be a 3D Astronaut model fixed to the identified surface ()

To simply display 3D models no knowledge of A-Frame beyond what's outlined below is necessary. However if you want to make more advanced experiences, familiarity with A-Frame will be very helpful. You can find out more about A-Frame in their

Process

Complete the below mentioned steps to create and launch an AR experience using Blippar WebAR SDK and A-frame integration

Step:1 Create an HTML File & Include the WebAR SDK

Create a HTML document in your favourite editor.
Include AFrame Script before WebAR SDK.
To include the WebAR SDK in this, we drop in a <script> tag under the <head> tag pointing to the WebAR SDK.
The exact form of the below will look different depending on how you installed the WebAR SDK. The example which follows assumes you downloaded the WebAR SDK and extracted it so that the script file - webar-sdk-v1.5.3.min.js and libs folder is in the same location as your HTML file. Follow the instructions in theto find the right tag for your setup.
Also a models folder containing a test GLB model file is assumed to be in the same location as your HTML file. To begin with this example, use this GLB model in for testing.
The final folder structure should look like this:

<html>
  <head>
    <title>WebAR SDK Basic Scene</title>
    <script src="https://aframe.io/releases/1.3.0/aframe.min.js"></script>
    <script src="./webar-sdk-v1.5.3.min.js"></script>
  </head>

  <body>
  </body>
</html>

From Webar SDK v1.1.0-beta and above, A-frame script has to be included separately
Supports A-frame version 1.3.0

Step 2: Create a WebAR Scene

The webar-scene is the WebAR version of A-Frame's entity, and functions in much the same way.
To turn a normal scene entity into a WebAR Scene we add an A-Frame <a-scene> and add a few specific components.
Most importantly we add the webar-scene component and set the key: property to the license key you got when you created the project (seefor instructions)
The other components will just make sure everything is setup correctly.

Remember to change the key value or you will receive an "invalid key" error when you deploy.

...

<body>

  <a-scene
    webar-scene="key: xxxxxxxx-1111-2222-3333-yyyyyyyyyyyy"
    vr-mode-ui="enabled: false"
    device-orientation-permission-ui="enabled: false"
    loading-screen="enabled: false">
  </a-scene>
</body>

Step 3: Add a WebAR Camera

The webar-camera is, like the webar-scene, the WebAR version of A-Frame's entity
Within the <a-scene> entity add an A-Frame <a-camera> entity and give it a webar-camera component.

<body>
  ...

    <a-camera webar-camera></a-camera>

  </a-scene>
</body>

Step 4: Load your 3D Assets

To ensure the models are fully loaded before the experience starts so we provide the best user experience, we use A-Frame's
Add an <a-assets> entity and load any model files to be used as <a-asset-item> entities. Included with the downloaded WebAR SDK is a model of an astronaut to use as an example.

<a-scene 
    ... 
    ...>

    <a-assets>    
      <a-asset-item
        id="astronaut"
        src="models/astronaut.glb">
      </a-asset-item>
    </a-assets>

  </a-scene>

Step 5: Add a WebAR Stage

Next we add a webar-stage entity, this will be the parent to all the 3D models and represents the tracked surface. Any models placed onto the webar-stage will be displayed on the tracked surface. This is where all the action happens.
Within the <a-scene> entity add an A-Frame <a-entity> entity and give it a webar-stage component:
A 3D model placed under a webAR stage will be displayed on a detected surface.

<body>
   
   ...

    <a-entity webar-stage>
       <!-- Read the next step to place 3D AR models here -->
    </a-entity>

  </a-scene>
</body>

Step 6: Add a 3D Model

To the webar-stage we add our preloaded model.
Specify the glb model files to be loaded in A-Frame’s <a-assets><a-asset-item> tag. For more details, please refer to A-FRame’s document.
Add the 3d model asset <a-entity gltf-model=”#astronaut”> under the parent <a-entity webar-stage> element.
Also add the webar-loadmonitor attribute to the entities to display the loading progress screen before starting the surface tracking. See the webar-loadmonitor properties table for more details.

<body>

  ...

    <a-assets>
      <a-asset-item
        id="astronaut"
        src="models/astronaut.glb">
      </a-asset-item>
    </a-assets>

    <a-entity webar-stage>
        <!-- Place 3D AR models here -->
        <a-entity gltf-model="#astronaut" id="astronaut_1" 
                  rotation="0 0 0" position="0 0 0" scale="0.25 0.25 0.25"
                  webar-loadmonitor="elType: glb"></a-entity>
    </a-entity>

  </a-scene>
</body>

Full Source Code

In case we lost you along the way, here is the whole thing:

<!DOCTYPE html>
<html>
<head>
  <title>Blippar Web Surface Tracking</title>
  <script src="https://aframe.io/releases/1.3.0/aframe.min.js"></script>
  <script src="./webar-sdk-v1.5.3.min.js"></script>
</head>

  <body>
   <a-scene
      webar-scene="key: xxxxxxxx-1111-2222-3333-yyyyyyyyyyyy"
      vr-mode-ui="enabled: false"
      device-orientation-permission-ui="enabled: false"
      loading-screen="enabled: false">

      <a-camera webar-camera></a-camera>

      <a-assets>
        <a-asset-item
          id="astronaut"
          src="models/astronaut.glb">
        </a-asset-item>
      </a-assets>

      <a-entity webar-stage>
        <!-- Place 3D AR models here -->
        <a-entity gltf-model="#astronaut" id="astronaut_1" 
                  rotation="0 0 0" position="0 0 0" scale="0.25 0.25 0.25"
                  webar-loadmonitor="elType: glb"></a-entity>
      </a-entity>
    </a-scene>
  </body>
</html>

Deployment

Deploy your files (the HTML file and if you downloaded the SDK the blippar folder) to your web server, (note you can also develop and host locally in Dev Mode, see more info here )

Your website must have https enabled, this is to enable the browser to access your camera.

Launching the Experience

Navigate to your page, the WebAR SDK should work with any modern browser but is extensively tested with Safari (iOS) and Chrome (android). If all has gone well you will see the below. Information about launching the AR experience is available

Resulting Surface Tracking Experience

The webar-scene is the WebAR version of A-Frame's entity, and functions in much the same way.

Most importantly we add the webar-scene component and set the key: property to the license key you got when you created the project (seefor instructions)

The webar-camera is, like the webar-scene, the WebAR version of A-Frame's entity

To ensure the models are fully loaded before the experience starts so we provide the best user experience, we use A-Frame's

Specify the glb model files to be loaded in A-Frame’s <a-assets><a-asset-item> tag. For more details, please refer to A-FRame’s document.

Deploy your files (the HTML file and if you downloaded the SDK the blippar folder) to your web server, (note you can also develop and host locally in Dev Mode, see more info here )

Navigate to your page, the WebAR SDK should work with any modern browser but is extensively tested with Safari (iOS) and Chrome (android). If all has gone well you will see the below. Information about launching the AR experience is available

scene

here

camera

Asset Management System

Develop Locally.

here.

excellent documentation.

Install section

this link

see here

Blippar Documentation Centre