インスペクターで設定できる色々な値

2021年3月4日2022年8月26日

Unityでは、ゲームオブジェクトを選択、自作のスクリプトをコンポーネントとしてアタッチすることができます。
自作の場合、初期値を設定・調整することでゲームバランスを考えたり、自作コンポーネントを再利用することができるようになります。

1. フィールド値
- 1.1. publicアクセス
- 1.2. privateアクセス
2. 配列値
- 2.1. publicアクセス
3. List<>値
- 3.1. publicアクセス
4. プロパティ値
- 4.1. publicアクセス
5. 列挙値
- 5.1. publicアクセス
6. Vector3値
- 6.1. publicアクセス
7. LayerMask値
- 7.1. publicアクセス
8. Color値
- 8.1. publicアクセス
9. 画像
- 9.1. publicアクセス
10. 連続した値
- 10.1. publicアクセス
11. コンポーネント
- 11.1. publicアクセス
12. 自作クラスのインスタンス
- 12.1. publicアクセス
13. 自作クラス（ジェネリッククラス）のインスタンス
- 13.1. publicアクセス
14. 自作クラスのList<>
- 14.1. publicアクセス
15. UnityEvent
- 15.1. publicアクセス
16. UnityEvent（ビジュアルで設定してみる）
- 16.1. publicアクセス
17. UnityEvent（引数あり。ビジュアルで設定してみる）
- 17.1. publicアクセス
18. UnityEvent（引数に自作クラスを使う。ビジュアルで設定してみる）
- 18.1. publicアクセス

フィールド値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public int hp;
}

インスペクター

privateアクセス

スクリプト

プライベートアクセスでは、属性[SerializeField]をつけることでインスペクターに表示できます
また、これはC#の仕様ですがprivateアクセス修飾子は省略することもできます。（privateがある場合と同意）

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    [SerializeField]
    private int hp;
}

インスペクター

配列値

publicアクセス

スクリプト

using UnityEngine;

public class Inspector : MonoBehaviour
{
    public int[] scores = new int[5];
}

インスペクター

スクリプト(要素数をインスペクターで設定する場合）

using UnityEngine;

public class Inspector : MonoBehaviour
{
    public int[] scores;
}

インスペクター（要素数は、Scoresの数値設定で決めます）

List<>値

publicアクセス

スクリプト

using System.Collections.Generic;
using UnityEngine;

public class Inspector : MonoBehaviour
{
    public List<int> scores;
}

インスペクター（配列の場合と同じく要素数は、Scoresの値で設定します）

プロパティ値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    [field: SerializeField]
    public int Hp { get; set; }
}

インスペクター

列挙値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public enum Job
    {
        Warrior,
        Wizard,
        Hero,
    }

    // インスペクターではプルダウンメニューで選択できるようになります
    public Job job;
}

インスペクター

Vector3値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public Vector3 vector3;
}

インスペクター

LayerMask値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public LayerMask layerMask;
}

インスペクター（プルダウンメニューからマスクを１つ以上選択することができます）

Color値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public Color color;
}

インスペクター（カラーバーをクリックすると、ピッカーが表示されてビジュアルでの設定も可能になります）

画像

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public Sprite sprite;
}

インスペクター（スプライトに変換した画像をドラッグ&ドロップすることで登録できます

連続した値

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public AnimationCurve curve;
}

インスペクター（線形のグラフを登録できます）

グラフ部分をクリックすると入力画面になります

カーブの編集 - Unity マニュアル

Unity Editor には、カーブを使用してデータを表示したり編集したりできるさまざまな機能やウインドウ ...

https://docs.unity3d.com/ja/2022.1/Manual/EditingCurves.html

スクリプト

値の取得ができます
x軸を0から1と考え、例えば.0.3の場所の値を取得する場合、次のようになります

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public AnimationCurve curve;

    void Start()
    {
        Debug.Log(curve.Evaluate(0.3f));
    }
}

値の取得ができます
キーフレームを追加するとその数だけ値を取得することができます
キーフレームは配列に格納されます

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public AnimationCurve curve;

    void Start()
    {
        for (int i = 0; i < curve.length; i++)
        {
            Debug.Log(curve.Evaluate(0.3f));
        }
    }
}

コンポーネント

publicアクセス

スクリプト

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public Transform tran;
}

インスペクター

サンプル

