メインコンテンツへスキップ
見出し画像

Unityで思い通りに動かないときの確認方法|Debug.Log・DrawLine・DrawRayの使い方

    Unityでゲームを作っていると、

    「コードを書いたのに動かない」
    「当たり判定が反応しない」
    「変数の値が思った通りにならない」
    「どこで処理が止まっているのか分からない」

    ということがよくあります。
    このようなときに役立つのが、Debug です。

    特に、Debug.Log を使うと、処理が呼ばれているか、変数に何が入っているかをConsoleに表示して確認することができます。
    今回は、Unity初心者向けに

    ・Debug.Logの基本
    ・Consoleウィンドウの見方
    ・文字と変数を一緒に表示する方法
    ・Debug.LogWarningとDebug.LogError
    ・Debug.DrawLineとDebug.DrawRay

    について解説します。


    1.はじめに

    Unity初心者のうちは、エラーが出たときや思った通りに動かないときに、どこを見ればよいか分からなくなることがあります。

    たとえば、

    ・Startが呼ばれていないのか
    ・Updateは動いているのか
    ・if文の中に入っているのか
    ・当たり判定が呼ばれているのか
    ・変数の値が正しく変わっているのか

    こういったことは、画面を見ているだけでは分かりにくいです。
    そこで使うのが、Debug.Logです。
    Debug.Logを使うと、Consoleにメッセージを表示できます。

    Debug.Log("ここまで来ました");

    このように書いておくと、その処理が実行されたときにConsoleに文字が表示されます。

    画像

    2.Consoleウィンドウを開く方法

    Debug.Logで表示した内容は、UnityのConsoleウィンドウに表示されます。Consoleが表示されていない場合は、Unity上部のメニュー、もしくは「controlキー」+「shiftキー」+「Cキー」で開きます。

    Window
    → General
    → Console
    画像

    Consoleには、ログや警告、エラーが表示されます。
    コードが思った通りに動かないときは、まずConsoleを見る習慣をつけておくとよいです。


    3.Debug.Logとは

    Debug.Logは、Consoleにメッセージを表示するための命令です。

    Debug.Log("Hello Unity");

    このコードが実行されると、Consoleに

    Hello Unity

    と表示されます。

    たとえば、Startが呼ばれているか確認したい場合は、次のように書きます。

    void Start()
    {
        Debug.Log("Startが呼ばれました");
    }

    ゲームを再生したときにConsoleに表示されれば、Startが正しく呼ばれていることが分かります。


    まずは「ここまで来た」を表示してみる

    初心者にとって一番分かりやすい使い方は、処理が通っているかを確認することです。

    void Start()
    {
        Debug.Log("ここまで来た");
    }

    たとえば、ボタンを押したときの処理が動いているか確認したい場合は、次のように書けます。

    public void PushButton()
    {
        Debug.Log("ボタンが押されました");
    }

    このログが出れば、ボタンの処理は呼ばれています。
    ログが出なければ、ボタンの設定や関数の指定が間違っている可能性があります。

    このように、Debug.Logを使うと、

    • 処理が呼ばれていないのか

    • 処理は呼ばれているけど、その後が間違っているのか

    を切り分けることができます。


    Debug.Logの中に文字を書く

    Debug.Logのかっこの中には、表示したい文字を書きます。
    文字を書くときは、ダブルクォーテーション " で囲みます。

    Debug.Log("プレイヤーがジャンプしました");

    このように、文字は必ず " で囲みます。

    日本語でも英語でも、文字として表示したい場合は " で囲む必要があります。


    変数の中身を表示する

    Debug.Logでは、変数の中身も表示することができます。
    たとえば、HPを確認したい場合は次のように書きます。

    int hp = 100;
    
    void Start()
    {
        Debug.Log(hp);
    }

    この場合、Consoleには

    100

    と表示されます。
    ただし、数字だけ表示されると、あとから見たときに何の数字か分かりにくいので、文字と一緒に表示することが多いです。


    + で結合する方法

    Debug.Log("現在のHP:" + hp);

    このように書くと、Consoleには次のように表示されます。

    現在のHP:100

    上のように文字と変数を一緒に表示するときは、+ を使ってつなげることができます。
    複数の変数を表示することもできます。

    Debug.Log("HP:" + hp + " / スコア:" + score);

    この書き方は分かりやすく、初心者にも使いやすいです。
    ただし、表示する変数が増えると、少し読みにくくなることがあります。


    $ を使って書く方法

    C#では、文字の前に $ を付けることで、文字の中に変数を埋め込むことができます。

    Debug.Log($"現在のHP:{hp}");

    この書き方では、変数を { } の中に書きます。
    たとえば、

    int hp = 100;
    int score = 50;
    
    void Start()
    {
        Debug.Log($"HP:{hp} / スコア:{score}");
    }

    Consoleには、次のように表示されます。

    HP:100 / スコア:50

    +でつなげる書き方と比べると、文章の中にそのまま変数を入れられるので、見た目が分かりやすくなります。


    + で結合する方法と$を使う方法の違い

    どちらの書き方でも、Consoleに表示する結果は同じです。

    Debug.Log("現在のHP:" + hp);
    Debug.Log($"現在のHP:{hp}");

    どちらも、Consoleには次のように表示されます。

    現在のHP:100

    使い慣れないうちは、まず + でつなげる方法を覚えておくとよいです。
    慣れてきたら、$"文字{変数}" の書き方も使ってみましょう。

    個人的には、変数が1つだけなら + でも充分で、わかりやすいと思います。変数が複数ある場合は、$を使った方が見やすくなると思います。


    活用例1:if文に入っているか確認する

    Debug.Logは、if文の確認にもよく使います。
    たとえば、HPが0以下になったらゲームオーバーにしたい場合を考えます。

    if (hp <= 0)
    {
        Debug.Log("HPが0以下になりました");
    }

    このログが出れば、if文の条件が成立していることが分かります。
    逆に、HPが0以下になっているはずなのにログが出ない場合は、

    ・hpの値が思った通りに減っていない
    ・条件式が間違っている
    ・そもそもこの処理が呼ばれていない

    といった原因が考えられます。
    変数の値も一緒に表示すると、さらに分かりやすくなります。

    Debug.Log($"現在のHP:{hp}");
    
    if (hp <= 0)
    {
        Debug.Log("ゲームオーバー処理に入りました");
    }

    活用例2:当たり判定の実行を確認する

    Unity初心者がよくつまずくのが、当たり判定です。
    OnTriggerEnterやOnCollisionEnterが反応しないときは、まずログを入れて確認します。

    void OnTriggerEnter(Collider other)
    {
        Debug.Log("何かが入りました");
    }

    このログが出れば、OnTriggerEnterは呼ばれています。
    さらに、何に触れたのかを確認したい場合は、other.nameを表示します。

    void OnTriggerEnter(Collider other)
    {
        Debug.Log("触れた相手:" + other.name);
    }

    または、$を使って次のように書けます。

    void OnTriggerEnter(Collider other)
    {
        Debug.Log($"触れた相手:{other.name}");
    }

    タグを確認したい場合は、次のように書きます。

    void OnTriggerEnter(Collider other)
    {
        Debug.Log($"触れた相手のタグ:{other.tag}");
    
        if (other.CompareTag("Player"))
        {
            Debug.Log("Playerに触れました");
        }
    }

    このようにすると、

    ・当たり判定が呼ばれているか
    ・何のオブジェクトに触れたのか
    ・タグが正しく設定されているか

    を確認することができます。


    4.Debug.LogWarningとは

    Debug.LogWarningは、Consoleに警告を表示するための命令です。

    Debug.LogWarning("HPが少なくなっています");

    通常のログより目立つ形で表示されます。

    画像

    エラーではないけれど、注意して確認したい場合に使います。

    たとえば、HPが少なくなったときに警告を出すことができます。

    if (hp <= 10)
    {
        Debug.LogWarning($"HPが少なくなっています:{hp}");
    }

    5.Debug.LogErrorとは

    Debug.LogErrorは、Consoleにエラーとして表示するための命令です。

    Debug.LogError("Playerが見つかりません");
    画像

    たとえば、必要なオブジェクトが見つからなかったときに使えます。

    if (player == null)
    {
        Debug.LogError("Playerオブジェクトが設定されていません");
    }

    nullが原因でエラーになりそうな場所では、事前に確認しておくと原因を見つけやすくなります。

    if (target == null)
    {
        Debug.LogError("targetがnullです");
        return;
    }

    このように return を入れておくと、targetがない状態で次の処理に進むのを防ぐこともできます。


    6.Debug.DrawLineとは

    Debug.DrawLineは、Sceneビューに線を表示するための命令です。

    Debug.DrawLine(transform.position, target.position, Color.red);

    DrawLineでは、線の開始地点と終了地点を指定します。

    Debug.DrawLine(開始位置, 終了位置, 色);

    たとえば、自分の位置からターゲットの位置まで線を引く場合は、次のように書けます。

    public Transform target;
    
    void Update()
    {
        Debug.DrawLine(transform.position, target.position, Color.red);
    }

    これは、敵からプレイヤーへの方向を確認したいときなどに便利です。

    注意点として、Debug.DrawLineの線は、基本的にGameビューではなくSceneビューで確認します。


    7.Debug.DrawRayとは

    Debug.DrawRayも、Sceneビューに線を表示する命令です。
    DrawLineとの違いは、指定の仕方です。
    DrawLineは、開始位置と終了位置を指定します。

    Debug.DrawLine(start, end, Color.red);

    一方、DrawRayは、開始位置と方向を指定します。

    Debug.DrawRay(start, direction, Color.blue);

    たとえば、オブジェクトの前方向に線を出したい場合は、次のように書けます。

    void Update()
    {
        Debug.DrawRay(transform.position, transform.forward * 5f, Color.blue);
    }

    この例では、オブジェクトの位置から前方向に5の長さの線を表示します。

    Raycastを使っているときは、Debug.DrawRayを使うと、どの方向に判定を飛ばしているのか確認しやすくなります。

    void Update()
    {
        Vector3 direction = transform.forward;
    
        if (Physics.Raycast(transform.position, direction, out RaycastHit hit, 5f))
        {
            Debug.Log($"当たった相手:{hit.collider.name}");
        }
    
        Debug.DrawRay(transform.position, direction * 5f, Color.green);
    }

    このようにすると、Raycastの方向をSceneビューで確認できます。


    8.よく使うDebugのまとめ

    今回紹介したDebugの使い方をまとめると、次のようになります。

    画像
    Debug.Log
    → 通常の確認に使う
    
    Debug.LogWarning
    → 注意として表示したいときに使う
    
    Debug.LogError
    → エラーとして目立たせたいときに使う
    
    Debug.DrawLine
    → 開始位置と終了位置を指定してSceneビューに線を表示する
    
    Debug.DrawRay
    → 開始位置と方向を指定してSceneビューに線を表示する
    

    文字と変数を一緒に表示する場合は、次の2つの書き方があります。

    Debug.Log("現在のHP:" + hp);
    Debug.Log($"現在のHP:{hp}");

    どちらも同じように表示できます。

    初心者のうちは、まず + でつなげる方法を覚え、慣れてきたら $"文字{変数}" の書き方も使ってみましょう。


    9.まとめ

    今回は、Unityで思った通りに動かないときの確認方法として、Debugの使い方を紹介しました。

    ゲーム制作では、コードを書いてすぐに思った通り動くとは限りません。
    そのようなときに大切なのは、いきなり原因を決めつけるのではなく、

    処理が呼ばれているか
    変数の値は正しいか
    if文の中に入っているか
    当たり判定は反応しているか
    Rayの向きは合っているか

    を一つずつ確認することです。

    Debug.Logを使えば、Consoleで処理や変数の状態を確認できます。Debug.DrawLineやDebug.DrawRayを使えば、Sceneビューで方向や線を見える形で確認できます。

    初心者のうちは、エラーを直すことよりも、まず今、何が起きているのかを確認することが大切です。
    そのための基本として、Debugの使い方を覚えておきましょう。


    次回は、

    ・Consoleウィンドウの便利な使い方
    ・ログ、警告、エラーの違い
    ・ClearやCollapseの使い方
    ・エラーをクリックして場所を確認する方法
    ・初心者がよく見るエラーの例

    について解説します。


    こちらはUnity初心者向けの記事をテーマ別にまとめています。

    ▼ Unity初心者向け記事まとめはこちら


    こちらのマガジン「ミニゲーム作成講座 全8回セット」でもシーンの切り替えなどを活用して、初心者でも知識ゼロから作れるミニゲーム作成講座を紹介しています。

    画像

    ファイブボックスでは、スクラッチやUnityの個別指導のオンラインレッスンを行っています。

    ご興味のある方は当サイト、オンラインレッスンから、無料体験授業へお問い合わせ下さい。



     
     
    現役プログラマー&講師です。Unity初心者向けに、ゲーム制作やプログラミングをわかりやすく指導しています。個別レッスンの経験をもとに、挫折しにくい教材をお届けします。

    あなたへのおすすめ