llPreloadSound

From Second Life Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Summary

Function: llPreloadSound( string sound );

Preloads sound on viewers within range

• string sound a sound in the inventory of the prim this script is in or a UUID of a sound

Caveats

  • This function causes the script to sleep for 1.0 seconds.
  • 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.
All Issues ~ Search JIRA for related Bugs

Examples

//Will preload a sound when rezzed, then play it when 'touched'.
string sound = "name or uuid";//sound in inventory or UUID of a sound.

default
{
    on_rez(integer start_param)
    {
        llSetText("Preloading....",<1,0,0>,1);
        llPreloadSound(sound);
        llSetText("Touch To Play",<1,1,1>,1);
    }
    touch_start(integer num_detected)
    {
        llPlaySound(sound, 1.0);
    }
}

Deep Notes

All Issues

~ Search JIRA for related Issues
   llPreloadAsset() - Preload any object inventory asset

Signature

function void llPreloadSound( string sound );