Difference between revisions of "LlPreloadSound"

From Second Life Wiki
Jump to navigation Jump to search
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=93|func_sleep=1.0|func_energy=10.0|func=llPreloadSound|p1_type=string|p1_name=sound|func_footnote=preloads a sound on viewers within range|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{LSL_Function
|inject-2={{Issues/BUG-7854}}{{LSL_Function/inventory|sound|uuid=true|type=sound}}
|func_id=93|func_sleep=1.0|func_energy=10.0
|func=llPreloadSound
|p1_type=string|p1_name=sound
|func_footnote
|func_desc=Preloads {{LSLP|sound}} on viewers within range
|return_text
|spec
|caveats
|constants
|examples=<source lang="lsl2">//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);
    }
}</source>
|helpers
|also_functions
|also_events
|also_tests
|also_articles
|notes
|sort=PreloadSound
|cat1=Sound
|cat2
|cat3
|cat4
}}

Revision as of 05:04, 16 December 2015

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