Zenn
🕌

【Unity C#】Gizmosで3D空間を徹底デバッグ!?隠れた不具合を見える化する技術

2025/02/23に公開
C#
Unity
Tips
デバッグ
gizmos
tech

【Unity C#】Gizmosで3D空間を徹底デバッグ！隠れた不具合を見える化する技術

Unityでの3Dゲーム開発では、シーン上のオブジェクトの配置、移動経路、さらには物理挙動など、普段は見えにくい内部処理が隠れた不具合の原因となることがあります。本記事では、Gizmosを活用してこれらの情報を「見える化」し、効率的にデバッグするための手法を解説します。Gizmosの基本機能から、カメラとの距離に応じた描画調整、NPCのルート可視化、物理演算デバッグ、さらにはMeta Horizon向けの拡張機能まで、実践的なテクニックを幅広くご紹介します。

Gizmosの基本機能と活用法

Gizmosは、エディタのシーンビュー上にデバッグ用の図形、アイコン、テキストなどを表示するための仕組みです。実際のゲームプレイには影響を与えないため、動作確認やオブジェクト配置のチェックに最適です。

  • シーン内に簡単な図形やアイコンを描画可能
  • シーン上に直接テキスト情報を表示できる
  • オブジェクトごとに描画の表示・非表示を制御可能

より詳しい設定方法は公式ドキュメントも参照してください。
https://docs.unity3d.com/ja/2019.4/Manual/GizmosMenu.html

シーン上に描画するサンプルコード

Gizmosの描画は、OnDrawGizmosまたはOnDrawGizmosSelectedメソッド内に記述します。たとえば、シーン上に赤い球体を表示する場合は以下のように実装します。

SampleGizmos.cs
using UnityEngine;

public class SampleGizmos : MonoBehaviour
{
    void OnDrawGizmos()
    {
        Gizmos.color = Color.red;
        Gizmos.DrawSphere(transform.position, 0.5f);
    }
}
テキスト表示のサンプル
SampleGizmosText.cs
using UnityEngine;

public class SampleGizmosText : MonoBehaviour
{
    void OnDrawGizmos()
    {
        GUIStyle style = new GUIStyle();
        style.normal.textColor = Color.white;
        UnityEditor.Handles.Label(transform.position + Vector3.up * 1.0f, "CheckPoint", style);
    }
}

このサンプルでは、UnityEditor.Handles.Labelを利用して、シーン上に「CheckPoint」というテキストを表示しています。

GizmosやHandlesを使った描画テクニックの詳細は、以下のリンクも参考にしてください。
https://raspberly.hateblo.jp/entry/UnitySceneGizmos

3D空間デバッグの応用テクニック

カメラ距離に応じた描画の最適化

広大な3D空間では、カメラから離れた位置にあるGizmosが見えにくくなることがあります。そこで、カメラとの距離に応じて描画方法を動的に変えるテクニックが有効です。具体的には：

  • Vector3.Distanceでカメラとの距離を算出
  • 一定距離以上のオブジェクトは、アイコンやテキストを縮小または非表示にする
  • 距離に合わせたスケール調整で、常に適切なサイズで表示

NPCの移動経路やインタラクション範囲の視覚化

3D空間におけるNPCの巡回ルートや、ユーザーがインタラクション可能な範囲を可視化することは、デバッグだけでなくシステム設計の観点からも重要です。Gizmosを用いることで、以下の効果が期待できます。

  1. NPCのルートをラインや矢印で明示
  2. ルート編集を直感的に行える（クリックやドラッグで調整）
  3. インタラクション可能領域を円や立体図形で表現

シーンビュー上で直接移動経路を編集する方法については、こちらも参考になります。
https://ryo620.org/post/unity-editor-extending-03

物理演算の状態を見える化する

3D空間内では、ユーザーの動きに合わせた物理演算の正確な動作確認が求められます。UnityのPhysics Debug Visualization機能を使うと、以下の点がチェックできます。

  • 衝突判定が正常に行われているか
  • トリガーの範囲が意図した通りか
  • 静的・動的コライダーの重なり状況

これらの詳細な設定方法は、公式ドキュメントを確認してください。
https://docs.unity3d.com/ja/2022.3/Manual/PhysicsDebugVisualization.html

Meta Horizon向けDebugGizmosの実践

Meta HorizonプラットフォームでのVR体験を構築する場合、DebugGizmosを活用すると、手の衝突判定やインタラクションの可視化が容易になり、問題発生時の原因究明がスムーズになります。具体的な実装例は以下のリンクで紹介されています。
https://developers.meta.com/horizon/documentation/unity/unity-isdk-debug-gizmos/?locale=ja_JP

実践！Gizmosを利用した経路可視化の例

経路表示のサンプルコード
PathDebug.cs
using UnityEngine;

public class PathDebug : MonoBehaviour
{
    public Transform[] points;

    void OnDrawGizmos()
    {
        if (points == null || points.Length == 0) return;

        Gizmos.color = Color.yellow;

        for (int i = 0; i < points.Length - 1; i++)
        {
            Gizmos.DrawLine(points[i].position, points[i + 1].position);
        }
    }
}

このコードは、指定したポイント間を黄色いラインで結び、NPCなどの移動経路を視覚化します。

成功するためのキーポイント

  • 最小限の描画に留め、情報過多を避ける
  • エディタ拡張と連携し、シーン上での直接編集を可能にする
  • レイヤー管理により、必要な情報のみを選別して表示する

プロジェクト全体でGizmosの表示を制御する仕組みを導入すれば、さらに効率的なデバッグが実現します。

総括：隠れた不具合を見える化して開発効率を向上

3D空間の開発において、膨大なオブジェクトや複雑な移動経路、物理挙動のチェックは非常に重要です。Gizmosを巧みに使いこなすことで、これらの隠れた不具合を見える化し、迅速なデバッグ作業と高品質なシステム構築が可能となります。

  1. 基本的な図形やテキスト描画から始める
  2. NPCのルートやコライダーの状態を明確に視覚化する
  3. 公式ドキュメントや実例を元に、独自のデバッグツールを整備する

これらの手法を積極的に取り入れて、3D空間のデバッグ効率を劇的に向上させましょう。

さらに実践力を高めるために

Unity開発のスキルをさらに磨きたい方へ、以下の3つのアプローチをおすすめします。

1. 有料教材「どこでもUnity教室」で短期間にスキルアップ

  • 初心者でも短期間で3Dゲーム開発の基礎から応用まで習得
  • C#の基礎から最新技術まで網羅したカリキュラム
  • 購入特典として、Discord招待やサンプルプロジェクトが提供される

Unity初心者向けの短期集中講座はこちら

https://zenn.dev/ryuryu_game/books/fd28de9d8e963a/viewer/0570af

2. 無料コミュニティで疑問を即解消＆モチベーションアップ

  • 初心者から中級者まで対応の充実したコミュニティ
  • 専門家や仲間とすぐに疑問を解決できる環境
  • 学習仲間と情報共有することで、継続しやすい環境

Discordコミュニティに参加する

https://discord.gg/5FwuKCacNy

3. 経験豊富な“ゲーム開発所RYURYU”がトータルサポート

  • 数多くのUnityプロジェクト実績に基づく安心のサポート
  • VR/AR/AI技術を駆使した最新の開発支援
  • 各種イベントや展示会での実績を持つ信頼のパートナー

サポートの詳細やお問い合わせはこちら

https://coconala.com/users/1772507

これらのリソースを活用して、実践的なスキルを身につけ、プロジェクト成功への道を切り拓いてください。

Discussion