Cubeを１つ作ります
Positionに適当な値を代入してみます
この値を取得するサンプルになります

空のゲームオブジェクトを１つ作成して、作成したInspectorSetスクリプトをアタッチします
TranのところにHierarchyからCubeゲームオブジェクトをドラッグ&ドロップして登録します

確認のためのコードを追記します

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public Transform tran;

    void Start()
    {
        Debug.Log(tran.position);
    }
}

実行してみましょう
登録したCubeのポジションが表示されるはずです

(10.00, 20.00, 30.00)

参考）Transform型のところをGameObject型で宣言した場合の同一コード
このコードに変更した場合には、再度CubeをInspectorウィンドウでドラッグ&ドロップしてください。変更直後は、Noneになっています

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    public GameObject obj;

    void Start()
    {
        Debug.Log(obj.transform.position);
    }
}

参考）GameObject.Findを使った場合
Inspectorウィンドウでドラッグ&ドロップできません
HierarchyウィンドウからCubeという名前のオブジェクトを探してくる用途に使います

Findを使う場面

動的に存在するオブジェクト（リアルタイムで追加変更される敵やアイテム）を取得する必要がある場合
Prefabにアタッチされるスクリプトはこの書き方しかできません（Prefabが最初からシーンにないため）

Findを使うデメリット

スクリプト中にマジックナンバー（今回は"Cube"という固有の名前）が入るので、たとえば名前を変更した場合にコードの変更も必要になります。Inspectorで設定する場合は、自動的に差し替えられます

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    void Start()
    {
        GameObject obj = GameObject.Find("Cube");

        Debug.Log(obj.transform.position);
    }
}

自作クラスのインスタンス

publicアクセス

スクリプト

System.Serializable属性により、シリアル化します。インスタンスはメモリ上に作成されているため、Inspectorで読み書きできる固定情報にするためにシリアル化が必要になります。

using UnityEngine;

[System.Serializable]
public class Player
{
    public string name;
    public int hp;
}

public class InspectorSet : MonoBehaviour
{
    public Player player;
}

スクリプト（インナークラスにした場合）

クラスの中にクラスを記述することができます
このインナークラスは、外部クラスから直接アクセスできません
必要に応じて使いましょう

using UnityEngine;

public class InspectorSet : MonoBehaviour
{
    [System.Serializable]
    public class Player
    {
        public string name;
        public int hp;
    }

    public Player player;
}

インスペクター

自作クラス（ジェネリッククラス）のインスタンス

unity 2020.1以降

publicアクセス

スクリプト

Playerクラスのhpの型をインスタンス作成時に決定することができます。

using UnityEngine;

[System.Serializable]
public class Player<T>
{
    public string name;
    public T power;
}

public class InspectorSet : MonoBehaviour
{
    public Player<int> player1;
    public Player<float> player2;

    private void Start()
    {
        // コードの中で代入した場合、インスペクターの設定値よりこちらが適用されます
        // ジェネリッククラスを使うことで、player1のpowerはint型、player2のpowerはfloat型にすることができます
        player1.power = 10;
        player2.power = 10.3f;
    }
}

Player1のPowerに1.5など小数を入力しようとしても受け付けません（ . が入力できません）
試してみましょう

自作クラスのList<>

publicアクセス

スクリプト

PlayerクラスとList<>の組み合わせも可能です。

using System.Collections.Generic;
using UnityEngine;

[System.Serializable]
public class Player
{
    public string name;
    public int hp;
}

public class InspectorSet : MonoBehaviour
{
    public List<Player> players;
}

UnityEvent

publicアクセス

スクリプト

インスペクターにビジュアルで実行されるスクリプトをセットすることができるようになります。

using UnityEngine;
using UnityEngine.Events;

public class InspectorSet : MonoBehaviour
{
    public UnityEvent sampleEvent;
}

UnityEvent（ビジュアルで設定してみる）

publicアクセス

スクリプト

インスペクターにビジュアルで実行されるスクリプトをセットすることができるようになります。

using UnityEngine;
using UnityEngine.Events;

public class InspectorSet : MonoBehaviour
{
    public UnityEvent sampleEvent;

    public void ShowHello()
    {
        Debug.Log("Hello");
    }
}

＋をクリックして、設定を追加する

実行したいスクリプトがアタッチされているゲームオブジェクトをNone(Object)にD&D

No Functionにプルダウンメニューから[InspectorSet（コンポーネント）] -> [ShowHello（publicメソッド名）]を選択

