Link Search Menu Expand Document

arena-message

The top-level ARENA wire message. All ARENA messages share this envelope structure. The data attribute contents depend on the message type.

ARENA Message Attributes

Attribute Type Default Description Required
object_id string   A uuid or otherwise unique identifier for this object. Yes
persist boolean True Persist this object in the database. Yes
type string; One of: ['gripdown', 'gripup', 'menudown', 'menuup', 'mousedown', 'mouseenter', 'mouseleave', 'mouseup', 'object', 'program', 'scene-options', 'soundpause', 'soundplay', 'soundstop', 'systemdown', 'systemup', 'trackpaddown', 'trackpadup', 'triggerdown', 'triggerup']   ARENA message type. Yes
action string; One of: ['create', 'delete', 'update'] 'create' Message action create, update, delete. Yes
ttl number   When applied to an entity, the entity will remove itself from DOM after the specified number of seconds. Update is allowed, which will reset the timer to start from that moment. No
private boolean False If true, interactions with this object should not be broadcasted to other clients, but rather sent on private topics No
program_id string   The program_id on private program topics that interactions to be directed to, if the private flag is set true. Ignored if private flag is false. No
timestamp string   Indicates the time of message in milliseconds. No
override boolean False If true, override timestamp and overwrite protection will not happen for older messages. No
data object   The message payload. Varies by message type. See: ARENAUI Button Panel, ARENAUI Card Panel, ARENAUI Prompt, Box, Camera Override, Capsule, Circle, Cone, Cube (deprecated; don’t use), Cylinder, Dodecahedron, Entity (generic object), Event, Gaussian Splat, GLTF Model, Hand, Hand, Icosahedron, Image, Light, Line, Camera Override, OBJ Model, Ocean, Octahedron, PCD Model, Plane, Program, Ring, Rounded Box, Scene Config, Sphere, Camera Override, Tetrahedron, Text, Thickline, Three.js Scene, Torus, Torus Knot, Triangle, URDF Model, Videosphere Yes