Skip to content

Animator (JavaScript)

Animator

Scripting Name: Insight.Animator

动画组件,用于控制动画的播放、停止,不同动画状态之间的切换等等。

Properties


isPlaying

  • type : boolean
  • (只读)动画是否正在播放。

normalizedTime

  • type : number
  • (只读)当前动画播放的位置,范围 0 - 1。

speed

  • type : number
  • 动画播放速度。

Methods


toString

javascript
public string toString();

将 animator 内容以一定格式转为 string 类型。

javascript
// sample:
var animator = gameobject.getComponent("Animator", 0);
Insight.Debug.Log(animator.toString());

crossfade

javascript
public void crossfade( string stateName, number transitionDuration, number layer = -1, number timeOffset = 0.0, number transitionTime = 0.0 );

从当前动画状态切换播放到其他动画状态,两个动画之间自然过渡。

Parameters

  • stateName : string 下一个动画状态名称
  • transitionDuration : number 动画切换过渡的持续时间,范围 [0,1]
  • layer : number 动画层索引
  • timeOffset : number 下一个动画状态开始播放的位置,范围 [0,1]
  • transitionTime : number 当前状态中切换开始的位置,范围 [0,1]
javascript
// sample:
animator.crossFade("walk", 0.2, -1, 0, animator.normalizedTime);

play

javascript
public void play( string stateName, number layer = -1, number normalizedTime = 0 );

播放动画状态。

Parameters

  • stateName : string 动画状态名称
  • layer : number 动画层索引
  • normalizedTime : number 动画播放开始的位置,范围 [0,1]

动画状态的名称最好与引用的动画片段名称保持一致

javascript
// sample:
animator.play("idle", -1, 0);

getParamIndex

javascript
public void getParamIndex( string paramName );

根据参数名称获取参数的 Index。

Parameters

  • paramName : string 参数名称

getBool

javascript
public boolean getBool( number index );

获取 boolean 类型的参数。

Parameters

  • index : number 参数的 Index

setBool

javascript
public void setBool( number index, boolean value );

设置 boolean 类型的参数。

Parameters

  • index : number 参数的 Index
  • value : boolean 参数的值
javascript
// sample:
this.animator = this.gameobject.getComponent( "Animator" );
this.paramIndex = this.animator.getParamIndex("ExampleParam");
this.animator.setBool( this.paramIndex, true );

getFloat

javascript
public number getFloat( number index );

获取 Float 类型的参数。

Parameters

  • index : number 参数的 Index

setFloat

javascript
public void setFloat( number index, number value );

设置 Float 类型的参数。

Parameters

  • index : number 参数的 Index
  • value : number 参数的值

getInteger

javascript
public number getInteger( number index );

获取 Integer 类型的参数。

Parameters

  • index : number 参数的 Index

setInteger

javascript
public void setInteger( number index, number value );

设置 Integer 类型的参数。

Parameters

  • index : number 参数的 Index
  • value : number 参数的值

setTrigger

javascript
public void setTrigger( number index );
public void setTrigger( string name );

设置 Integer 类型的参数。

Parameters

  • index : number 参数的 Index
  • name : string 参数的名称

Inherited Properties(继承自 Component)


enabled

type : boolean

该组件是否是可用的。

gameObject

type : Insight.GameObject

(只读)该组件所依附的 GameObject。

isActiveAndEnabled

type : boolean

(只读)该组件是否可用,且其依附的 GameObject 是否是活跃状态。

name

type : string

(只读)所依附的 GameObject 的名称。

tag

type : string

(只读)所依附的 GameObject 的 Tag。

⚠️ 暂时未启用

transform

type : Insight.Transform

(只读)所依附的 GameObject 的 transform。