Asset Library
The Asset Library is a repository containing a wide variety of assets and helpers that allows you to build your unique Lens Experiences or to refine your Lenses. It contains everything from simple reusable assets, to machine learning models that allows you to add new capabilities to your Lenses.
What’s in it
- Essentials: A selection of frequently used assets and components.
- 3D: 3D models that can be added to your Lenses.
- 2D: Textures, hints, masks, and more for 2D design.
- Materials: Custom materials to change the appearance of any mesh in your scene.
- Tools: Helper scripts that enhance the capabilities of your Lens.
- Effects: Custom shaders, particles, VFX, and full-screen effects.
- SnapML: Machine Learning models that extend the capabilities of Lens Studio.
- Music: A library of licensed music for use in your Lenses.
- Audio: SFX and music assets.
- Spectacles: Tools specifically for developing Lenses for Spectacles.
- APIs: A collection of Remote API modules allowing your Lens to communicate with external services.
- Custom Components: Custom components that are installed into Lens Studio and can be added across projects. Note: These are not added to the project after import but become available in the 'Add Component' menu.
- Script Modules: Modules that facilitate code reuse in your scripts and custom components.
- UI: A collection of assets for Lens UI design.
Using the Asset Library
You can open the Asset Library within your project, by pressing the Asset Library button located next to the Lens Size button in the top left of Lens Studio.
Once the Asset Library is open, you’ll be able to find different categories of assets in the sidebar, and a grid of assets on the left-hand side.
For each asset, you can find an (i) button that tells you more about the asset on hover.
To import the asset, click on the Import or Install (for Custom Components) button at the bottom of the item.
Using the Assets
There are different ways to bring the imported assets into your Lens depending on its type.
Most commonly, your assets will come in a Prefab
which you can find in the Resources panel. To use it, drag the asset (item with the icon P
on a box) from the Resources panel, into the Objects panel. Once added, you can select the assets you need and remove those you don’t.
In some cases, you'll want to add the Prefab
under an Orthographic Camera
since this effects is meant to work with screen hierarchy. You can learn more about How To Add an Orthographic Camera.
Potentially, some assets may import as an LSO
. In these cases, the asset will automatically be added into the Objects panel. This occurs more frequently when the asset requires different Cameras to achieve the effect.
This workflow is similar to sharing an asset between Lens Studio projects. An example of this workflow would be right-clicking an object in the Objects panel and selecting Export. In another Lens Studio project, you can then right-click on the Objects panel and select Import.
If the assets utilizes cameras, take a look at the Scene Config panel to further customize how the assets are used in your Lens.
Some assets may come with additional instructions on how to integrate it into your scene. In these cases, you might either have an image with instructions found in the Resources panel, or a print out in the Logger panel with a link that you can go to.
You can open the image with instructions by using the viewer in the Inspector panel by clicking on the item in the Resources panel. Alternatively, you can use another photo application installed on your computer.
Additional assets may require further setup once imported into your project. In these cases, you will see an object marked with [DELETE_ME]
in the Objects
panel, which you can right-click and delete once you've read it.
Assets from Custom Component
category are installed to your Lens Studio instead of being added to the current project. Click on the Install
or Update
button of the custom component in the Asset Library and the most relevant version of it could be added to the Resources panel by clicking on the +
button or directly in Scene Object inspector by clicking on Add Component
Button.
Submitting Your Assets to the Asset Library
Are you interested in contributing your assets to the Asset Library? We welcome creative and useful submissions from our community directly through My Lenses. To get started, follow these steps:
-
Prepare Your Assets Ensure your assets meet our submission guidelines. This includes checking for quality, compatibility, and appropriate licensing.
-
Submit via My Lenses Fill out our asset submission form, providing details about your asset and how it can enhance Lens experiences.
We accept assets in the following file extensions: "dnn","fbx","gif","glb","gltf","jpeg","jpg","lsc","lsmat","lso","lspkg","mp3","mp4","obj","ogg","onnx","oprfb","png","t3d","ts","wav","zip"