Property<T, TVariable> / ReadonlyProperty<T, TVariable>
class
名前空間：SilCilSystem.Variables
Property, ReadonlyPropertyはインスペクタ上で変数と変数アセットのどちらを使うかを選択できるようになるクラスです。 これらを用いることで、変数アセットを必要以上に増やすことなくスクリプトの設定項目をエディタ上で調整できるようになります。
メンバ一覧
| クラス | 役割 |
|---|---|
| Property<T, TVariable> | ValueプロパティでT型の値のset/get |
| ReadonlyProperty<T, TVariable> | ValueプロパティでT型の値のget |
T: 変数の型（int, floatなど） TVariable: T型の変数アセット（VariableInt, VariableFloatなど）
Unity2019ではGenericクラスはシリアライズできないため、 よく使うであろう型についてはGenericクラスを継承した非Genericなクラスを用意しています。 実際のコーディングではこちらを使用することになると思います。
Primitive
| 型 | クラス | 読取専用クラス |
|---|---|---|
| bool | PropertyBool | ReadonlyPropertyBool |
| string | PropertyString | ReadonlyPropertyString |
| int | PropertyInt | ReadonlyPropertyInt |
| float | PropertyFloat | ReadonlyPropertyFloat |
UnityEngineのstruct型
| 型 | クラス | 読取専用クラス |
|---|---|---|
| Vector2 | PropertyVector2 | ReadonlyPropertyVector2 |
| Vector2Int | PropertyVector2Int | ReadonlyPropertyVector2Int |
| Vector3 | PropertyVector3 | ReadonlyPropertyVector3 |
| Vector3Int | PropertyVector3Int | ReadonlyPropertyVector3Int |
| Color | PropertyColor | ReadonlyPropertyColor |
| Quaternion | PropertyQuaternion | ReadonlyPropertyQuaternion |
使用例
Unityでは変数をシリアライズすることでエディタ上で変数の値を変更することができます。 例えば、キャラクターの移動速度など実際にゲームをプレイしながら調整したい値はこの機能を用いると便利です。
SilCilSystemを使わない場合にはこうなります。
using UnityEngine;
public class Test : MonoBehaviour
{
// 移動速度をシリアライズしてインスペクタで設定可能に.
[SerializeField] private float m_speed = 10f;
private void Update()
{
float h = Input.GetAxis("Horizontal");
transform.position += Vector3.right * Time.deltaTime * m_speed;
}
}
SilCilSystemの変数アセットを使用する場合は以下のようになります。
using UnityEngine;
using SilCilSystem.Variables;
public class TestVariable : MonoBehaviour
{
// 変数を変数アセットに変更.
[SerializeField] private ReadonlyFloat m_speed = default;
private void Update()
{
float h = Input.GetAxis("Horizontal");
transform.position += Vector3.right * Time.deltaTime * m_speed;
}
}
変数アセットへの変更により、移動速度を他のスクリプトから制御できるようになりました。 しかし、このスクリプトを動かすためには、変数アセットを作成して設定するという手間が加わりました。 外部との連携をせずに動かしたい場合であっても変数アセットを作成する必要があり、 管理しなくてはならないアセットの数が増えてしまいます。
そこで、Property, ReadonlyPropertyの出番です。 今回はReadonlyFloatを用いているので、それに対応するReadonlyPropertyFloatを使用します。
using UnityEngine;
using SilCilSystem.Variables;
public class TestVariable : MonoBehaviour
{
// 変数アセットを使う/使わないを選べるようになる.
[SerializeField] private ReadonlyPropertyFloat m_speed = new ReadonlyPropertyFloat(10f);
private void Update()
{
float h = Input.GetAxis("Horizontal");
transform.position += Vector3.right * Time.deltaTime * m_speed;
}
}
このようにすることで、変数アセットを使用したい場合にのみ、エディタ上で指定できるようになります。
使用上の注意点
全ての設定項目をこれで置き換えるのが妥当かという点は考える必要があります。 Property, ReadonlyPropertyは現状RangeやTextAreaといった他のAttributeに対応していませんし、 コンポーネント固有のエディタ拡張をする際には通常の変数を用いたほうが拡張が楽だと思います。 外部と連携する必要がないと思われるものは変数で実装することも考えましょう。
あと配列の要素に使う場合など、一部エディタ拡張が上手く機能しなかったりする不具合があります。ごめんなさい。
実装
内部で変数アセットと変数の両方の値を保持しているだけのラッパークラスです。
public class Property<T, TVariable> where TVariable : Variable<T>
{
// 2つの値を保持.
[SerializeField] private T m_value = default;
[SerializeField] private TVariable m_variable = default;
public Property(T value) => Value = value;
public T Value
{
// 変数アセットがnullのときは変数の値を使う.
get => m_variable ?? m_value;
set
{
m_value = value;
m_variable?.SetValue(value);
}
}
public static implicit operator T(Property<T, TVariable> property) => property.Value;
}
これをエディタ拡張で1行で表示するようにしているだけです。