SerializedProperty Extensions
Запись значений и доступ к полям C# через SerializedProperty.
Быстрый старт
| До — Unity API | После — FastTools |
|---|---|
| |
Запись значений
| Вызов | Что делает |
|---|---|
SetInt(42) | Записывает значение |
SetIntAndApply(42) | Записывает и применяет изменения |
SetIntAndApplyWithoutUndo(42) | Записывает и применяет изменения без Undo |
Перегрузки SetValue выбирают сеттер по типу аргумента: SetValue(42) вызывает SetInt. Тип аргумента должен совпадать с типом поля. Целые типы меньше int, а также char, тоже вызывают SetInt. Полный список сеттеров — в справочнике API.
Перечисления, массивы и ссылки
| Unity | FastTools |
|---|---|
intValue = (int)Rarity.Rare | SetEnum(Rarity.Rare) |
enumValueIndex = 1 | SetEnumIndex(1) |
enumValueFlag = flags | SetEnumFlag(flags) |
arraySize = 5 | SetArraySize(5) |
arraySize++ | AddArraySize() |
arraySize-- | RemoveArraySize() |
managedReferenceValue = value | SetManagedReference(value) |
objectReferenceValue = value | SetObjectReference(value) |
boxedValue = value | SetBoxed(value) |
exposedReferenceValue = value | SetExposedReference(value) |
- У
SetEnumIndexиSetEnumFlagнет формыSetValue: вызывайте их по имени. SetValue(1)для поля-перечисления вызываетSetInt: записывается значение 1, а не индекс.- Значение перечисления записывают
SetEnumиSetValue(Rarity.Rare).
С контекстом IExposedPropertyTable, например PlayableDirector, SetExposedReference() сразу кладёт ссылку в таблицу, но новое имя остаётся неприменённым. Вызовите после него ApplyModifiedProperties(): иначе очередное обновление или перезагрузка домена сбросят имя, и запись в таблице останется без владельца.
Update() и Apply…()
Методы вызываются на свойстве и, как сеттеры, возвращают его для цепочек вызовов.
| Unity | FastTools |
|---|---|
serializedObject.Update() | Update() |
serializedObject.UpdateIfRequiredOrScript() | UpdateIfRequiredOrScript() |
serializedObject.ApplyModifiedProperties() | ApplyModifiedProperties() |
serializedObject.ApplyModifiedPropertiesWithoutUndo() | ApplyModifiedPropertiesWithoutUndo() |
Доступ к полю C#
Методы возвращают тип поля, его FieldInfo и объект-владелец.
public class AbilityBook : MonoBehaviour
{
[SerializeField]
private List<Ability> _abilities = new() { new Ability() };
[SerializeReference]
private IAbilityEffect _effect = new BurnEffect();
}
[Serializable]
public class Ability { public string Name = "Fireball"; }
[Serializable]
public class BurnEffect : IAbilityEffect { public float Damage = 5f; }
| Поле / элемент | GetPropertyType() | GetFieldInfo() | GetDeclaringInstance() |
|---|---|---|---|
_abilities | List<Ability> | AbilityBook._abilities | экземпляр AbilityBook |
_abilities[0] | Ability | AbilityBook._abilities | экземпляр AbilityBook |
_abilities[0].Name | string | Ability.Name | Ability с индексом 0 |
_effect | IAbilityEffect | AbilityBook._effect | экземпляр AbilityBook |
_effect.Damage | float | BurnEffect.Damage | экземпляр BurnEffect |
- если поле не найдено,
GetPropertyType()иGetFieldInfo()возвращаютnull, аGetDeclaringInstance()— только когда не найден объект-владелец; - методы читают только первый целевой объект и только применённые значения.
Если владелец поля — структура, GetDeclaringInstance() возвращает её boxed-копию. Изменения такой копии не попадают в оригинал; записывайте значения через SerializedProperty.
Имя поля и проверки для отрисовки
| Поле / элемент | GetMemberName() | IsArrayElement() | HasFoldout() |
|---|---|---|---|
_abilities[0] | "_abilities" | true | true |
_abilities[0].Name | "Name" | false | false |
_effect | "_effect" | false | false |
HasFoldout() проверяет обычные составные поля с видимыми вложенными полями. Не учитывает [SerializeReference] и пользовательские PropertyDrawer.
Persistent()
Persistent() возвращает копию свойства на собственном SerializedObject: её можно использовать позже, например в EditorApplication.delayCall.
- копия принадлежит вызывающему коду: освободите её вместе с её
serializedObject; - неприменённые записи исходного свойства в копию не попадают;
- если свойства на объектах нет, метод возвращает
null.
var independent = manaCost.Persistent();
if (independent == null) return;
EditorApplication.delayCall += () =>
{
using (independent.serializedObject)
using (independent)
independent.Update().SetIntAndApply(42);
};
Пример в пакете
В EditorTools кнопка Reset to defaults записывает два свойства через SetFloat и SetIntAndApply.

