Use AR Library to import complete 3D objects, audio clips, patch assets, textures and scripts into your Spark AR Studio projects. It's a quick and easy way to start building your own effects.
AR Library includes assets provided by Facebook and Sketchfab:
Attribution is provided automatically when people view the effect. You don’t need to provide attribution when publishing your effect.
To see the license for each asset, select the asset in AR Library.
To open AR library, click the Library icon in the toolbar:
You can also:
AR Library will open in a separate window:
To find assets either browse categories using the menu on the left, or use the search bar.
Use these 3D objects for prototyping. To find them:
We've partnered with Sketchfab to provide a huge range of 3D models. 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.
To browse Sketchfab 3D models:
To manage the Sketchfab account you're logged into AR Library with, click Preferences in the toolbar, then AR Library.
When you've selected an object you'll see information about it under Specifications. For example, for 3D objects you'll see how many vertices it has or if there are animations included:
The specifications should help you make sure any assets you import follow our technical guidelines, so your effect works well on different devices.
To add the asset to your project, click Import.
There's a vast range of loops and one-shot sound files included in AR Library, grouped into 3 categories so you can easily find the sounds you need to build creative sonic experiences. To find them:
Sounds here are tonal and/or rhythmic with a musical nature. This category includes music loops, musical stingers, and instrument elements.
This category includes sounds that work well as individual design elements, used to emphasize events like interactions and animations. For example, sounds from real and imaginary creatures and realistic sound effects like machines and tools.
Either real or imagined, ambient sounds can set the mood in exciting and immersive ways. For example, by extending sound through loops. Files here include complex sounds blended into single files, letting you quickly create unique soundscapes that reinforce visuals.
Next to the name of the audio file we’ve added a recommended behavior:
This is how we think the audio file will work best in an effect. There are 3 recommended behaviors:
Loop - For audio files that work well as seamless audio loops, added to the scene with a Single-Clip Controller patch.
Loop Layer - For seamless audio loops designed as part of a set of related loops to be played together and mixed between - for example, in response to interactions. Look for sequential files with the Loop Layer label to import a loop layer set into your project. Add them to the scene with the Single-Clip Controller patch.
One-Shot - For single, non-looping sounds commonly that work well when played in sync with animations, interactions and gestures. Add them to the scene with the Multi-Clip Controller patch.
To add the audio file to your project, click Import Free.
Use environment textures to add realistic light to objects that use physically-based materials. To find them in AR Library:
AR Library includes a range of useful script packages for adding more functionality to your code. For example, the cannon script package adds the appearance of gravity to objects, and the sparkar-head-rotation-trigger script package provides a function to enable firing events in response to head movements.
To browse and import script packages:
The script package will be listed in the Assets panel under Packages:
To add a script package to your project:
spark-ar-librarywith the library you just installed:
// in script.js const library = require('spark-ar-library');
Patch assets are ready-made patch graphs. Use them to quickly add logic, visual effects and complexity to your projects. There are 2 categories to choose from:
To find them:
The patch asset will be listed in the Assets panel. Drag it into the Patch Editor and connect it to other patches to add it to your project.
When the asset is selected in Spark AR Studio, in the Inspector you'll see:
Add assets from AR Library to your scene like you would any other object or asset imported into Spark AR Studio.