こんにちは、Unityエンジニアのオオバです。

お悩みさん

SetActiveとenabledって似ててよくわからない

どういうケースでどちらを使うべき？

オオバ

本記事ではこれらの悩みを解決します。

MonoBehaviour を継承したクラスには、Unityから特定のイベント（以降:イベント関数）を受け取れるようになります。

以下はイベント関数の一部です。

• Awake
• Start
• OnEnable
• Update

これらの関数が実行される条件は GameObjectまたはコンポーネントがアクティブなとき です。

ちなみにアクティブ状態とは👆上のとおり、チェックが入った状態です。

SetActiveとは GameObjectのアクティブ切り替え 、一方enabledは コンポーネントのアクティブ切り替えのこと です。

本記事は SetActiveとenabledどっちを使うべきかの判断基準 について解説していきます。

GameObjectとコンポーネントはUnity開発の肝。
お互いの特性を理解し、よりよいゲーム設計を目指しましょう。

SetActiveとenabledに悩まされている人は、ぜひ最後まで読んでみてください。

そもそもMonoBehaviourのことがよくわからないという方は次の記事がおすすめです。

あわせて読みたい記事

【Unityの基礎】MonoBehaviour徹底解説【初心者向け】

Unityプログラミング基礎中の基礎「MonoBehaviour」。MonoBehaviour知らずして開発は不可能です。まだ知らないという方は、ぜひこの記事を...

Unityのアクティブ切り替えは、可能な限りenabledを使い、SetActiveは使わない

結論から書くと、 やりたいことを実現できるのであれば「enabled」だけで対応すべき です。
理由は SetActiveの負荷が高い からです。

基本的にSetActiveは trueのまま 。
enabledを切り替える という設計が望ましいです。

結論だけ読んでも分かりづらいと思います。GameObjectとコンポーネントの特性の把握が重要。
両者の違いはコチラの記事でわかりやすく解説したのでぜひ読んでみてください。

あわせて読みたい記事

【保存版】Unityの必須知識「GameObject」の全てを解説

UnityのGameObjectをなんとなく使っていませんか？GameObjectとコンポーネントの関係性の理解はUnity開発に必須です。ただし感覚的に理解し...

🎁Unity開発を加速させる豪華5大プレゼント🎁
コード規約・Unity設定23選・UIチェックシート・フォルダ構成テンプレート+オオバとの個別相談を無料配布中！！

Unityのアクティブ切り替え6パターン

アクティブ切り替えによる処理順の把握はとても重要 です。

ここからは SetActive と enabled の関係について6パターンに分けて解説します。

パターン① GameObject : OFF | コンポーネント : OFF

• 何も実行しない

パターン② GameObject : ON | コンポーネント : OFF

1. Awake

パターン③ GameObject : OFF | コンポーネント : ON

• 何も実行しない

パターン④ GameObject : ON | コンポーネント : ON

1. Awake
2. OnEnable
3. Start
4. Update（何度も）

ここまでを表にまとめました。

GameObjectがONにならないと何も動かない ということが分かります。

パターン⑤ パターン② → コンポーネント : ON

その2の状態
↓

コンポーネント : ON

1. OnEnable
2. Start
3. Update

Awakeは呼ばれずに、
OnEnable、Start、Updateと呼ばれます。

パターン⑥ ⑤ → GameObject : OFF → ON

その5の状態
↓

GameObject : OFF
↓

GameObject : ON

1. OnEnable
2. Update

Awake、StartはGameObjectにつき1回だけ呼ばれます。

GameObjectのON / OFFとコルーチンの関係性

コルーチンとGameObjectの関係は切っても切り離せません。
コルーチンとは中断と再開が可能な関数 です。

なぜGameObjectと密な関係なのかというと、
コルーチンはGameObjectがON（アクティブ）のときしか動かない からです。

次の記事ではコルーチンについて徹底解説しました。
コルーチンをあまり理解できていないと感じたらぜひ読んでみてください。
コルーチンはゲーム開発では必須の知識 です。

あわせて読みたい記事

【Unity基礎】コルーチン入門！使い方と注意点まとめ徹底解説

ゲーム開発で必ず登場する処理の待機。Unityではコルーチンが提供されています。コルーチンは中断と再開が可能な関数。Unity初心者には分かりづらい機能です。本...

話を戻します。

次のコルーチンを実行してみましょう。2つのログを出力するコードです。

