Sound
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. -->
Sound
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. -->TODO: describe this component.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2game.sound.Sound — the village, heard. SOUND COMES FROM WHERE THE THING IS. Every bed here is an emitter ENTITY standing at the place it belongs to, so walking away from the tea stall fades it and walking to the pond brings the frogs up. Nothing is played from the player: the scene carries an `AudioListener` on the player's camera rig and the engine does the spatialisation, so this component only has to put the sources in the right places. Driven entirely by `game.Game.bus`: "place" → which bed leads "weather" → dry or rain "beat" → a story moment's one-shot THE ASSET PATHS ARE LITERALS, one per line, and that is not style. `asset. resolve` with a computed argument is REFUSED on a component or a scene entrypoint — the name cannot be pinned statically, so content using it cannot be published — so `DIR .. file` is an error and the full path is written out at each call site. It is also why the one-shots are a named table rather than a function taking a filename. The Bangla voice is NOT here yet: a line reaches this slice as text on `say` and there are no speech clips to play, so dialogue is silent until they are baked. Stated, not hidden.
grab(key: ?, ok: ?, ref: ?) → void
| arg | type | description |
|---|---|---|
| key | ? | |
| ok | ? | |
| ref | ? |
makeEmitter(key: ?, clip: ?, x: ?, y: ?, z: ?, volume: ?, radius: ?, looping: ?) → void
| arg | type | description |
|---|---|---|
| key | ? | |
| clip | ? | |
| x | ? | |
| y | ? | |
| z | ? | |
| volume | ? | |
| radius | ? | |
| looping | ? |
setVolume(key: ?, value: ?) → void
| arg | type | description |
|---|---|---|
| key | ? | |
| value | ? |
lead(key: string) → string
Bring one bed up and push the others back, so the mix follows the player through the village without anything stopping and starting.
| arg | type | description |
|---|---|---|
| key | string | The bed to lead: birds, insects, wind, village, water or stall. |
examples
sound:lead("water")setRain(falling: boolean, heavy: boolean) → boolean
Turn the rain on and off. The rain beds are not wired yet: their clips did not resolve as `audio` assets, so this reports what it could not do rather than pretending the weather has a sound.
| arg | type | description |
|---|---|---|
| falling | boolean | True to bring the rain in. |
| heavy | boolean | True for the monsoon downpour rather than light rain. |
examples
sound:setRain(true, true)
shot(name: string) → boolean
Fire one of the named one-shots at the player.
| arg | type | description |
|---|---|---|
| name | string | One of: door, step, fire, storm. |
examples
sound:shot("door")awake( ) → void
start( ) → void
Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.