CLEAR

Using the AR Library

Use the AR Library to import complete 3D objects and audio clips straight into your project. It's a quick and easy way to start building your own effects.

We've partnered with Sketchfab to provide 3D models for AR Library. Before you can download 3D objects from the library, you'll need to log in with your Sketchfab account. If you don't have a Sketchfab account, you can create one for free.

You can manage the Sketchfab account you're logged in to AR Library with by clicking Preferences in the toolbar, then clicking AR Library.

Assets in Sketchfab are licensed for use under the CC BY 4.0 license. To see the license for each asset:

  1. Click the asset in AR Library.
  2. Click Creative Commons Attribution.

When people use an effect in the Facebook camera with an asset from AR Library, they'll be able to view the asset creator's name.

Adding an asset from the AR Library

To add an asset to your project:

  1. Click + in the Assets tab.
  2. Select Import from AR Library.

You can also click AR Library in the toolbar. AR Library will open in a separate window, like in the screen below.

Importing your asset

When you've selected an asset, you'll see its specifications, such as how many vertices a 3D object has or if there are animations contained in the asset. The specifications should help you make sure any assets you import follow our technical guidelines, so that your effect works well on different devices.

To add the asset to your project, click Import.

Viewing imported assets in Spark AR Studio

When the asset is selected in Spark AR Studio, in the Inspector panel you'll see:

  • The name of the file.
  • The size of the file.
  • Its components - including any animations, and unsupported components.

Adding imported assets to your scene

To add an imported asset to your scene, drag it from the Assets panel in to the scene. For example, if you want it to appear in someone's surroundings, add it as a child of a plane tracker, or if you want an object to track to track a hand, add it on a hand tracker.

You can change properties like scale, position and appearance of imported assets, as you would any other 3D object or audio file.