llPreloadSound

From Second Life Wiki
Jump to navigation Jump to search

Summary

Function: llPreloadSound( string sound );
1.0 Forced Delay
10.0 Energy

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.

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

Signature

function void llPreloadSound( string sound );