Content Editor Tools
The Content Editor Tools is an asset that showcases a selection of tools that allow users to manipulate and place content from within a Lens. You can find these Custom Components in the Content Editor Tool Template.
The Content Editor Tools has been designed with Spatial Persistence in mind. With this, if the Lens is a location-based experience, content can be persist even after the lens has been closed. This allows users to return to the same location later, open the lens, and their content will be restored using Spatial Persistence.
Please visit the Spatial Persistence section to learn more about creating persistent content.
By the end of this document, you will learn about the components that can enable editable AR experiences called the Content Editor Tools.
These custom components are also available on the asset library.
Content Editor Tools
Let's take a look at what is included with the Content Editor Tools and how each piece functions together.
Edit mode and the Content Editor component
Adding a Content Editor component to a project will enable an edit mode toggle to appear in the bottom left of the lens.
When the edit mode toggle is tapped, the lens will enter an edit mode where individual AR objects can be selected, manipulated, or deleted.
The Content Editor component includes an undo and redo buttons which can help users by providing a non-destructive editing experience where they are free to experiment and try things out.
Content Provider
The Content Provider component presents a user with a scrollable selection bar of assets to place.
You can add your own assets for a Content Provider by adding a Content Provider Option component on SceneObjects that are parented a Content Provider SceneObject
Within a Content Provider Option component, you can specify a prefab for the ContentProvider to spawn.
:::
The Content Provider component will only be visible when it references a Content Editor component and that Content Editor component is in Edit mode.
Spatial Persistence and the Content Storage component
If your experience is a location-based experience that uses a LocationAsset, you can have your users’ content persist so when they return to the same physical location and reopen the lens, their previous content will be loaded in.
To enable Spatial Persistence with the Content Editor Tools:
- Add a Content Storage component to your scene which can be linked to a Content Provider component.
- Add a Persistable component to the asset you want to persist.
Any asset which has a Persistable component will be persisted between a user’s lens session.
Assets without a Persistable component will not persist.
Related Content
Now that you have learned how the Content Editor Tools can provide users with a way to create interactive and persistent content, you will be ready to put it to practice.