Difference between revisions of "LlPlaySoundSlave"

Latest revision as of 15:03, 22 April 2022

Function: llPlaySoundSlave( string sound, float volume );

Plays attached sound once at volume, synced to next loop of most audible sync master declared by llLoopSoundMaster.

• string	sound	–	a sound in the inventory of the prim this script is in or a UUID of a sound
• float	volume	–	between 0.0 (silent) and 1.0 (loud) (`0.0 <= volume <= 1.0`)

If sound is missing from the prim's inventory and it is not a UUID or it is not a sound then an error is shouted on DEBUG_CHANNEL.
If sound is a UUID then there are no new asset permissions consequences for the object.
- The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
As an object can only have a single active sound, this function should be called from a different prim than the one that defined a sync master, otherwise it will remove the master sound, and no sound will be available to sync-to.
This function is affected by the Sound Queueing property of the parent prim - this means it's possible to queue a slave sound prior to starting a master, without having to use more than one prim as an emitter. (See example on llLoopSoundMaster).

A

A

Signature
function void llPlaySoundSlave( string sound, float volume );

@@ Line 9: / Line 9: @@
 |return_text
 |spec
-|caveats=* As an object can only have a single active sound, llPlaySoundSlave() should be called from a different prim than the one that defined a sync master, otherwise it will remove the master sound, and no sound will be available to sync-to.
+|caveats=
+* As an object can only have a single active sound, this function should be called from a different prim than the one that defined a sync master, otherwise it will remove the master sound, and no sound will be available to sync-to.
+* This function is affected by the [[llSetSoundQueueing|Sound Queueing]] property of the parent prim - this means it's possible to queue a slave sound prior to starting a master, without having to use more than one prim as an emitter. (See example on [[llLoopSoundMaster]]).
 |constants
 |examples
@@ Line 20: / Line 22: @@
 {{LSL DefineRow||[[llTriggerSound]]|3=Plays a sound {{HoverText|unattached|The sound does not move with the prim}}.}}
 {{LSL DefineRow||[[llTriggerSoundLimited]]}}
+{{LSL DefineRow||[[llSetSoundQueueing]]}}
 |also_events
 |also_tests

•	llPlaySound	–	Plays a sound attached once.
•	llLoopSound	–	Plays a sound attached indefinitely.
•	llLoopSoundMaster
•	llLoopSoundSlave
•	llTriggerSound	–	Plays a sound unattached.
•	llTriggerSoundLimited
•	llSetSoundQueueing