Behavior Actions

Mattercraft has powerful tools for setting up interactivity and simplifying frequently used functionality without writing any code called Behavior Actions.

These actions are part of the broader Behaviors category, which also encompasses Custom Behaviors. The main difference is that Behavior Actions attach to an event instance such as onClick.

Adding a Behavior Action

You can easily add Behavior Actions from the Behaviors Panel. Just click on the + (plus) icon, and a list of contextual behavior actions related to the currently selected node will appear.

Adding a Behavior Action

Behavior Actions

Behavior Actions offer simple yet robust pieces of functionality that, when added, expose relevant editable properties in the interface.

The list of available actions goes beyond the example below and hovering over each action provides a detailed explanation of its purpose and functionality.

Some of the available actions include:

Example Behavior Actions

Behavior Action	Description
Toggle Visibility	Set the visibility of the node based on an emitted event.
Launch Web XR Session	Initiates a WebXR session.
Activate Camera	Activate a defined camera when an event is emitted.
Take Snapshot	Captures the canvas as an image. This image can then be shared or downloaded using other behaviors.
Show Text Alert	Display a customizable text alert when an event is emitted.
Share Snapshot	Shares the captured canvas using the Web Share API.
Play Sound	Plays a sound.
Log Analytics Event	Logs an event through the currently configured analytics provider(s). You must have added an analytics provider to the Hierarchy in one of your components for this behavior to have any effect.
Download Snapshot	Downloads the captured canvas as an image.
Launch URL	Launches a URL when an event is emitted.
Console Log	Outputs a message to the console log.

See Mattercraft’s full API documentation here.

Additional Behaviors

As well as Actions, you can find a number of other helpful, easy to use behaviors in the dropdown, some of which are detailed below:

Behavior	Available Actions	Description
Appearance	Override Opacity	Change the opacity of a given node and its children, allowing you to control its transparency easily.
Helpers	Bounding Box	Surround the node with a bounding box, which is highly useful for debugging and visualizing the spatial boundaries of the node.
Animation Actions	Toggle Layer Clips Set Layer Off Play Layer Clip Pause Layer Clip Activate State	Easy ways to activate and play Clips (States and Timelines). For more information, see the Animation System documentation.
Stream Actions	Stop Stream Seek Stream Play Stream Pause Stream	Enable you to play, pause, stop, and seek streamed tracks, including 3D model animations, videos, and audio clips.

Creating Custom Behaviors

You can also create your own Custom Behaviors. Custom behaviors are great for developing templated functionality you want to reuse across multiple projects or use multiple times in a single project.

Creating a new Custom Behavior Component

To learn more about how to setup a custom behavior, we recommend reading the Creating Custom Behaviors article.