OsTriggerSound

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Add See Also)
 
(6 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
|threat_level=ignored
 
|threat_level=ignored
 
|permissions=true
 
|permissions=true
|delay=None
+
|delay=0
 
|ossl_example=<source lang="lsl">
 
|ossl_example=<source lang="lsl">
osTriggerSound(linknum, "c98100c4-6a2a-456c-a5ba-3cfdb5c14715", volume);
+
//
osTriggerSound(linknum, "Name of sound in this prim", volume);
+
// osTriggerSound 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, "Touch to hear osTriggerSound running.");
 +
        }
 +
    }
 +
 
 +
    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.
+
'''And with uuid:'''
 +
<source lang="lsl">
 +
//
 +
// osTriggerSound Script Example
 +
// Author: djphil
 +
//
  
 +
string sound = "f4a0660f-5446-dea2-80b7-6482a082803c";
 +
 +
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>
 +
|description=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.
 
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.
 
|additional_info=
 
|additional_info=
 
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
 
 
}}
 
}}
 +
== See Also ==
 +
* [[osTriggerSound]]
 +
* [[osTriggerSoundLimited]]

Latest revision as of 20:08, 5 December 2020

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
// Author: djphil
//
 
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);
    }
}

And with uuid:

//
// osTriggerSound Script Example
// Author: djphil
//
 
string sound = "f4a0660f-5446-dea2-80b7-6482a082803c";
 
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


[edit] See Also

Personal tools
General
About This Wiki