代码生成AnimatorController

Posted 2020-08-19 一个懒人的Blog

0.出发点
现在的项目需要设置多套动画组合，全部是由策划在XML文件中设置完成，如果完全的手动在AnimatorController中去做不但工作量大而且如果将来有配置修改了还要一个个去找到对应的自状态机并且修改。因此就萌生了用代码去生成状态机的想法，而且在网上也有了很多的教程可以参考，只是每个项目都不同，且对于一些参数和属性的设置也不尽相同，因此还是把自己的代码进行一些修改后分享出来，基本上应该是包含了状态机常用的功能。

1.数据来源

一个典型的XML文件

<?xml version="1.0" encoding="ISO-8859-1"?>
<config>
    <datas>
        <data INDEX="1" Clip1="jump" Clip1Count="1" Clip2="BackLeap" Clip2Count="2" Clip3="die" Clip3Count="1"></data>
        <data INDEX="2" Clip1="BackLeap" Clip1Count="3" Clip2="jump" Clip2Count="0" Clip3="jump" Clip3Count="0"></data>
        <data INDEX="3" Clip1="BackLeap" Clip1Count="1" Clip2="ForwardLeap" Clip2Count="1" Clip3="jump" Clip3Count="1"></data>
    </datas>
</config>            

2.动画控制器中的主要元素 

2.1 Unity中editor的功能十分的强大，能够加载项目中的各种资源，而AnimatorController就是其中之一。

2.2 一个AnimatorController的结构基本如下:

2.3 一些说明：

- AnimatorControllerLayer：一个AnimatorController由多个Layer组成，但是除了BaseLayer外其它的Layer并不主要负责动画逻辑，而是多用于动画遮罩。

- AnimatorControllerParameter：顾名思义是状态机中使用的参数，这个参数可以在不同的Layer和子状态机中使用。在代码添加参数时会选择参数类型，它是个枚举`AnimatorControllerParameterType`。

- AnimatorStateMachine：动画状态机，核心逻辑实线层。在一个状态机中可以有多个state，也可以有多个Sub AnimatorStateMachine。通过AddStateMachine方法来生成并添加子状态机。

- AnimatorState：动画状态，也是这个系统中的基础单元。其可以设定各种属性，比较常用的是AnimationClip和Speed等。

- AnimatorStateTransition：也就是动画转换，其中可以设定触发参数，而且其中还有一个很重要的东西就是动画过度的设定。

 