IEnumerator Start()  
{
    Debug.Log("Before Timer");  
    yield return Timer();  
    Debug.Log("After Timer");  
}

IEnumerator Timer()  
{
    yield return new WaitForSeconds(1f);  
    gameObject.SetActive(false);  
}

結果はBefore Timerしか出力されません。

なぜならTimerメソッド内でGameObjectがOFFになるためです。GameObjectがOFFになると、実行中のコルーチン（Startメソッド）は停止します。

だからDebug.Log("After Timer");は呼ばれないのです。

GmaeObjectとコンポーネントのON / OFFから分かること

• AwakeはGameObjectがONのときのみ実行
• GameObjectがOFFのときコンポーネントがONになっても何も実行されない
• Awake、StartはGameObject生成後1度しか実行されない
• OnEnableはアクティブの切り替えで何度も実行される
• GameObject、コンポーネントをどちらかOFFでUpdateは停止する
• コルーチンはGameObjectがONのときしか動かない

ユーザー定義メソッドは常に呼ばれる

ユーザー定義メソッドとは、以下のようなAwake、StartといったUnityが予約していないメソッドです。

public void Hoge(){}  

ユーザー定義メソッドはGameObjectやコンポーネントがOFFだったとしても外部から呼ぶことができ、処理は走ります。
GameObject、コンポーネントのON / OFF影響をまったく受けません。

あわせて読みたい記事

【保存版】Unityのコンポーネント徹底解説【Unity基礎】

コンポーネントはUnityにとって重要な根幹の概念です。コンポーネントを正しく理解して、より効率的な開発をしませんか？本記事はUnityのコンポーネントを網羅的...

【例外】 GameObjectがOFFのときコルーチンは実行できない

コルーチンは例外です。GameObjectがOFFのコルーチンを実行しようとすると
次のエラーが出力するので注意です。

Coroutine couldn't be started because  
the game object 'GameObject名' is inactive!  

ここまでを表にしてみます。

• アクティブのON/OFFでユーザー定義メソッドの呼び出しは制御不可
• Unityのイベント制御をベースにON / OFFを判断するべき
• GameObjectをOFFにするとコルーチンが止まるので注意

ここからGameObject、コンポーネントの
ON/OFF判断の基準について考察します。

結局SetActiveとenabledどっちを使えばよいのかまとめます。

Unityアクティブ切り替えまとめ「可能な限りenabledを使う」

最初の結論でも書きましたが SetActiveは負荷が高い ため やりたいことが実現できるならenabledだけを使うです。

コルーチンを止めたいのであれば、 StopCoroutineを使いましょう。

負荷がかかっても問題ないタイミングどうしてもな場合に限ってSetActiveは許容です。

メインはコンポーネントのenabledを切り替える設計が良い でしょう。

ただしコンポーネントのON/OFFを切り替えるのは正直面倒くさいです。1つのGameObjectにいくつも複数のコンポーネントがくっついていますからね。

管理的にすごく複雑になりSetActiveのON/OFFでシンプルで安全な設計になるのであれば SetActiveを優先する判断もあり です。

enabled優先論はあくまパフォーマンスにおける理想論です。
ケースバイケースで総合的に判断しましょう。

この記事が気に入ったら
筆者のXをフォローしよう

Follow @ohbashunsuke

Unityの学習、1人で進めるのは大変ですよね。この度、AIと一緒にUnityゲームを開発する方法をまとめた「AI×Unityゲーム開発スターターキット」を執筆しました。

AI時代のゲーム開発を先取りしたい方はぜひ確認してみてください！ → AI×Unityゲーム開発スターターキット

最後まで読んでいただきありがとうございました！
すばらしいUnityライフをお過ごしください。

【初心者向け】Unityのオブジェクトの色を変える方法（マテリアルを使用）

死ぬほど重いUnityエディタを高速化する3つの方法

【Unity基礎】コルーチン入門！使い方と注意点まとめ徹底解説

間違えやすい!Update・LateUpdate・FixedUpdateの違いを徹底解説【Unity】

【Unity基礎】AwakeやStartって何？使い方や特徴を徹底解説

【Unityの基礎】MonoBehaviour徹底解説【初心者向け】

UnityのPrefab（プレハブ）とは？使い方まで徹底解説

【Unity】Unityの始め方入門！初心者にわかりやすく解説

• Unity2020.3.19f1