Unity Script Reference – Animation.Play

Animation.Play

function Play (mode : PlayMode = PlayMode.StopSameLayer) : boolean

function Play (animation : String, mode : PlayMode = PlayMode.StopSameLayer) : boolean

Description

Plays animation without any blending.

Play() will start animation with name animation, or play the default animation. The animation will be played abruptly without any blending.

If mode is PlayMode.StopSameLayer then all animations in the same layer will be stopped. If mode is PlayMode.StopAll then all animations currently playing will be stopped.

If the animation is already playing, other animations will be stopped but the animation will not rewind to the beginning.

If the animation is not set to be looping it will be stopped and rewinded after playing.

Play() will return false if animation can't be played (no animation clip or no default animation).

JavaScript

// Plays the default animation
animation.Play();

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation.Play();
    }
}

import UnityEngine
import System.Collections

class example(MonoBehaviour):

    def Example():
        animation.Play()

For a specific animation, you can call the animation with play as well.

JavaScript

// Plays the walk animation - stops all other animations in the same layer
animation.Play("walk");
// Plays the walk animation - stops all other animations
animation.Play("walk", PlayMode.StopAll);

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation.Play("walk");
        animation.Play("walk", PlayMode.StopAll);
    }
}

import UnityEngine
import System.Collections

class example(MonoBehaviour):

    def Example():
        animation.Play('walk')
        animation.Play('walk', PlayMode.StopAll)