OsAvatarPlayAnimation

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Change See Also)
 
(One intermediate revision by one user not shown)
Line 11: Line 11:
 
default
 
default
 
{
 
{
     state_entry()
+
     touch_start(integer num)
 
     {
 
     {
         llSay(PUBLIC_CHANNEL, "Touch to see osAvatarPlayAnimation usage.");
+
         // Get the name of the animation from the prim's inventory
    }
+
         string anim = llGetInventoryName(INVENTORY_ANIMATION, 0);
 
+
       
    touch_start(integer number)
+
        // Play the animation on the avatar who touched the object
    {
+
         osAvatarPlayAnimation(llDetectedKey(0), anim);
         string animation = llGetInventoryName(INVENTORY_ANIMATION, 0);
+
         osAvatarPlayAnimation(llDetectedKey(0), animation);
+
 
     }
 
     }
 
}
 
}
Line 35: Line 33:
 
changed(integer change)
 
changed(integer change)
 
{
 
{
 +
    // Check if there's a change in the link set
 
     if (change & CHANGED_LINK)
 
     if (change & CHANGED_LINK)
 
     {
 
     {
 +
        // Get the key of the user sitting on the object
 
         key user = llAvatarOnSitTarget();
 
         key user = llAvatarOnSitTarget();
 +
       
 +
        // Stop the sit animation
 
         osAvatarStopAnimation(user, "sit");
 
         osAvatarStopAnimation(user, "sit");
         osAvatarPlayAnimation(user, anim);      
+
       
 +
        // Play the desired animation on the user
 +
         osAvatarPlayAnimation(user, anim);
 
     }
 
     }
 
}
 
}
Line 46: Line 50:
 
}}
 
}}
 
== See Also ==
 
== See Also ==
*[[osAvatarStopAnimation]]
+
* [[osAvatarPlayAnimation]]
*[[OSSL_Script_Library/OSSL_Poseball|OSSL_Poseball script]]
+
* [[osAvatarStopAnimation]]
 +
* [[OSSL_Script_Library/OSSL_Poseball|OSSL_Poseball script]]

Latest revision as of 01:00, 7 March 2024

osAvatarPlayAnimation(key avatar, string animation)
This function causes an animation to be played on the specified avatar.

The variable animation must be the name of an animation within the task inventory. For security reasons, UUIDs are not allowed here.

Instead of the name of an animation in the prim's inventory, you can also use the names of the viewer's built-in animations.

osAvatarPlayAnimation does not perform any security checks or request animation permissions from the targeted avatar.

Threat Level VeryHigh
Permissions Use of this function is always disabled by default
Extra Delay 0 seconds
Example(s)
//
// osResetAllScripts Script Example
//
 
default
{
    touch_start(integer num)
    {
        // Get the name of the animation from the prim's inventory
        string anim = llGetInventoryName(INVENTORY_ANIMATION, 0);
 
        // Play the animation on the avatar who touched the object
        osAvatarPlayAnimation(llDetectedKey(0), anim);
    }
}
Notes
When using this function in an object that requires the user to sit on the object (like a chair,or a poseball), you will need to stop the sit animation by including the following snippet:
changed(integer change)
{
    // Check if there's a change in the link set
    if (change & CHANGED_LINK)
    {
        // Get the key of the user sitting on the object
        key user = llAvatarOnSitTarget();
 
        // Stop the sit animation
        osAvatarStopAnimation(user, "sit");
 
        // Play the desired animation on the user
        osAvatarPlayAnimation(user, anim);
    }
}


[edit] See Also

Personal tools
General
About This Wiki