3.完整代码

  1 using UnityEngine;
  2 using System.Collections;
  3 using UnityEditor;
  4 using System;
  5 using UnityEditor.Animations;
  6 using System.IO;
  7 using System.Xml;
  8 using System.Text.RegularExpressions;
  9 using System.Xml.Serialization;
 10 using System.Collections.Generic;
 11 using System.Linq;
 12 
 13 //[CustomEditor(typeof(EditorTools))]
 14 public class EditorTools : MonoBehaviour
 15 {
 16     #region 创建动画控制器
 17 
 18     /// <summary>
 19     ///  记录上一个state，用于自状态机中
 20     /// </summary>
 21     static AnimatorState lastAnimatorState = null;
 22     static string ParameterName;
 23     // 动画片段
 24     static AnimationClip die;
 25     static AnimationClip jump;
 26     static AnimationClip BackLeap;
 27     static AnimationClip ForwardLeap;
 28     /// <summary>
 29     /// base layer AnimatorStateMachine
 30     /// </summary>
 31     static AnimatorStateMachine mainASM;
 32     static int stateHeight = 100;
 33     static int stateWidth = 220;
 34 
 35     /// <summary>
 36     /// 根据配置文件创建特技组
 37     /// </summary>
 38     [MenuItem ("Tools/CreateAnimatorState")]
 39     static void CreateAnimatorState ()
 40     {
 41         // 获取动画片段
 42         List<object> allAssets = new List<object> (AssetDatabase.LoadAllAssetsAtPath ("Assets/Charactors/player2.FBX"));
 43         var animationClips = allAssets.Where (o => o.GetType () == typeof(AnimationClip)).ToList ();
 44         foreach (var item in animationClips) {
 45             AnimationClip x = item as AnimationClip;
 46             switch (x.name) {
 47             case "die":
 48                 die = x;
 49                 break;
 50             case "jump":
 51                 jump = x;
 52                 break;
 53             case "BackLeap":
 54                 BackLeap = x;
 55                 break;
 56             case "ForwardLeap":
 57                 ForwardLeap = x;
 58                 break;
 59             default:
 60                 break;
 61             }
 62         }
 63 
 64         // 当每个动画是一个单独的FBX文件中时可以用下面的方法来获取
 65         //die = AssetDatabase.LoadAssetAtPath ("Assets/Charactors/player2.FBX", typeof(AnimationClip)) as AnimationClip;
 66 
 67 
 68         // 获取状态机
 69         AnimatorController animatorController = AssetDatabase.LoadAssetAtPath ("Assets/AnimatorController/demo.controller", typeof(AnimatorController)) as AnimatorController;
 70         AnimatorControllerLayer layer = animatorController.layers [0];
 71         mainASM = layer.stateMachine;
 72 
 73         // 获取当前所有的参数
 74         AnimatorControllerParameter[] paras = animatorController.parameters;
 75         List<AnimatorControllerParameter> listParas = new List<AnimatorControllerParameter> (paras);
 76 
 77         // 删除指定的参数
 78         var acps = listParas.Where (p => p.name.Contains ("GroupParameter")).ToArray ();
 79         foreach (AnimatorControllerParameter item in acps) {
 80             animatorController.RemoveParameter (item);
 81         }
 82 
 83         // 删除指定的子状态机
 84         ChildAnimatorStateMachine[] childASM = mainASM.stateMachines;
 85         List<ChildAnimatorStateMachine> listCASM = new List<ChildAnimatorStateMachine> (childASM);
 86         var casms = listCASM.Where (c => c.stateMachine.name.Contains ("Group")).ToArray ();
 87         foreach (ChildAnimatorStateMachine item in casms) {
 88             mainASM.RemoveStateMachine (item.stateMachine);
 89         }
 90 
 91         // 读配置文件
 92         XmlConfig xc = ReadXml ();
 93 
 94         Vector3 startPos = mainASM.anyStatePosition;
 95 
 96 
 97         // 根据配置创建自状态机
 98         for (int index = 0; index < xc.datas.Count; index++) {
 99             Data data = xc.datas [index];
100 
101             // 设置特技参数，
102             ParameterName = "GroupParameter" + data.INDEX.ToString ();
103             animatorController.AddParameter (ParameterName, AnimatorControllerParameterType.Trigger);
104 
105             // 创建子状态机
106             AnimatorStateMachine sub = AddSubStateMachine<AnimatorEvent> ("Group_" + data.INDEX, ParameterName, mainASM, startPos + new Vector3 (stateWidth * index, -stateHeight, 0));
107             // 创建子状态机中的state
108             SetStateInSubMachine (sub, data);
109             lastAnimatorState = null;
110         }
111     }
112 
113     /// <summary>
114     ///  创建sub state machine用于放置特效组中的动画
115     /// </summary>
116     /// <typeparam name="T"></typeparam>
117     /// <param name="stateName"></param>
118     /// <param name="sm"></param>
119     /// <param name="position"></param>
120     /// <param name="data"></param>
121     /// <returns></returns>
122     private static AnimatorStateMachine AddSubStateMachine<T> (string stateName, string para, AnimatorStateMachine sm, Vector3 position) where T : StateMachineBehaviour
123     {
124         AnimatorStateMachine sub = sm.AddStateMachine (stateName, position);
125         sub.AddStateMachineBehaviour<T> ();
126         AnimatorStateTransition transition = mainASM.defaultState.AddTransition (sub, false);
127         transition.AddCondition (AnimatorConditionMode.If, 0, para);
128         return sub;
129     }
130 
131     /// <summary>
132     ///  根据配置数据在子状态机中创建state
133     /// </summary>
134     /// <typeparam name="T"></typeparam>
135     /// <param name="subSM"></param>
136     /// <param name="data"></param>
137     private static void SetStateInSubMachine (AnimatorStateMachine subSM, Data data)
138     {
139         AnimatorState newState;
140         string stateName;
141         Vector3 pos;
142         List<AnimationClip> acArray = new List<AnimationClip> ();
143         SetAnimationClip (data.Clip1, data.Clip1Count, ref acArray);
144         SetAnimationClip (data.Clip2, data.Clip2Count, ref acArray);
145         SetAnimationClip (data.Clip3, data.Clip3Count, ref acArray);
146 
147         for (int x = 1; x <= acArray.Count; x++) {
148             stateName = "GroupState_" + data.INDEX + "_" + x.ToString ();
149             pos = subSM.entryPosition + new Vector3 (stateWidth, -stateHeight * x, 0);
150             newState = AddState (stateName, subSM, pos, acArray [x - 1], x, acArray.Count);
151             lastAnimatorState = newState;
152         }
153     }
154 
155     static void SetAnimationClip (string clipName, int count, ref List<AnimationClip> acArray)
156     {
157         for (int i = 0; i < count; i++) {
158             if (clipName == die.name) {
159                 acArray.Add (die);
160             }
161             if (clipName == jump.name) {
162                 acArray.Add (jump);
163             }
164             if (clipName == BackLeap.name) {
165                 acArray.Add (BackLeap);
166             }
167             if (clipName == ForwardLeap.name) {
168                 acArray.Add (ForwardLeap);
169             }
170         }
171     }
172 
173     static AnimatorState AddState<T> (string stateName, AnimatorStateMachine sm, float threshold, string parameter, Vector3 position,
174                                       AnimationClip clip, bool first = false, bool last = false) where T : StateMachineBehaviour
175     {
176         AnimatorStateTransition animatorStateTransition;
177         //  生成AnimatorState
178         AnimatorState animatorState = sm.AddState (stateName, position);
179         // 设置动画片段
180         animatorState.motion = clip;
181         // 创建AnimatorStateTransition
182         // entry连接到特技组的第一个动画
183         if (first) {
184             animatorStateTransition = sm.AddAnyStateTransition (animatorState);
185             animatorStateTransition.AddCondition (AnimatorConditionMode.Equals, threshold, parameter);
186         }
187         // 最后一个动画连接到stand
188         if (last) {
189             animatorStateTransition = animatorState.AddTransition (mainASM.defaultState);
190         }
191 
192         // 特技组内的连接创建
193         if (!first && !last) {
194             animatorStateTransition = animatorState.AddTransition (mainASM.defaultState);
195         }
196 
197         animatorStateTransition = lastAnimatorState.AddTransition (animatorState, true);
198 
199         //AnimatorStateTransition 的设置
200         animatorStateTransition.canTransitionToSelf = false;
201         animatorState.AddStateMachineBehaviour<T> ();
202         return animatorState;
203     }
204 
205     static AnimatorState AddState (string stateName, AnimatorStateMachine sm, Vector3 position, AnimationClip clip, int index, int count)
206     {
207         AnimatorStateTransition animatorStateTransition = null;
208         //  生成AnimatorState
209         AnimatorState animatorState = sm.AddState (stateName, position);
210         // 设置动画片段
211         animatorState.motion = clip;
212         // 创建AnimatorStateTransition
213         // AnyState连接到特技组的第一个动画
214         if (index == 1) {
215             //animatorStateTransition = sm.AddAnyStateTransition(animatorState);
216             //animatorStateTransition.canTransitionToSelf = false;
217         }
218         // 最后一个动画连接到main animator machine的default state
219         if (index == count) {
220             animatorStateTransition = animatorState.AddTransition (mainASM.defaultState);
221             animatorStateTransition.hasExitTime = true;
222         }
223 
224         // 特技组内的连接创建
225         if (lastAnimatorState != null) {
226             animatorStateTransition = lastAnimatorState.AddTransition (animatorState, true);
227         }
228 
229         return animatorState;
230     }
231 
232     #endregion
233 
234     #region public method
235 
236     static XmlConfig ReadXml ()
237     {
238         //string xmlStr = File.ReadAllText(Application.dataPath.ToString() + "/StreamingAssets/XMLConfigFiles/Stunt.xml");
239         //Debug.Log(xmlStr);
240         //string objTxt = Regex.Replace(xmlStr, @"<!--[^-]*-->", string.Empty, RegexOptions.IgnoreCase);
241         //Debug.Log(objTxt);
242         return DeserializeFromXml<XmlConfig> (Application.dataPath.ToString () + "/StreamingAssets/XMLConfigFiles/data.xml");
243     }
244 
245     /// <summary>
246     /// 从某一XML文件反序列化到某一类型
247     /// </summary>
248     /// <param name="filePath">待反序列化的XML文件名称</param>
249     /// <param name="type">反序列化出的</param>
250     /// <returns></returns>
251     public static T DeserializeFromXml<T> (string filePath)
252     {
253         try {
254             if (!System.IO.File.Exists (filePath))
255                 throw new ArgumentNullException (filePath + " not Exists");
256 
257             using (System.IO.StreamReader reader = new System.IO.StreamReader (filePath)) {
258                 System.Xml.Serialization.XmlSerializer xs = new System.Xml.Serialization.XmlSerializer (typeof(T));
259                 T ret = (T)xs.Deserialize (reader);
260                 return ret;
261             }
262         }
263         catch (Exception ex) {
264             return default(T);
265         }
266     }
267 
268     #endregion
269 }
270 
271 
272 #region 序列化需要的model
273 [XmlType (TypeName = "config")]
274 public class XmlConfig
275 {
276     [XmlArray ("datas")]
277     public List<Data> datas { get; set; }
278 }
279 
280 [XmlType (TypeName = "data")]
281 public class Data
282 {
283     [XmlAttribute]
284     public int INDEX;
285     [XmlAttribute]
286     public string Clip1;
287     [XmlAttribute]
288     public int Clip1Count;
289     [XmlAttribute]
290     public string Clip2;
291     [XmlAttribute]
292     public int Clip2Count;
293     [XmlAttribute]
294     public string Clip3;
295     [XmlAttribute]
296     public int Clip3Count;
297 }
298 
299 #endregion

 

4.最后的说明

- 其实整个过程基本就是读取XML文件内容，然后按照第二部分中描述的结构来一点一点构建状态机。

- 在设定具体属性时需要按照具体情况来做。

- 有个天坑，就是如果在Base Layer界面多次点击CreateAnimatorState按钮时会出现Unity的crash，或者出现界面所有元素消失并报错。我找了很多资料应该是UnityEditor的bug。有一个很简单的解决办法，就是创建一个新的Layer，切换到新Layer的界面，然后点击CreateAnimatorState按钮，再切回Base Layer，这样就不会出错了。