Camera Events Tab

Use Camera events to configure local camera-driven room events. Camera frames stay in the browser; only settings are saved on the room.

Card#

Controls:

• Save settings: writes the current values to the room
• Enabled: turns camera interactions on or off for this room; toggling also saves
• Status indicator: shows Enabled or Disabled for the current saved state

Basic#

Controls:

• Detection: chooses Motion, Object, People, Hands, or Holistic detection
• Camera start: chooses Button or On room start
• Camera direction: chooses Front or Rear camera when the device offers both

Advanced#

Controls:

• Sensitivity: scales overall detection responsiveness. Range 0.01 to 1, step 0.01
• Motion threshold: confidence threshold required to fire a detection. Range 0.001 to 0.5, step 0.001
• Minimum pixels: minimum changed pixels needed to fire. Range 1 to 20000, step 1
• Sample interval: time between frame samples, in milliseconds. Range 50 to 5000, step 10
• Cooldown: minimum time between detections, in milliseconds. Range 0 to 60000, step 100
• Warmup: delay after camera start before reacting, in milliseconds. Range 0 to 10000, step 100

Debug#

Controls:

• Debug preview: shows the compact camera preview window in the editor
• Hide video in live mode: hides the preview window for shoppers in published rooms
• Trace: enables runtime detection tracing
• Trace level: chooses Off, Summary, or Verbose
• Log retention: days to keep trace logs. Range 1 to 365, step 1

Trace table:

• Lists the most recent detections fired while this tab is open
• Columns: Time, Detection, Changed pixels, Changed ratio, and Confidence

Good to know:

• The runtime dispatches the immersive:interaction-detected browser event with motion metrics
• Holistic detection uses MediaPipe Holistic for body pose and both hands
• Scene hands and Avatar require camera events
• Particle effects can react to camera interactions; see Particles Tab