イベントの呼び出しコードを追加。実行してみる

using UnityEngine;
using UnityEngine.Events;

public class InspectorSet : MonoBehaviour
{
    public UnityEvent sampleEvent;

    public void ShowHello()
    {
        Debug.Log("Hello");
    }

    void Start()
    {
        sampleEvent.Invoke();
    }
}

結果

UnityEvent（引数あり。ビジュアルで設定してみる）

publicアクセス

スクリプト

引数を渡す場合、UnityEvnetのジェネリックを使う必要があります。

デフォルトで MonoBehaviour の UnityEvent は動的に void 関数をバインドします。UnityEvent は 4 つまで引数を伴う関数バインドをサポートしていますので、これは動的実行のケースである必要はありません。これを実行するために、複数の引数をサポートするカスタム UnityEvent クラスを定義する必要があります。これは以下のように、本当に簡単にできます。

ここで、わざわざUnityEvent<>を継承し、派生クラスから宣言する必要があるのは、UnityEvent<>が抽象クラス(abstract クラス）のためです（Unity 2019.4で確認)

抽象クラスからは、直接インスタンスを作成できない仕様になっています

Events.UnityEvent<T0> - Unity スクリプトリファレンス

1つの引数を持つ UnityEvent

https://docs.unity3d.com/ja/2018.4/ScriptReference/Events.Un...

using UnityEngine;
using UnityEngine.Events;

[System.Serializable]
public class SampleEvent : UnityEvent<string>
{
}

public class InspectorSet : MonoBehaviour
{
    public SampleEvent sampleEvent;

    public void ShowHello(string msg)
    {
        Debug.Log("Hello " + msg);
    }
}

追加情報）Unity 2020.2で確認したところ、UnityEvent<>は、抽象クラスではなくなっているようです。
なので、次のように直接宣言することができます

using UnityEngine;
using UnityEngine.Events;

public class InspectorSet : MonoBehaviour
{
    public UnityEvent<string> sampleEvent;

    public void ShowHello(string msg)
    {
        Debug.Log("Hello " + msg);
    }
}

＋をクリックして、設定を追加する

実行したいスクリプトがアタッチされているゲームオブジェクトをNone(Object)にD&D

No Functionにプルダウンメニューから[InspectorSet（コンポーネント）] ->Dynamic stringの [ShowHello（publicメソッド名）]を選択
Dynamic stringは、実行時に引数の値を受け渡すとき（今回）に選択します。

イベントの呼び出しコードを追加。実行してみる

using UnityEngine;
using UnityEngine.Events;

[System.Serializable]
public class SampleEvent : UnityEvent<string>
{
}

public class InspectorSet : MonoBehaviour
{
    public SampleEvent sampleEvent;

    public void ShowHello(string msg)
    {
        Debug.Log("Hello " + msg);
    }

    void Start()
    {
        sampleEvent.Invoke("World");
    }
}

結果

設計時に値を固定にしたいときは、次のように設定します。

固定設定を空白に追加します

UnityEvent（引数に自作クラスを使う。ビジュアルで設定してみる）

publicアクセス

スクリプト

引数を自作クラスの型で渡す場合、UnityEvnetのジェネリックを使います。
継承するUnityEventの型パラメータをPlayerとします

using UnityEngine;
using UnityEngine.Events;

public class Player
{
    public int hp;
}

[System.Serializable]
public class SampleEvent : UnityEvent<Player>
{
}

public class InspectorSet : MonoBehaviour
{
    public SampleEvent sampleEvent;

    public void ShowHp(Player p)
    {
        Debug.Log("Player HP =  " + p.hp);
    }
}

＋をクリックして、設定を追加する

実行したいスクリプトがアタッチされているゲームオブジェクトをNone(Object)にD&D

イベントの呼び出しコードを追加。実行してみる

using UnityEngine;
using UnityEngine.Events;

public class Player
{
    public int hp;
}

[System.Serializable]
public class SampleEvent : UnityEvent<Player>
{
}

public class InspectorSet : MonoBehaviour
{
    public SampleEvent sampleEvent;

    Player player = new Player();

    private void Start()
    {
        player.hp = 10;

        sampleEvent.Invoke(player);
    }

    public void ShowHp(Player p)
    {
        Debug.Log("Player HP =  " + p.hp);
    }
}

結果