Event Driven Sounds

From Second Life Wiki
Jump to navigation Jump to search

Event Driven Sounds

Touched

Would you like your creation to make noise when someone clicks on it?

default
{
    touch_start(integer num_detected)
    {
        string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);

        llPlaySound(firstSoundInPrim, 1.0);
    }
}

Near

If someone is nearby, this script will play a sound.

float distanceInMeters = 3.0;
float timeBetweenSweeps = 15.0;

default
{
    on_rez(integer start_param)
    {
        llResetScript();
    }

    state_entry()
    {
    //  AGENT is deprecated, use AGENT_BY_LEGACY_NAME instead

        llSensorRepeat("", NULL_KEY, AGENT_BY_LEGACY_NAME, distanceInMeters, PI, timeBetweenSweeps);
    }

    sensor(integer num_detected)
    {
        string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);

        llPlaySound(firstSoundInPrim, 1.0);
    }
}

Collided

Would you like your bushes to rustle when something walks into them? Or your rats to squeak if someone steps on them?

Which is necessary depends on how the object is set. Pathfinding-enabled creatures require the collision event. Obstacles vary depending on how their pathfinding attributes are set.

default
{
    state_entry()
    {
        if (llGetStatus(STATUS_PHANTOM))
//      {
            llVolumeDetect(TRUE);
//      }
        else
//      {
            llVolumeDetect(FALSE);
//      }
    }

    collision_start(integer num_detected)
    {
        string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);

        llPlaySound(firstSoundInPrim, 1.0);
    }
}
default
{
    state_entry() 
    { 
        string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);

        llCollisionSound(firstSoundInPrim, 1.0);
    }  
}

If you are hearing an annoying "thud" sound when things collide, add this to the objects to silence the default collision sound.

default
{
    state_entry() 
    { 
        llCollisionSound("", 0.0);
    }  
}

Sat on

Would you like your horse to neigh, or your chair to creak when someone sits on it?

vector sit_position = <0.0, 0.0, -0.1>;
//  here an euler rot
vector sit_rotation = <0.0, 0.0, 0.0>;

default
{
    state_entry()
    {
        llSitTarget(sit_position, llEuler2Rot(sit_rotation * DEG_TO_RAD));
    }

    changed(integer change)
    {
        if (change & CHANGED_LINK)
        {
            key sittingAvatar = llAvatarOnSitTarget();

        //  when there's no avatar sitting, stop running code here
            if (avatar == NULL_KEY) return;

            string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);
            llPlaySound(firstSoundInPrim, 1.0);
        }        
    }   
}

Scripting comments

This gets the name of the first sound in the object's inventory. You can replace it with the name of a sound or its UUID.

    string firstSoundInPrim = llGetInventoryName(INVENTORY_SOUND, 0);

You can replace llPlaySound() with llTriggerSound() in the scripts above. The latter plays sounds unattached, so consider carefully if you're using it on a moving object or with a several seconds long sound.