Difference between revisions of "LlPlaySound"

From Second Life Wiki
Jump to: navigation, search
(I still don't know how to make a jira template so did what I could. Can someone fix this please and then post an explanation of how to make a template on my talk page. Thankies.)
Line 10: Line 10:
 
|caveats=*If the object playing the sound is a {{HoverLink|HUD|Heads Up Display}}, the sound is only heard by the user the HUD is attached to.
 
|caveats=*If the object playing the sound is a {{HoverLink|HUD|Heads Up Display}}, the sound is only heard by the user the HUD is attached to.
 
**To play a sound inworld from a HUD use [[llTriggerSound]].
 
**To play a sound inworld from a HUD use [[llTriggerSound]].
*If multiple sound emitters use the same sound (by UUID) within range of the same viewer (known to affect RC 1.23) the viewer can produce unwanted echoes of the sound (see JIRA VWR-15663).
+
*If multiple sound emitters play the same exact sound within range of the viewer an echo effect can be produced.
 +
*It is impossible to play two (or more) sounds at the same time and have them start playing at exactly the same time ~ {{JIRA|VWR-15663}}
 
|constants
 
|constants
 
|examples=<lsl>
 
|examples=<lsl>

Revision as of 10:29, 29 September 2009

Summary

Function: llPlaySound( string sound, float volume );

Plays attached sound once at volume

• 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)

Caveats

  • 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.
  • If the object playing the sound is a HUD, the sound is only heard by the user the HUD is attached to.
  • If multiple sound emitters play the same exact sound within range of the viewer an echo effect can be produced.
  • It is impossible to play two (or more) sounds at the same time and have them start playing at exactly the same time ~ VWR-15663
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default

{
    state_entry()
    {
         llPlaySound("some_sound",1.0);
    }
}
</lsl>

See Also

Functions

•  llTriggerSound Plays a sound unattached.
•  llTriggerSoundLimited
•  llLoopSound Plays a sound attached.
•  llLoopSoundMaster
•  llLoopSoundSlave
•  llPlaySoundSlave
•  llSetSoundQueueing

Deep Notes

Search JIRA for related Issues

Signature

function void llPlaySound( string sound, float volume );