Unity AnimationState 动画状态

AnimationState  动画状态

Inherits from TrackedReference继承自“跟随引用”

 

The AnimationState gives full control over animation blending.

AnimationState将全面控制动画混合

In most cases the Animation interface is sufficient and easier to use. Use the AnimationState if you need full control over the animation blending any playback process.

在大多数情况下Animation界面是完全可以满足基本使用。如果你需要全面控制动画混合任何播放过程，可以使用AnimationState。

 

The AnimationState interface allows you to modify speed, weight, time and layers while any animation is playing. You can also setup animation mixing and wrapMode.

AnimationState界面允许你修改速度，重力，时间和层，即便是动画正处于播放中。你也可以设置动画合成和wrapMode（循环模式；Animation.wrapMode 循环模式 ）

 

 

The Animation

动画

 

Variables  变量

enabled 激活/允许	Enables / disables the animation. 允许/禁止动画（是否启用动画）
weight 权重	The weight of animation 动画的权重
wrapMode 循环模式	Wrapping mode of the animation. 动画的循环模式
time 时间	The current time of the animation 动画的当前时间
normalizedTime 格式化/规范化/标准化时间	The normalized time of the animation. 动画格式化时间
speed 速度	The playback speed of the animation. 1 is normal playback speed. 动画的播放数度。“1”是正常播放速度
normalizedSpeed 标准速度	The normalized playback speed. 标准的播放速度
length 长度	The length of the animation clip in seconds. 一秒内动画片段的长度
layer 层	The layer of the animation. When calculating the final blend weights, animations in higher layers will get their weights 动画的层。当计算最后的混合权重时，动画中“高层（优先级高的层）”将会先取得权重
clip 剪辑	The clip that is being played by this animation state. 动画状态播放剪辑
name 名	The name of the animation 动画的名
blendMode 混合模式	Which blend mode should be used? 应该使用那种混合模式

 

Functions  函数

AddMixingTransform 添加混合Transform（转换）	Adds a transform which should be animated. This allows you to reduce the number of animations you have to create. 应选一个动画加入Transform（转换）。这允许你减少一定数量必要的创建（动画的创建）。
RemoveMixingTransform 移除混合Transform（转换）	Removes a transform which should be animated. 应移除一个动画的Transform（转换）

 

 

 

AnimationState.blendMode  混合模式

 

var blendMode : AnimationBlendMode

Description  描述

Which blend mode should be used?

应该使用哪种混合模式？

JS:

 

// Set the leanLeft animation to blend additively

设置leanLeft 动画为混合相加
animation["leanLeft"].blendMode = AnimationBlendMode.Additive;

 

C#:

 

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["leanLeft"].blendMode = AnimationBlendMode.Additive;
    }
}

 

 

AnimationState.clip  剪辑

 

var clip : AnimationClip

Description  描述

The clip that is being played by this animation state.

剪辑是通过动画状态播放的

 

JS:

// Prints the frame rate of the animation clip to the console

//输出动画剪辑的帧速率到控制台

print(animation["walk"].clip.frameRate);

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        print(animation["walk"].clip.frameRate);
    }
}

 

 

AnimationState.enabled  启用

 

var enabled : boolean

Description  描述

Enables / disables the animation.

启用/禁用动画

For the animation to take any effect the weight also needs to be set to a value higher than zero. 

If the animation is disabled, time will be paused until the animation is enabled again.

对于动画

JS:

// Enable the walk cycle

//允许“走”循环

animation["Walk"].enabled = true;
animation["Walk"].weight = 1.0;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].enabled = true;
        animation["Walk"].weight = 1.0F;
    }
}

 

 

AnimationState.layer  图层

 

var layer : int

Description 描述

The layer of the animation. When calculating the final blend weights, animations in higher layers will get their weights distributed first. 

动画的层。当计算最后的混合权重时，处于高层中的动画将会获得权限的优先分布

Lower layer animations only receive blend weights if the higher layers didn't use up all blend weights.

如果高图层没有用尽全部的混合权重，底图层动画只接受混合权重。

 

JS:

// Puts the walk and run animation in layer 1

//将“走”和“跑”动画放入层1

animation["Walk"].layer = 1;
animation["Run"].layer = 1;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].layer = 1;
        animation["Run"].layer = 1;
    }
}

 

 

AnimationState.length  长度

 

var length : float

Description  描述

The length of the animation clip in seconds.

用秒来计算动画的长度。

JS:

// Print the length of the walk animation in seconds

//输出“走”动画的长度（秒单位）

print (animation["Walk"].length);

C:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        print(animation["Walk"].length);
    }
}

 

 

 

 

AnimationState.normalizedSpeed  标准（标准化）速度

 

var normalizedSpeed : float

Description  描述

The normalized playback speed.

标准播放速度

This is most commonly used to synchronize playback speed when blending between two animations. In most cases it is easier and better to use animation.SyncLayer instead.

这个最常被用于同步播放速度，当两个动画之间混合时。在大多数情况下可以更容易更好的使用animation.SyncLayer instead

 

JS:

// Sync run and walk speed

//同步“跑”和“走”速度

animation["Run"].normalizedSpeed = animation["Walk"].speed;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Run"].normalizedSpeed = animation["Walk"].speed;
    }
}

 

 

AnimationState.normalizedTime  标准（标准化）时间

var normalizedTime : float

Description  描述

The normalized time of the animation.

动画的标准化时间

A value of 1 is the end of the animation. A value of 0.5 is the middle of the animation.

动画结尾的值为1。动画中间的值为0.5。

JS:

// Fast forward to the middle of the animation

//快进到动画的中部

animation["Walk"].normalizedTime = 0.5;

 

C#:

using UnityEngine;
using System.Collections;
public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].normalizedTime = 0.5F;
    }
}

 

 

