OsPreloadSound
From OpenSimulator
(Difference between revisions)
m (Fixed a cut and paste error) |
m (Add Author) |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{osslfunc | {{osslfunc | ||
| − | |function_syntax=osPreloadSound(string sound) | + | |function_syntax=osPreloadSound(integer linknum, string sound) |
|threat_level=ignored | |threat_level=ignored | ||
|permissions=true | |permissions=true | ||
|delay=1 | |delay=1 | ||
| + | |description=Preload the specified sound in viewers of nearby avatars. | ||
| + | The sound parameter can be the UUID of a sound or the name of a sound that is in the inventory of the target prim. | ||
|ossl_example=<source lang="lsl"> | |ossl_example=<source lang="lsl"> | ||
| − | osPreloadSound(" | + | // |
| − | + | // osPreloadSound Script Example | |
| + | // Author: djphil | ||
| + | // | ||
| + | |||
| + | string sound; | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | sound = llGetInventoryName(INVENTORY_SOUND, 0); | ||
| + | |||
| + | if (sound == "") | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Preloading sound ..."); | ||
| + | osPreloadSound(1, sound); | ||
| + | llSay(PUBLIC_CHANNEL, "Sound ready to play!"); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | osPlaySound(1, sound, 1.0); | ||
| + | } | ||
| + | } | ||
</source> | </source> | ||
| − | + | ''' And with uuid: ''' | |
| + | <source lang="lsl"> | ||
| + | // | ||
| + | // osPreloadSound Script Example | ||
| + | // Author: djphil | ||
| + | // | ||
| − | + | string sound = "ed124764-705d-d497-167a-182cd9fa2e6c"; | |
| − | |additional_info= | + | |
| − | This function was added in 0.9.0.1 | + | default |
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | if (osIsUUID(sound)) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Preloading sound ..."); | ||
| + | osPreloadSound(1, sound); | ||
| + | llSay(PUBLIC_CHANNEL, "Sound ready to play!"); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Invalid uuid detected ..."); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | osPlaySound(1, sound, 1.0); | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | |additional_info=This function was added in 0.9.0.1 | ||
| + | Since 0.9.1 if target prim inventory does not contain the sound, the inventory of the prim containing the script calling this function is also checked | ||
}} | }} | ||
Latest revision as of 09:59, 3 December 2020
 |
Languages: |
|
osPreloadSound(integer linknum, string sound)
| |
| Preload the specified sound in viewers of nearby avatars.
The sound parameter can be the UUID of a sound or the name of a sound that is in the inventory of the target prim. | |
| Threat Level | This function does not do a threat level check |
| Permissions | Use of this function is always allowed by default |
| Extra Delay | 1 seconds |
| Example(s) | |
// // osPreloadSound Script Example // Author: djphil // string sound; default { state_entry() { sound = llGetInventoryName(INVENTORY_SOUND, 0); if (sound == "") { llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); } else { llSay(PUBLIC_CHANNEL, "Preloading sound ..."); osPreloadSound(1, sound); llSay(PUBLIC_CHANNEL, "Sound ready to play!"); } } touch_start(integer number) { osPlaySound(1, sound, 1.0); } } And with uuid: // // osPreloadSound Script Example // Author: djphil // string sound = "ed124764-705d-d497-167a-182cd9fa2e6c"; default { state_entry() { if (osIsUUID(sound)) { llSay(PUBLIC_CHANNEL, "Preloading sound ..."); osPreloadSound(1, sound); llSay(PUBLIC_CHANNEL, "Sound ready to play!"); } else { llSay(PUBLIC_CHANNEL, "Invalid uuid detected ..."); } } touch_start(integer number) { osPlaySound(1, sound, 1.0); } } | |
| Notes | |
| This function was added in 0.9.0.1
Since 0.9.1 if target prim inventory does not contain the sound, the inventory of the prim containing the script calling this function is also checked | |
