OsTriggerSound
From OpenSimulator
(Difference between revisions)
m (Use 0 and not None for no function delay.) |
(Add exemples) |
||
| Line 5: | Line 5: | ||
|delay=0 | |delay=0 | ||
|ossl_example=<source lang="lsl"> | |ossl_example=<source lang="lsl"> | ||
| − | osTriggerSound( | + | // |
| − | + | // osTriggerSound Script Example | |
| + | // | ||
| + | |||
| + | string sound; | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | sound = llGetInventoryName(INVENTORY_SOUND, 0); | ||
| + | |||
| + | if (sound == "") | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSound running."); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | osTriggerSound(1, sound, 1.0); | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | <source lang="lsl"> | ||
| + | // | ||
| + | // osTriggerSound Script Example | ||
| + | // | ||
| + | |||
| + | string sound = "d7a9a565-a013-2a69-797d-5332baa1a947"; | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | if (osIsUUID(sound)) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSound running."); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Invalid uuid detected ..."); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | osTriggerSound(1, sound, 1.0); | ||
| + | } | ||
| + | } | ||
</source> | </source> | ||
|description=Start playing the specified sound in the viewers of nearby avatars once at the specified volume. | |description=Start playing the specified sound in the viewers of nearby avatars once at the specified volume. | ||
| Line 14: | Line 68: | ||
This function was added in 0.9.0.1 | 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 | 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 | ||
| − | |||
}} | }} | ||
Revision as of 13:48, 27 November 2020
 |
Languages: |
|
osTriggerSound(integer linknum, string sound, float volume)
| |
| Start playing the specified sound in the viewers of nearby avatars once at the specified volume.
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 | 0 seconds |
| Example(s) | |
// // osTriggerSound Script Example // string sound; default { state_entry() { sound = llGetInventoryName(INVENTORY_SOUND, 0); if (sound == "") { llSay(PUBLIC_CHANNEL, "Inventory sound missing ..."); } else { llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSound running."); } } touch_start(integer number) { osTriggerSound(1, sound, 1.0); } } // // osTriggerSound Script Example // string sound = "d7a9a565-a013-2a69-797d-5332baa1a947"; default { state_entry() { if (osIsUUID(sound)) { llSay(PUBLIC_CHANNEL, "Touch to hear osTriggerSound running."); } else { llSay(PUBLIC_CHANNEL, "Invalid uuid detected ..."); } } touch_start(integer number) { osTriggerSound(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 | |
