AnimationMixer - Verge3D 用户手册 - Soft8Soft
Description: 了解如何在使用 Verge3D 制作的交互式 3D 应用程序中使用 AnimationMixer

# AnimationMixer

动画混合器是用于场景中特定对象的动画的播放器。当场景中的多个对象独立动画时，每个对象都可以使用同一个动画混合器。
在使用手册的“下一步”章节中，“动画系统”一文对Verge3D动画系统中的不同元素作出了概述

## 构造函数

### AnimationMixer(rootObject : Object3D)

rootObject — 混合器播放的动画所属的对象

## 属性

### # .time : Number

全局的混合器时间(单位秒; 混合器创建的时刻记作0时刻)

### # .timeScale : Number

全局时间(mixer time)的比例因子
说明: 将混合器的时间比例设为0, 稍后再设置为1，可以暂停/取消暂停由该混合器控制的所有动作。

### # .setTime(timeInSeconds : Number) → AnimationMixer

设置全局混合器到一个给定的时间，并相应地更新动画。
当你需要在一个动画里跳转到一个精确的时间，该函数将是十分有用的。输入的参数将会被混合器的timeScale进行缩放。

## 方法

### # .clipAction(clip : AnimationClip, optionalRoot : Object3D) → AnimationAction

返回所传入的剪辑参数的AnimationAction, 根对象参数可选，默认值为混合器的默认根对象。第一个参数可以是动画剪辑(AnimationClip)对象或者动画剪辑的名称。
如果不存在符合传入的剪辑和根对象这两个参数的动作, 该方法将会创建一个。传入相同的参数多次调用将会返回同一个剪辑实例。

### # .existingAction(clip : AnimationClip, optionalRoot : Object3D) → AnimationAction

返回传入剪辑的已有AnimationAction, 根对象参数可选，默认值为混合器的默认根对象。
第一个参数可以是动画剪辑(AnimationClip)对象或者动画剪辑的名称。

### # .getRoot() → Object3D

返回混合器的根对象

### # .stopAllAction() → AnimationMixer

停用混合器上所有预定的动作

### # .update(deltaTimeInSeconds : Number) → AnimationMixer

推进混合器时间并更新动画
通常在渲染循环中完成, 传入按照混合器的时间比例(timeScale)缩放过的clock.getDelta

### # .uncacheClip(clip : AnimationClip) → null

释放剪辑的所有内存资源

### # .uncacheRoot(root : Object3D) → null

释放根对象的所有内存资源

### # .uncacheAction(clip : AnimationClip, optionalRoot : Object3D) → null

释放动作的所有内存资源

## 源码

src/animation/AnimationMixer.js