AnimationState.speed  速度

 

var speed : float

Description  描述

The playback speed of the animation. 1 is normal playback speed.

动画的播放速度。“1”是正常的播放速度

A negative playback speed will play the animation backwards.

负（即，负数）的播放速度将播放动画的倒放

JS:

// Walk backwards

//倒着走

animation["Walk"].speed = -1.0;

// Walk at double speed

//两倍步速

animation["Walk"].speed = 2;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].speed = -1.0F;
        animation["Walk"].speed = 2;
    }
}

 

 

AnimationState.time   时间

var time : float

Description  描述

The current time of the animation

动画的当前时间

If the time is larger than length it will be wrapped according to wrapMode. The value can be larger than the animations length. In this case playback mode will remap the time before sampling. This value usually goes from 0 to infinity

如果时间大于实际长度，它将会按照wrapMode（循环模式）循环。这个值可以大于动画长度。在这种情况下播放模式将映射之前的时间采样。这个值通常从0到无穷（大）

 

JS:

// Rewind the walk animation

//倒回步行动画

animation["Walk"].time = 0.0;

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].time = 0.0F;
    }
}

 

 

AnimationState.weight  权重

var weight : float

Description  描述

The weight of animation

动画的权重

This calculates the blend weights for one curve.

这是为了一个曲线计算混合权重

Weights are distributed so that the top layer gets everything. If it doesn't use the full weight then the next layer gets to distribute the remaining weights and so on. Once all weights are used by the top layers, no weights will be available for lower layers anymore Unity uses fair weighting, which means if a lower layer wants 80% and 50% have already been used up, the layer will NOT use up all weights. instead it will take up 80% of the 50%.

权重被分配以至于顶层获取任何一切。如果它没有使用全部权重以至于下一层获取其余权重的分配等等。一旦全部的权重通过顶层被使用，底层的Unity将没有权重可以用，这意味着，如果一个底层在已经消耗50%时还想（使用权重）消耗80%，这层将不会用尽全部的权重。反而将会消耗50%中的80%。

Example: a upper body which is affected by wave, walk and idle a lower body which is affected by only walk and idle weight name layer lower upper
 20% wave 2 0% 20%
 50% walk 1 50% 40%
 100% idle 0 50% 40%

例如：上体受到wave, walk 和 idle 的影响，下体只受到 walk 和 idle权重名的影响

 20% wave 2 0% 20%
 50% walk 1 50% 40%
 100% idle 0 50% 40%

 

- Blend weights can change per animated value because of mixing. Even without mixing, sometimes a curve is just not defined. Still you want the blend weights to add up to 1. Most of the time weights are similar between curves.

混合权重会改变每一个动画的值由于混合。即使没有混合，有时曲线仅仅是没有定义。直到你想将混合权重增加到1。大多数时权重曲线之间是相似的。

 

JS:

// Set the blend weight of the walk animation to 0.5

//设置步行动画的混合权重为“0.5”

animation["Walk"].weight = 0.5;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].weight = 0.5F;
    }
}

 

 

AnimationState.wrapMode  循环模式

 

var wrapMode : WrapMode

Description  描述

Wrapping mode of the animation.

动画的循环模式

By default wrapMode is initialized to the value set in the Animation component's wrap mode.

通过设置wrapMode（循环模式）的缺省值，设置 Animation component's（动画组件）为循环模式。

 

JS:

// Set the wrap mode of the walk animation to loop

//设置步行动画的循环模式为loop（循环）

animation["Walk"].wrapMode = WrapMode.Loop;

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Example() {
        animation["Walk"].wrapMode = WrapMode.Loop;
    }
}

 

 

AnimationState.AddMixingTransform  添加混合Transform （转换）

 

function AddMixingTransform (mix : Transform, recursive : boolean = true) : void

Description  描述

Adds a transform which should be animated. This allows you to reduce the number of animations you have to create.

添加一个动画转换（这个转换应该为动画）。这是让你减少一定数量必要创建的动画。

For example you might have a handwaving animation. You might want to play the hand waving animation on a idle character or on a walking character. Either you have to create 2 hand waving animations one for idle, one for walking. By using mixing the hand waving animation will have full control of the shoulder. But the lower body will not be affected by it, and continue playing the idle or walk animation. Thus you only need one hand waving animation.

例如，可能你有的挥手动画。可能你想去操纵挥手动画在一个闲置的角色或在一个正在步行的角色上。或者你不得不创建2个挥手动画，一个给闲置（角色），一个给正在步行的（角色）。通过使用混合挥手动画，将会完全控制臂膀。但是下肢（下体）将不会受到控制，并且继续在空闲或步行动画运动。因此你只需要一个挥手动画。

If recursive is true all children of the mix transform will also be animated. If you don't call AddMixingTransform, all animation curves will be used.

如果循环为真（true），全部的混合转化也将变为子动画。如果你没有调用AddMixingTransform，全部动画曲线将被使用。

JS:

/// Adds a mixing transform using a path instead

///添加混合转换，使用另一种路径

var shoulder : Transform;
animation["wave_hand"].AddMixingTransform(shoulder);

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    public Transform shoulder;
    void Example() {
        animation["wave_hand"].AddMixingTransform(shoulder);
    }
}

 

Another example using a path. 

另一个例子所使用的路径

JS:

function Start () {
    // Adds a mixing transform using a path instead

    var mixTransform : Transform = transform.Find("root/upper_body/left_shoulder");
    animation["wave_hand"].AddMixingTransform(mixTransform);
}

 

C#:

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
    void Start() {
        Transform mixTransform = transform.Find("root/upper_body/left_shoulder");
        animation["wave_hand"].AddMixingTransform(mixTransform);
    }
}