OsPlaySound

From OpenSimulator

Jump to: navigation, search
osPlaySound(integer linknum, string sound, float volume)
Play the specified sound 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 prim containing the script calling this function.

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)
//
// osPlaySound 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 osPlaySound running.");
        }
    }
 
    touch_start(integer number)
    {
        osPlaySound(1, sound, 1.0);
    }
}

And with uuid:

//
// osPlaySound Script Example
//
 
string sound = "f4a0660f-5446-dea2-80b7-6482a082803c";
 
default
{
    state_entry()
    {
        if (osIsUUID(sound))
        {
            llSay(PUBLIC_CHANNEL, "Touch to hear osPlaySound running.");
        }
 
        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


See Also

Personal tools
General
About This Wiki