参考
SerializedObject类
官方API：
https://docs.unity3d.com/cn/2019.4/ScriptReference/SerializedProperty.html
https://docs.unity3d.com/cn/2019.4/ScriptReference/SerializedObject.html
[Unity3D]清理material中无用的的property
Unity插件开发:SerializedObject/SerializedProperty——查找引用的资源
先看一下官方的小例子
using UnityEngine;
using UnityEditor;
public class MyObject : ScriptableObject
{
public int myInt = 42;
}
public class SerializedPropertyTest : MonoBehaviour
{
void Start()
{
MyObject obj = ScriptableObject.CreateInstance<MyObject>();
SerializedObject serializedObject = new UnityEditor.SerializedObject(obj);
SerializedProperty serializedPropertyMyInt = serializedObject.FindProperty("myInt");
Debug.Log("myInt " + serializedPropertyMyInt.intValue);
}
}
一、SerializedObject
| 公共函数 | |
|---|---|
| ApplyModifiedProperties | 应用属性修改。 |
| ApplyModifiedPropertiesWithoutUndo | 在不注册撤销操作的情况下应用属性修改。 |
| CopyFromSerializedProperty | 将 SerializedProperty 中的值复制到序列化对象上的相应序列化属性。 |
| CopyFromSerializedPropertyIfDifferent | 将 SerializedProperty 中的更改值复制到序列化对象上的相应序列化属性。 |
| FindProperty | 按名称查找序列化属性。 |
| GetIterator | 获取第一个序列化属性。 |
| SetIsDifferentCacheDirty | 在下一次进行 /Update()/ 调用时更新 hasMultipleDifferentValues 缓存。 |
| Update | 更新序列化对象的表示形式。 |
| UpdateIfRequiredOrScript | 更新序列化对象的表示形式（仅当自上次调用 Update 后对象发生修改或者它是脚本时才进行更新）。 |
1.FindProperty
public SerializedProperty FindProperty(string propertyPath);
可以通过在属性面板上的相应变量上使用shift+右键可log路径名；（侧重于查找指定属性）
using UnityEditor;
using UnityEngine;
public class EditorMyTool
{
[MenuItem("MyTool/SerializedTest")]
private static void SerializedTest()
{
GameObject selectedObject = Selection.activeObject as GameObject;
if (selectedObject != null)
{
Debug.Log(selectedObject.name + ":" + selectedObject.GetType().Name);
var t = selectedObject.GetComponent<Transform>();
var so = new SerializedObject(t);
var pop = so.GetIterator();
while (pop.NextVisible(true))
{
Debug.Log(pop.propertyPath);
}
}
}
}
image.png
可以看到打印的propertyPath都是以"m_"开头，现在使用shift+右键看一下：
image.png
可以来测试一下：
[MenuItem("MyTool/SerializedTest")]
private static void SerializedTest()
{
GameObject selectedObject = Selection.activeObject as GameObject;
if (selectedObject != null)
{
Debug.Log(selectedObject.name + ":" + selectedObject.GetType().Name);
var t = selectedObject.GetComponent<Transform>();
var so = new SerializedObject(t);
var pop = so.GetIterator();
while (pop.NextVisible(true))
{
Debug.Log(pop.propertyPath);
}
var x = so.FindProperty("m_LocalPosition.x");
Debug.Log("local x:" + x.floatValue);
}
}
image.png
类似的，如果shift+右键看的是Position属性，则返回的是m_LocalPosition，可以测试一下：
var x = so.FindProperty("m_LocalPosition.x");
var localP = so.FindProperty("m_LocalPosition");
Debug.Log("local x:" + x.floatValue);
Debug.Log(localP.vector3Value.ToString());
测试结果：
(2.0, 0.0, 0.0)
UnityEngine.Debug:Log(Object)
如果我们将测试的这个SphereTest做成prefab，然后用文本编辑器打开，也能看到具体的属性：
%YAML 1.1
%TAG !u! tag:unity3d.com,2011:
--- !u!1 &690590170462336008
GameObject:
m_ObjectHideFlags: 0
m_CorrespondingSourceObject: {fileID: 0}
m_PrefabInstance: {fileID: 0}
m_PrefabAsset: {fileID: 0}
serializedVersion: 6
m_Component:
- component: {fileID: 690590170462336012}
- component: {fileID: 690590170462336013}
- component: {fileID: 690590170462336010}
- component: {fileID: 690590170462336011}
m_Layer: 0
m_Name: SphereTest
m_TagString: Untagged
m_Icon: {fileID: 0}
m_NavMeshLayer: 0
m_StaticEditorFlags: 0
m_IsActive: 1
--- !u!4 &690590170462336012
Transform:
m_ObjectHideFlags: 0
m_CorrespondingSourceObject: {fileID: 0}
m_PrefabInstance: {fileID: 0}
m_PrefabAsset: {fileID: 0}
m_GameObject: {fileID: 690590170462336008}
m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
m_LocalPosition: {x: 2, y: 0, z: 0}
m_LocalScale: {x: 1, y: 1, z: 1}
2.GetIterator
获取这个SerializedObject上的初始SerializedProperty。用这个SerializedProperty可以逐个列举出下一个SerializedProperty
二、SerializedProperty
1.SerializedPropertyType
比如
var prop = obj.GetIterator();
while (prop.Next(true))
{
if (prop.propertyType == SerializedPropertyType.ObjectReference)
{
...
propertyType：字段的类型，比如是引用，数字，字符等等，见SerializedPropertyType。每一种Type对应的值的类型也是不一样
https://docs.unity3d.com/cn/2019.4/ScriptReference/SerializedPropertyType.html
三、SerializeField
https://docs.unity3d.com/cn/2019.4/ScriptReference/SerializeField.html
强制 Unity 对私有字段进行序列化。
当 Unity 对脚本进行序列化时，仅对公共字段进行序列化。 如果还需要 Unity 对私有字段进行序列化， 可以将 SerializeField 属性添加到这些字段。
Unity 将对所有脚本组件进行序列化，重新加载新程序集， 并从序列化的版本重新创建脚本组件。此 序列化是通过 Unity 内部序列化系统完成的；而不是通过 .NET 的序列化功能来完成。
四、官方文档示例一 同时编辑对象共享的序列化数据
在许多情况下，您可以创建工具来修改项目中的对象。例如，以下脚本示例可创建一个菜单项，该菜单项用于重置当前选定的所有游戏对象的本地位置。将其放在名为 Example1.cs 的文件中，然后将文件放在名为 Editor 的文件夹中：
using UnityEditor;
using UnityEngine;
static class Example1
{
[MenuItem("Edit/Reset Selected Objects Position (No Undo)")]
static void ResetPosition()
{
// this action will not be undoable
foreach (var go in Selection.gameObjects)
go.transform.localPosition = Vector3.zero;
}
}
虽然您可以从对象的 API 角度通过这种方式来编辑对象，但您还必须使用其他编辑器 API 来指定哪些组件已脏化，以便此操作可以撤消，并在下次保存场景时此操作被检测为更改，诸如此类。相反，使用 SerializedObject 会自动处理此过程。以下脚本示例与前一个示例效果相同，但也可以撤消，并作为场景中的更改进行跟踪。将其放在名为 Example2.cs 的文件中，然后将文件放在名为 Editor 的文件夹中：
using System.Linq;
using UnityEditor;
using UnityEngine;
static class Example2
{
[MenuItem("Edit/Reset Selected Objects Position")]
static void ResetPosition()
{
var transforms = Selection.gameObjects.Select(go => go.transform).ToArray();
var so = new SerializedObject(transforms);
// you can Shift+Right Click on property names in the Inspector to see their paths
so.FindProperty("m_LocalPosition").vector3Value = Vector3.zero;
so.ApplyModifiedProperties();
}
}
看到so.FindProperty("m_LocalPosition")，和上面的注释you can Shift+Right Click on property names in the Inspector to see their paths，是不是和上面的例子一样的操作手法。
SerializedObject 一次可打开一个或多个目标 Unity 对象的数据流，这允许您同时编辑对象共享的序列化数据。例如，如果您的数据流中有多个不同类型的行为，则这些行为的唯一共同属性可能是“m_Enabled”。
首次创建 SerializedObject 实例后，实例是最新的。对于在此数据流中访问的 SerializedProperty 进行的任何更改，必须最终通过 SerializedObject.ApplyModifiedProperties 方法来刷新。如果在多个帧中保留对 SerializedObject 实例的引用，则必须确保首先手动调用其 SerializedObject.Update 方法，然后再从此实例中读取任何数据，因为一个或多个目标对象可能已在其他位置修改过，例如在单独的 SerializedObject 流中。请注意，具有相同目标对象的两个不同的 SerializedObject 流彼此独立，如果在几个帧的过程中保持其中一个或多个流，则必须以这种方式手动同步这些流。
五、官方文档示例二 创建自定义编辑器时使用Editor类的serializedObject属性
其实这种用法在之前也有提到。
以下示例脚本定义的组件将使用正弦函数为对象的本地位置生成动画。将其放入名为 SineAnimation.cs 的脚本中：
using UnityEngine;
public class SineAnimation : MonoBehaviour
{
public Vector3 axis { get { return m_Axis; } set { m_Axis = value; } }
[SerializeField]
private Vector3 m_Axis = Vector3.up;
public float period { get { return m_Period; } set { m_Period = value; } }
[SerializeField]
private float m_Period = 1f / Mathf.PI;
public float amplitude { get { return m_Amplitude; } set { m_Amplitude = value; } }
[SerializeField]
private float m_Amplitude = 1f;
public float phaseShift { get { return m_PhaseShift; } set { m_PhaseShift = Mathf.Clamp01(value); } }
[SerializeField, Range(0f, 1f)]
private float m_PhaseShift;
void Update()
{
transform.localPosition = m_Axis * m_Amplitude * Mathf.Sin((Time.time + m_PhaseShift) / m_Period);
}
void OnValidate()
{
m_PhaseShift = Mathf.Clamp01(m_PhaseShift);
}
}
看看代码里的SerializeField标签，好像明白为啥之前的propertyPath都是"m_"开头了。
以下示例脚本为 SineAnimation 定义了一个自定义 Editor，用于在默认控件之后添加一个按钮来随机化正弦函数参数。将其放在名为 SineAnimationEditor.cs 的文件中，然后将文件放在名为 Editor 的文件夹中：
using UnityEditor;
using UnityEngine;
[CustomEditor(typeof(SineAnimation)), CanEditMultipleObjects]
public class SineAnimationEditor : Editor
{
public override void OnInspectorGUI()
{
base.OnInspectorGUI();
if (GUILayout.Button("Randomize Sine Function", EditorStyles.miniButton))
{
serializedObject.FindProperty("m_Period").floatValue = Random.Range(0f, 10f);
serializedObject.FindProperty("m_Amplitude").floatValue = Random.Range(0f, 10f);
serializedObject.FindProperty("m_PhaseShift").floatValue = Random.Range(0f, 1f);
serializedObject.ApplyModifiedProperties();
}
}
}
image.png
Editor 类有一个 serializedObject 属性，该属性为所有被检查目标（在本例中为 SineAnimation 组件）提供了一个流，从而更轻松地支持同时编辑多个对象。由于此 SerializedObject 实例在 Editor 实例的生命周期内持续存在，因此 OnInspectorGUI 的基本实现在绘制任何控件之前处理 Update 调用，并在任何用户交互之后处理调用 ApplyModifiedProperties 的调用。因此，在方法退出前，必须通过 ApplyModifiedProperties 来刷新按下此检视面板中添加的按钮时进行的所有修改，否则下次 Editor.OnInspectorGUI 的基本实现在 serializedObject 实例上调用 SerializedObject.Update 方法时，这些修改将丢失。
请注意，如果通过 SerializedObject.ApplyModifiedProperties 将数据刷新到 Unity 对象，那么将忽略您在与序列化字段关联的属性 setter 中可能具有的任何数据验证逻辑。在此示例中，“m_PhaseShift”字段的值在 phaseShift 属性 setter 和 UI 中被钳制在 0 到 1 之间（通过 RangeAttribute）。因为用户可以通过 SerializedProperty（以及通过编辑磁盘上的资源）访问“m_PhaseShift”，而不仅仅通过“phaseShift”API 或 UI，所以有必要在 MonoBehaviour.OnValidate 回调中将其钳制为有效范围，从而在加载 Unity 对象时清理数据。
另请注意，虽然 SerializedObject 设计为可处理多个目标，但 SerializedProperty 类（例如，floatValue、vector3Value）中的值 getter 属性对于多选操作并不友好。因此，如果为这些属性分配一个值，将影响所有目标，但如果从这些属性中读取一个值，则仅返回与列表中第一个目标关联的值。
https://docs.unity3d.com/cn/2019.4/ScriptReference/Editor-serializedObject.html
Editor.serializedObject
public SerializedObject serializedObject ;
描述 表示正在检查的一个或多个对象的 SerializedObject。
可在自定义编辑器的 OnInspectorGUI 函数中使用 serializedObject，如关于 Editor 类的页面中所述。
请勿在 OnSceneGUI 或 OnPreviewGUI 中使用 serializedObject。而是直接在这些回调函数中使用目标属性。
可以看出，上述例子通过[CustomEditor(typeof(SineAnimation)), CanEditMultipleObjects]指定了正在检查的目标是SineAnimation
网友评论