# Satie in Lens Studio

Install the exported scene in your Lens, assign its tracks, and connect sound to objects and interactions.

Lens Studio 5.15 preview tested

[Documentation](https://www.satie.world/docs/lens-studio)

## 1. Export and assign tracks



1. Ask your coding agent to use satie_setup for lens-studio. Supply positions in metres; Lens Studio’s centimetres are scaled by the loader’s Units Per Metre setting (100 by default).
2. After composition and realization, call satie_export with engine set to lens-studio. Run its command from the folder containing Assets; Node.js 18 or newer is required.
3. Add the exported Satie script to a scene object. Assign the audio assets under Assets/Satie/Audio to its Tracks field. The camera supplies the listener unless you choose another one. A missing track is silent and named in the Logger.

## 2. Connect interactions

From JavaScript the same instance is available as global.satie. Use scene object names for automatic host binding, and bind explicitly when names differ. Keep recording banks small and inspect the export’s asset-size warnings.

TypeScript · use your declared host and event names

```
Satie.instance.bind("door", doorObject);
Satie.instance.hostEvent("door", "open");
Satie.instance.signal("hand_distance", 0.7);
Satie.instance.state("night");
```

## Recorded and synthesized voices

The export includes an Audio Output asset for each live synth loop. Assign it in Tracks to synthesize that voice inside the Lens, or keep its rendered recording for ordinary positioned playback. Live synth output has no direction in this integration, although its level still follows distance. It consumes script time; measure on the device you plan to ship.

## What to check before shipping

Recorded voices carry placement, distance, recurrence, events, surfaces, states and supported volume/emission controls. Recorded pitch changes, room reverb, occlusion, per-voice effects, paths, entities and the editor mixer are not carried; the export lists the losses for your scene.

The integration has been exercised in Lens Studio 5.15.4 preview on macOS. Spectacles playback, device voice limits and live synth cost have not been validated. Test the exported Lens on the target device.

[Integration reference](/developers/reference/lens-studio.md)

## Support and validation

Lens Studio 5.15.4 preview on macOS.

Recorded pitch, room reverb, occlusion, per-voice effects, paths, entities and the mixer are not carried.

Live synth output has distance-driven level but no direction; use rendered takes for positioned synth playback. Review notCarried for each scene.

Not yet validated: Spectacles hardware

Not yet validated: Device voice limits

Not yet validated: Live synth cost on device
