Editor

Описание

Базовый класс для наследования пользовательских редакторов. Используйте его для создания ваших собственных инспекторов и редакторов ваших объектов.

Рассмотрим скрипт MyPlayer с переменными для брони, повреждений и ссылкой на игровой объект оружия.

using UnityEngine;
using System.Collections;

// This is not an editor script.
public class MyPlayer : MonoBehaviour {
    public int armor = 75;
    public int damage = 25;
    public GameObject gun;

    void Update () {
	// Update logic here...
    }
}

Используя пользовательский редактор, может быть изменен внешний вид скрипта в окне Inspector, чтобы выглядеть, например, так:


Пользовательский редактор в окне Inspector.

Вы можете привязать редактор к пользовательскому компоненту, используя атрибут CustomEditor

Существует несколько способов проектирования пользовательских редакторов. Если вы хотите, чтобы редактор поддерживал изменение сразу нескольких объектов, вы можете использовать атрибут CanEditMultipleObjects. Вместо изменения переменных скрипта напрямую, выгодно использовать систему SerializedObject и SerializedProperty для их редактирования, так как это автоматически обрабатывает редактирование нескольких объектов, отмену и переопределение префабов.

using UnityEditor;
using UnityEngine;
using System.Collections;

// Custom Editor using SerializedProperties.
// Automatic handling of multi-object editing, undo, and prefab overrides.
[CustomEditor(typeof(MyPlayer))]
[CanEditMultipleObjects]
public class MyPlayerEditor : Editor {
	SerializedProperty damageProp;
	SerializedProperty armorProp;
	SerializedProperty gunProp;
	
	void OnEnable () {
		// Setup the SerializedProperties.
		damageProp = serializedObject.FindProperty ("damage");
		armorProp = serializedObject.FindProperty ("armor");
		gunProp = serializedObject.FindProperty ("gun");
	}
	
	public override void OnInspectorGUI() {
		// Update the serializedProperty - always do this in the beginning of OnInspectorGUI.
		serializedObject.Update ();
		
		// Show the custom GUI controls.
		EditorGUILayout.IntSlider (damageProp, 0, 100, new GUIContent ("Damage"));

		// Only show the damage progress bar if all the objects have the same damage value:
		if (!damageProp.hasMultipleDifferentValues)
			ProgressBar (damageProp.intValue / 100.0f, "Damage");
		
		EditorGUILayout.IntSlider (armorProp, 0, 100, new GUIContent ("Armor"));

		// Only show the armor progress bar if all the objects have the same armor value:
		if (!armorProp.hasMultipleDifferentValues)
			ProgressBar (armorProp.intValue / 100.0f, "Armor");
		
		EditorGUILayout.PropertyField (gunProp, new GUIContent ("Gun Object"));
		
		// Apply changes to the serializedProperty - always do this in the end of OnInspectorGUI.
		serializedObject.ApplyModifiedProperties ();
	}
	
	// Custom GUILayout progress bar.
	void ProgressBar (float value, string label) {
		// Get a rect for the progress bar using the same margins as a textfield:
		Rect rect = GUILayoutUtility.GetRect (18, 18, "TextField");
		EditorGUI.ProgressBar (rect, value, label);
		EditorGUILayout.Space ();
	}
}

Или же, если автоматическая обработка редактирования нескольких объектов, отмены, и переопределение префабов не нужны, переменные скрипта могут быть изменены напрямую редактором, без использования SerializedObject и SerializedProperty, как в примере ниже.

using UnityEditor;
using UnityEngine;
using System.Collections;


// Example script with properties.
public class MyPlayer : MonoBehaviour {
	public int damage;
	public int armor;
	public GameObject gun;

	// ...other code...
}


// Custom Editor the "old" way by modifying the script variables directly.
// No handling of multi-object editing, undo, and prefab overrides!
[CustomEditor (typeof(MyPlayer))]
public class MyPlayerEditor : Editor {
	
	public override void OnInspectorGUI () {
		MyPlayer mp = (MyPlayer)target;

		mp.damage = EditorGUILayout.IntSlider ("Damage", mp.damage, 0, 100);
		ProgressBar (mp.damage / 100.0f, "Damage");
		
		mp.armor = EditorGUILayout.IntSlider ("Armor", mp.armor, 0, 100);
		ProgressBar (mp.armor / 100.0f, "Armor");
		
		bool allowSceneObjects = !EditorUtility.IsPersistent (target);
		mp.gun = (GameObject)EditorGUILayout.ObjectField ("Gun Object", mp.gun, typeof(GameObject), allowSceneObjects);
	}
	
	// Custom GUILayout progress bar.
	void ProgressBar (float value, string label) {
		// Get a rect for the progress bar using the same margins as a textfield:
		Rect rect = GUILayoutUtility.GetRect (18, 18, "TextField");
		EditorGUI.ProgressBar (rect, value, label);
		EditorGUILayout.Space ();
	}
}

Переменные

Открытые функции

Статические функции

Сообщения

Унаследованные члены