AnimationEvent

Description

AnimationEvent lets you call a script function similar to SendMessage as part of playing back an animation.

Animation events support functions that take zero or one parameter. The parameter can be a float, an int, a string, an object reference, or an AnimationEvent.

no example available in JavaScript

// Animation Event example
// Small example that can be called on each specified frame.
// The code is executed once per animation loop.

using UnityEngine;
using System.Collections;

public class Example : MonoBehaviour {

	public void PrintEvent() {
		Debug.Log("PrintEvent");
	}
}

A more detailed example below shows a more complex way of creating an animation. In this script example the Animator component is accessed and a Clip from it obtained. (This clip was set up in the Animation window.) The clip lasts for 2 seconds. An AnimationEvent is created, and has parameters set. The parameters include the function PrintEvent() which will handle the event. The event is then added to the clip. This all happens in Start(). Once the game has launched the event is called after 1.3s and then repeats every 2s.

no example available in JavaScript

// Add an Animation Event to a GameObject that has an Animator
using UnityEngine;
using System.Collections;

public class Example : MonoBehaviour {

	public void Start()
	{
		// existing components on the GameObject
		AnimationClip clip;
		Animator anim;
		
		// new event created
		AnimationEvent evt;
		evt = new AnimationEvent();

		// put some parameters on the AnimationEvent
		//  - call the function called PrintEvent()
		//  - the animation on this object lasts 2 seconds
		//    and the new animation created here is
		//    set up to happens 1.3s into the animation		
		evt.intParameter = 12345;
		evt.time = 1.3f;
		evt.functionName = "PrintEvent";

		// get the animation clip and add the AnimationEvent
		anim = GetComponent<Animator>();
		clip = anim.runtimeAnimatorController.animationClips[0];
		clip.AddEvent(evt);

	}

	// the function to be called as an event
	public void PrintEvent(int i) {
		print("PrintEvent: " + i + " called at: " + Time.time);
	}
}

Variables

Constructors