Unity ゲームオブジェクトを選択し直したときに常にインスペクターのコンポーネントを折りたたんで表示したい

Question

前提・実現したいこと

選択を切り替えたときに常に上の画像にある「すべてのコンポーネントを折りたたむ」の状態に
なるようにしたいです。

理由

TopDownEngineというアセットを使用しています。
敵キャラを作る際にゲームオブジェクトに取り付けるコンポーネントが多くなってしまいます。
（取り付けるコンポーネントを分割する機能もドキュメントにありましたがそれでも多くなります。）
切り替えたときに毎回コンポーネントが展開されて表示されて視認性が悪いです。

試したこと

ネットで検索してエディタ拡張という機能が近いようにも思いましたが
検索に使用する言葉選びが悪かったのか、自分の理解が及んでいないだけなのか
実現できるような記事等を見つけられませんでした。

補足情報（FW/ツールのバージョンなど）

unity 2020.3.9f1

TopDownEngine（アセット）のドキュメント

Answer 1

エディタ拡張について調べるというのはもっともだと思います。ですがエディタ拡張というのは、自前でエディタ用スクリプトを作るなどでUnityエディタの機能を追加・改変する行為全般を指すものかと思いますので、範囲が広くて情報を得にくいかもしれませんね。

インスペクター周りについては、「自作のスクリプト用に専用のインスペクターを作って設定しやすくする」みたいなことでしたらUnity側に用意されている手段も充実していて、製作例も見つかりやすいかと思います。ですがちょっと調べてみたところでは、インスペクターウィンドウ自体への操作はUnityユーザ側から隠されていて、リファレンスにも情報が載っていないようです。

しかたないのでUnityCsReferenceの中の怪しそうなところを探してみたところ、インスペクターウィンドウの取得はInspectorWindow.GetInspectorsを、すべてのコンポーネントを折りたたむのはPropertyEditor.CollapseAllComponentsを使えそうな感じでした。
そこでプロジェクト内に「Editor」フォルダを作り、下記のようなスクリプトを入れたところ...

using System.Collections;
using System.Reflection;
using UnityEditor;

[InitializeOnLoad]
public static class AutomaticInspectorCollapser
{
    // メニューのオン・オフを保持しておくための環境設定キー
    private const string EnableCollapseComponentsAutomaticallyKey = "AutomaticInspectorCollapser.EnableCollapseComponentsAutomatically";

    // メニューを表示する場所
    private const string CollapseComponentsAutomaticallyMenuPath = "Utility/Collapse Components Automatically";

    // メニューのオン・オフ状態
    private static bool enableCollapseComponentsAutomatically;

    // すべてのインスペクターウィンドウを取得するメソッド
    private static readonly MethodInfo GetInspectorsMethod;

    // インスペクター上のコンポーネントをすべて折りたたむメソッド
    private static readonly MethodInfo CollapseAllComponentsMethod;

    // 初期化処理
    static AutomaticInspectorCollapser()
    {
        // 環境設定からメニューのオン・オフ状態を取得する
        enableCollapseComponentsAutomatically = EditorPrefs.GetBool(EnableCollapseComponentsAutomaticallyKey);

        // メソッド情報を取得する
        var coreModuleAssembly = typeof(EditorWindow).Assembly;
        var inspectorWindowType = coreModuleAssembly.GetType("UnityEditor.InspectorWindow");
        GetInspectorsMethod = inspectorWindowType.GetMethod(
            "GetInspectors",
            BindingFlags.DeclaredOnly | BindingFlags.Static | BindingFlags.NonPublic);
        var propertyEditorType = coreModuleAssembly.GetType("UnityEditor.PropertyEditor");
        CollapseAllComponentsMethod = propertyEditorType.GetMethod(
            "CollapseAllComponents",
            BindingFlags.DeclaredOnly | BindingFlags.Instance | BindingFlags.NonPublic);

        // オン・オフ状態に応じて自動折りたたみ機能のオン・オフを切り替える
        UpdateState();
    }

    // メニューコマンド実行時の処理
    [MenuItem(CollapseComponentsAutomaticallyMenuPath)]
    private static void ToggleEnableCollapseComponentsAutomatically()
    {
        // オン・オフ状態を切り替えて...
        enableCollapseComponentsAutomatically = !enableCollapseComponentsAutomatically;

        // 現在のオン・オフ状態を環境設定に保存し...
        EditorPrefs.SetBool(EnableCollapseComponentsAutomaticallyKey, enableCollapseComponentsAutomatically);

        // オン・オフ状態に応じて自動折りたたみ機能のオン・オフを切り替える
        UpdateState();
    }

    // 自動折りたたみ機能のオン・オフ切り替え処理
    private static void UpdateState()
    {
        // オン・オフ状態に応じてメニュー項目にチェックマークを入れる
        Menu.SetChecked(CollapseComponentsAutomaticallyMenuPath, enableCollapseComponentsAutomatically);
        
        if (enableCollapseComponentsAutomatically)
        {
            // オン状態なら、選択対象切り替え時に折りたたみを実行するよう設定し...
            Selection.selectionChanged += CollapseComponents;
        }
        else
        {
            // オフ状態なら、折りたたみ処理を解除する
            Selection.selectionChanged -= CollapseComponents;
        }
    }

    // 折りたたみ処理
    private static void CollapseComponents()
    {
        // すべてのインスペクターウィンドウを取得し...
        var inspectors = GetInspectorsMethod.Invoke(null, null) as IEnumerable;
        
        // それぞれについてコンポーネント折りたたみを実行する
        foreach (var inspector in inspectors)
        {
            CollapseAllComponentsMethod.Invoke(inspector, null);
        }
    }
}

メニューバーに「Utility」→「Collapse Components Automatically」メニューが追加されますので、それをオンにするとオブジェクト切り替え時にインスペクター上の各コンポーネントが折りたたまれるようになりました。

Comments

[7le2nniy]

回答ありがとうございます。
自分の環境でもできるようになりました。
丁寧なコメント付きのコードで非常に参考になりました。