Version: Unity 6.3 Beta (6000.3)
Language : English
Animator Override Controller
The PlayableGraph, nodes, and output

Playables API

Use the Playables API to dynamically blend animation, create gameplay mechanism, or other complex behaviors by organizing and evaluating data sources in a PlayableGraph.

The Playables API refers to a set of classes, structs, and methods that you use to create the PlayableGraph, its nodes, and outputs. Playables and the Playables API complement the Mecanim animation system.

The Scripting Reference on Playables contains the list of classes, structs, and methods that you use to interact with animation, audio, and scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary
. You can also create custom playables and script playables.

Use the Playables API to do the following:

  • Dynamically blend animation.
  • Play an animation clipAnimation data that can be used for animated characters or simple animations. It is a simple “unit” piece of motion, such as (one specific instance of) “Idle”, “Walk” or “Run”. More info
    See in Glossary
    without having to create and manage an Animator ControllerControls animation through Animation Layers with Animation State Machines and Animation Blend Trees, controlled by Animation Parameters. The same Animator Controller can be referenced by multiple models with Animator components. More info
    See in Glossary
    asset.
  • Dynamically create blend graphs and control blend weights.
  • Dynamically add or adjust playable nodes at runtime instead of creating a complex static graph that accounts for all possible outcomes. For example, if you have a GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
    See in Glossary
    with animation clips for interacting with a weapon, chest, and trap. Use Playables to dynamically transition and play the appropriate animation when the GameObject is near the weapon, chest, or trap.

The following topics provide details and examples on how to use the Playables API:

Topic Description
PlayableGraph, nodes, and output Describes the PlayableGraph and its main parts including the graph itself, its playable nodes, and playable outputs.
ScriptPlayable and PlayableBehaviour Describes the ScriptPlayable<> object and the PlayableBehaviour custom behavior and how to use them together to create custom playables.
Playables API examples Provides example scripts that demonstrate how to use the Playables API.

Additional resources

Animator Override Controller
The PlayableGraph, nodes, and output