$nav
===== Function: llPreloadSound =====

<code lsl2>
llPreloadSound(string sound)
</code>

Preload a $lart[sound]. The idea of preloading a sound is to transmit the sound in advance, so that when the time to play it comes, it is already cached by the surrounding avatars' viewers, and plays without delay.

$delay[1.0]

===== Parameters =====

=== sound ===
Sound name or $lart[UUID] of the sound clip to preload.

===== Notes =====

  * If used in a $lart[HUD], the preload is only effective for the owner.
  * Sounds are usually deleted from the cache when relogging.
  * If the sound is a $lart[UUID], it doesn't need to be present in the prim.
  * If the name of a sound present in the prim's inventory matches the $art[UUID] of a different sound, the sound that will be preloaded is the one in the item, not the $art[UUID].
  * If the name is not a $art[UUID], and it is not present in the prim's inventory, or if an item with that name which is not a sound exists in the prim's inventory, an error will be privately said (20m range) to the owner in $lct[DEBUG_CHANNEL].

===== Short examples =====

<code lsl2>
llPreloadSound("My Sound"); // Preloads the sound "My Sound" (the clip must exist in the prim)
</code>

===== Complete examples =====

<file lsl2 llPreloadSound-example.lsl>
default
{
    on_rez(integer param)
    {
        // Preload a bubbling sound when this object is rezzed.
        llPreloadSound("00000000-0000-0000-0000-000000000115");
    }

    touch_start(integer count)
    {
        // When touched, the sound will immediately be ready to play if the avatar
        // was present when the object was rezzed.
        llPlaySound("00000000-0000-0000-0000-000000000115", 1.0);
    }
}
</file>

===== See also =====
  * $lfn[llStopSound] stops a sound playing in this prim.
  * $lfn[llLoopSound] plays a looped sound in this prim.
  * $lfn[llLoopSoundMaster] plays a looped sound letting others synchronize with it.
  * $lfn[llLoopSoundSlave] plays a looped sound synchronized with a master.
  * $lfn[llPlaySound] plays a sound once in this prim.
  * $lfn[llPlaySoundSlave] plays a sound synchronized with a master.
  * $lfn[llAdjustSoundVolume] adjusts the volume of a sound playing in this prim.
  * <wrap important>$lfn[llSetSoundRadius]</wrap> adjusts how far the prim sounds can be heard.
  * $lfn[llSetSoundQueueing] adjusts whether sounds are enqueued in this prim.
  * $lfn[llTriggerSound] "drops" a sound where the prim is.
  * $lfn[llTriggerSoundLimited] "drops" a sound where the prim is, with limited reach.
  * $fn[llPreloadSound] causes a sound to be preloaded, for faster playing.
  * <wrap important>$lfn[llSound]</wrap> plays a sound in this prim (deprecated - use $lfn[llPlaySound] instead).
  * <wrap important>$lfn[llSoundPreload]</wrap> causes a sound to be preloaded (deprecated - use $lfn[llPreloadSound] instead).
  * $lart[Sound] (general information)