本文介绍了Unity如何在退出运行模式后,保存对组件参数的数据修改。
之前因为策划有在Game运行模式时动态修改脚本参数,在退出Playmode后脚本参数保存的需求,用于在场景中动态地调整参数。研究了一下之前老外实现的一个插件PlayModePersist,也就是一个在运行模式下进行保存数据的插件。
PlayModePersist 这款插件不知道什么原因已经从Appstore下架了。有需要的同学可以自行下载。
通过阅读这款插件的源码,学到了两个比较有趣的实现:
1. 通过反射获取所有应用类,做成编辑器以供筛选。
2. 退出Playmode后,保存修改过的数据。
今天讨论的就是No.2的实现方式
实现的核心还是通过反射。
通过脚本控制添加所需要修改的组
件列表,在 EditorApplication.playmodeStateChanged 类似于OnApplicationQuit 的时候把保存的数据提交修改。
我发现以前写云笔记的时候还是比较轻松,毕竟只是写给自己看,写博客的时候要让读者读懂,说清楚思路还是好难。
不废话了,先上代码
using System.Collections.Generic;
using UnityEngine;
using UnityEditor;
using System.Reflection;
using System;
public class PlayModeEditHelper {
private static PlayModeEditHelper _instance;
public static PlayModeEditHelper Instance
{
get
{
if (_instance == null)
_instance = new PlayModeEditHelper();
return _instance;
}
}
//在构造函数中 注册修改事件
public PlayModeEditHelper()
{
EditorApplication.playmodeStateChanged = Application_PlaymodeStateChanged;
SavingDatas = new Dictionary<int, SettingData>();
}
List<Component> SavingGroups = new List<Component>(); //需要保存的组件列表
List<int> SavingIDs = new List<int>(); //需要保存组件的InstanceID列表
Dictionary<int, SettingData> SavingDatas; //缓存数据字典
void Application_PlaymodeStateChanged()
{
if (EditorApplication.isPlaying || EditorApplication.isPaused)
{
//window repaint or do sth...
}
else
{
RestoreAllSavingSetting();
EditorApplication.playmodeStateChanged = null;
}
}
//还原所有修改数据
void RestoreAllSavingSetting()
{
for (int i = 0; i < SavingIDs.Count; i++)
{
RestoreSetting(SavingIDs[i]);
}
}
//通过实例ID修改组件参数
void RestoreSetting(int id)
{
Component ComponentObject = EditorUtility.InstanceIDToObject(id) as Component;
Dictionary<string, object> values = SavingDatas[id].values;
foreach (string name in values.Keys)
{
object newValue = values[name];
PropertyInfo property = ComponentObject.GetType().GetProperty(name);
if (null != property)
{
object currentValue = property.GetValue(ComponentObject, null);
property.SetValue(ComponentObject, newValue, null);
}
else
{
FieldInfo field = ComponentObject.GetType().GetField(name, BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Public);
object currentValue = field.GetValue(ComponentObject);
field.SetValue(ComponentObject, newValue);
}
}
if (ComponentObject != null)
{
SetPrefabDirty(ComponentObject);
}
}
//如果是预设体,通知引擎修改 不能省略,修正了修改目标是预设体时,每次运行参数重置的bug
void SetPrefabDirty(Component ComponentObject)
{
PrefabType prefabType = PrefabUtility.GetPrefabType(ComponentObject.gameObject);
if (prefabType == PrefabType.DisconnectedPrefabInstance || prefabType == PrefabType.PrefabInstance)
{
EditorUtility.SetDirty(ComponentObject);
}
}
//缓存修改信息 包括属性、字段
public void SaveValues(Component ComponentObject)
{
if (SavingGroups.Contains(ComponentObject))
{
RefreshValues(ComponentObject);
return;
}
Dictionary<string, object> values = new Dictionary<string, object>();
List<PropertyInfo> properties = GetProperties(ComponentObject);
List<FieldInfo> fields = GetFields(ComponentObject);
foreach (PropertyInfo property in properties)
{
values.Add(property.Name, property.GetValue(ComponentObject, null));
}
foreach (FieldInfo field in fields)
{
values.Add(field.Name, field.GetValue(ComponentObject));
}
//添加需要保存的组件
SavingGroups.Add(ComponentObject);
SavingIDs.Add(ComponentObject.GetInstanceID());
SavingDatas.Add(ComponentObject.GetInstanceID(), new SettingData(values));
}
//修正多次点击修改不能更新数据的bug
private void RefreshValues(Component ComponentObject)
{
Dictionary<string, object> values = SavingDatas[ComponentObject.GetInstanceID()].values;
List<PropertyInfo> properties = GetProperties(ComponentObject);
List<FieldInfo> fields = GetFields(ComponentObject);
foreach (PropertyInfo property in properties)
{
values[property.Name] = property.GetValue(ComponentObject, null);
}
foreach (FieldInfo field in fields)
{
values[field.Name] = field.GetValue(ComponentObject);
}
}
//获取私有字段+公有字段列表
private List<FieldInfo> GetFields(Component ComponentObject)
{
List<FieldInfo> fields = new List<FieldInfo>();
//获取字段包括私有字段、共有字段 修正了私有字段不能正常修改的bug
FieldInfo[] infos = ComponentObject.GetType().GetFields(BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Public);
//foreach (FieldInfo fieldInfo in ComponentObject.GetType().GetFields())
foreach (FieldInfo fieldInfo in infos)
{
if (!Attribute.IsDefined(fieldInfo, typeof(HideInInspector)))
{
fields.Add(fieldInfo);
}
}
return fields;
}
//获取属性列表
private List<PropertyInfo> GetProperties(Component ComponentObject)
{
List<PropertyInfo> properties = new List<PropertyInfo>();
foreach (PropertyInfo propertyInfo in ComponentObject.GetType().GetProperties())
{
if (!Attribute.IsDefined(propertyInfo, typeof(HideInInspector)))
{
MethodInfo setMethod = propertyInfo.GetSetMethod();
if (null != setMethod && setMethod.IsPublic)
{
properties.Add(propertyInfo);
}
}
}
return properties;
}
}
//简易的设置数据 自行根据需求扩充
public class SettingData
{
public Dictionary<string, object> values;
public SettingData(Dictionary<string, object> datas)
{
values = datas;
}
public void AddData(string name, object value)
{
if (!values.ContainsKey(name))
{
values.Add(name, value);
}
}
}
其中测试脚本如下:
using UnityEngine;
public class TestEditParam : MonoBehaviour {
public enum ENUM_TEST
{
ENUM1,
ENUM2,
ENUM3
}
public int mIntValue; //测试整形字段
public float mFloatValue; //测试Float型字段
public Vector3 mVector3Value; //测试Vector型字段
public string mStringValue; //测试String型字段
public ENUM_TEST mEnumType; //测试自定义枚举型字段
//测试私有字段
[SerializeField]
private int mPrivateIntValue;
[SerializeField]
private float mPrivateFloatValue;
}
测试Editor脚本:置于Editor文件夹下
using UnityEngine;
using UnityEditor;
[CustomEditor(typeof(TestEditParam), true)]
public class TestEditParamEditor : Editor {
public override void OnInspectorGUI()
{
base.OnInspectorGUI();
GUILayout.Space(10);
if (GUILayout.Button("Save"))
{
SaveParam();
}
}
//将TestEditParam 和 Transform 注册到修改队列
void SaveParam()
{
//将target(即Editor脚本的目标组件TestEditParam)注册到修改队列
Component mTarget = target as Component;
PlayModeEditHelper.Instance.SaveValues(mTarget);
//将Transform 注册到修改队列
Transform rectCom = mTarget.transform.GetComponent<Transform>();
PlayModeEditHelper.Instance.SaveValues(rectCom);
//ApplyParam();
}
//提交预设体修改 直接保存prefab的暴力方法 只需更改prefab时直接用此接口即可
void ApplyParam()
{
Object prefabParent = PrefabUtility.GetPrefabParent(target);
TestEditParam mScript = target as TestEditParam;
PrefabUtility.ReplacePrefab(mScript.gameObject, prefabParent);
}
}
使用方法
很简单,在Editor脚本的按钮事件中添加需要修改的组件mTarget 即可
PlayModeEditHelper.Instance.SaveValues(mTarget);
支持添加多个组件,支持多次保存更新
其实prefab在保存时就是一系列序列化信息。可以通过文本工具查看,如:
主要实现的思路就是,通过反射方法,把Component的 属性(PropertyInfo),和字段(FieldInfo)缓存下来。在结束运行模式后,系统首先会把组件数值还原。然后调用Application_PlaymodeStateChanged 方法,在系统默认还原后重新通过InstanceID获取组件,并对其字段属性的数值进行覆盖。
由于这个时序性,具体应用时会直观地看到一个数值跳动的过程。
接下来我们具体看一下 测试脚本中 PropertyInfo 和FieldInfo具体包含的信息
PropertyInfo :
FieldInfo:
我们测试时用到的是字段值,而工作中也经常会用到属性索引器等等。所以都需要处理。
我们可以看到在PropertyInfo 中有些无用的基类的属性比如tag值,hideflag等。
这些在插件源码中单独处理成了一个IgnoreList 忽略列表,但是代码基类千变万化,出于简化代码的目的(不想人力维护这个列表),而且插件中的属性有多余的情况,比如包含了Transform类的基础属性等等,最终没有定义这个筛选列表。如果有需要可以参照插件源码。
这里在获取所有字段中用到了反射的筛选条件,支持了获取私有字段
ComponentObject.GetType().GetFields(BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Public);
具体反射类可自行查阅相关文章,这里不做详细说明。
在playmodeStateChanged 状态切换后,检查状态如果是退出playmode时,调用脚本的保存修改方法。
通过property.SetValue,field.SetValue设置参数。
这里需要说明的是,如果修改的目标被设置成prefab(通常都是这样),要通过EditorUtility.SetDirty(ComponentObject)方法在Editor中将其标记为脏(变化过的)才能保存修改。否则会出现退出时虽然属性被修改,但是下一次运行时,系统会自动还原成prefab的参数。
如果大家不明白最好的方法就是断点走一遍。呃。程序猿们最简单的上手方法。
补充:
1. 之前只支持了单组件的保存。后来发现实际过程中可能会想保存Transform的属性等等,所以添加了对多个组件保存的支持。为了不影响之前的代码结构
维护了一个Dictionary<int, SettingData> SavingDatas; //缓存数据字典
临时添加SavingDatas用作处理缓存数据,方法也比较粗暴。大家用到时可以扩充数据类型,优化查找方法。
2. 还是写了这篇文章自己测试后发现,多次Save只能保存第一次的数据。忘了Save也应该有更新数据的功能,所以添加了RefreshValues的方法。也很粗暴,直接进行的所有数据全更新。请同学们自行修改优化。
3. 本文描述时比较啰嗦,主要是想简单记录一下实现时遇到的坑。
4. 在测试Editor脚本中有个方法。其实是脚本做提交预设体修改的方法。即:
Object prefabParent = PrefabUtility.GetPrefabParent(target);
TestEditParam mScript = target as TestEditParam;
PrefabUtility.ReplacePrefab(mScript.gameObject, prefabParent);
如果仅是保存prefab需求直接应用即可
由于这是个辅助脚本,用于配合企划的修改需求。不会在正常的项目中实际运行到。所以代码并不优雅,只是给同学们一个思路,也许有更佳的方法
有建议和想法的还望不吝赐教~谢谢