physar v0.2.0

After installing import Physar to your code:

import Physar from 'physar'

Add Spark's Scene module reference to add your objects from Spark.

const Scene = require('Scene');

Initialize the physics world:

const gravity = {
    x: 0,
    y: -9.82,
    z: 0
};
const physar = new Physar(gravity);

-9.82 m/s2 is the average measure of the strength of Earth's gravitational field. You can set a higher negative or positive value on any axis to enhance the strength and direction of the physics in your scene.

Import your spark object reference. In this case, a sphere that was imported from the AR Library:

const sphere = Scene.root.find('SphereObject')

Where SphereObject is the name of the object in your scene.

Add a plane to your Spark AR scene to create a ground. In this example the plane is called plane01. Reference it in your code:

const groundPlane = Scene.root.find('plane01');

Next, setup object properties for each of the spark objects you want to enable physics for:

const sphereProps = {
  body: {
    mass: 1,
    radius: .01,
    transform: {
      position: {
        x: 0,
        y: 2, 
        z: 0
      }
    }
  }
}

You could add no props, but by setting it like above you can create an initial position and rotation for your objects, as well as mass or radius properties (more about it soon). By default all axis of position and rotation are synchronized between Spark and Physar.

You can also add synchronization settings to constraint movement of your spark objects, more on that soon.

Now that we have our properties, we can add the object the object to the physics world. But first, let's add a ground plane so that our objects don't fall infinitely in your scene.

physar.createObject(groundPlane, 'ground', {});

Add the sphere object with its properties to the world:

physar.createObject(sphere, 'sphere', sphereProps);

And finally, start the physics simulation:

physar.start();

The sphere should have physics now!