Unity Test Runner の使い所

例1: スコア計算機能のテスト（ScoreCalculator）

クラス定義例

public class ScoreCalculator
{
    private readonly int _killPoints;
    private readonly int _timeBonusPerSecond;

    public ScoreCalculator(int killPoints, int timeBonusPerSecond)
    {
        _killPoints = killPoints;
        _timeBonusPerSecond = timeBonusPerSecond;
    }

    /// <summary>
    /// 敵を倒した数とクリア時間から最終スコアを計算する
    /// </summary>
    public int Calculate(int kills, float timeInSeconds)
    {
        int baseScore = kills * _killPoints;
        int timeBonus = Mathf.FloorToInt((60f - timeInSeconds) * _timeBonusPerSecond);
        return Mathf.Max(baseScore + timeBonus, 0);
    }
}

テストクラス例

using NUnit.Framework;
using UnityEngine;  // Mathf を使う場合

[TestFixture]
public class ScoreCalculatorTests
{
    private ScoreCalculator _calculator;

    [SetUp]
    public void SetUp()
    {
        // 1キルあたり100点、1秒早いごとに5点ボーナス
        _calculator = new ScoreCalculator(killPoints: 100, timeBonusPerSecond: 5);
    }

    [Test]
    public void Calculate_GivenZeroKillsAndFullTime_ReturnsZero()
    {
        int result = _calculator.Calculate(kills: 0, timeInSeconds: 60f);
        Assert.That(result, Is.EqualTo(0), "キルもボーナスもない場合は0点になるべき");
    }

    [Test]
    public void Calculate_GivenThreeKillsAndQuickClear_ReturnsCorrectScore()
    {
        // 3キル → 300点、クリア時間50秒 → (60 - 50) * 5 = 50点 → 合計350点
        int result = _calculator.Calculate(kills: 3, timeInSeconds: 50f);
        Assert.That(result, Is.EqualTo(350), "3キルかつ50秒クリアで350点になるべき");
    }

    [Test]
    public void Calculate_NegativeTimeBonus_DoesNotGoBelowZero()
    {
        // クリア時間が60秒以上だと timeBonus がマイナスになるが、最終結果は0未満にならない
        int result = _calculator.Calculate(kills: 0, timeInSeconds: 70f);
        Assert.That(result, Is.EqualTo(0), "マイナスボーナスでもスコアは0未満にならない");
    }
}

例2: インベントリ操作機能のテスト（InventoryManager）

クラス定義例

public class InventoryManager
{
    private readonly List<string> _items = new List<string>();

    public IReadOnlyList<string> Items => _items;

    public void AddItem(string item)
    {
        if (string.IsNullOrEmpty(item))
            throw new ArgumentException("アイテム名は空にできません");
        _items.Add(item);
    }

    public bool RemoveItem(string item)
    {
        return _items.Remove(item);
    }

    public void Clear()
    {
        _items.Clear();
    }
}

テストクラス例

using NUnit.Framework;
using System;

[TestFixture]
public class InventoryManagerTests
{
    private InventoryManager _inventory;

    [SetUp]
    public void SetUp()
    {
        _inventory = new InventoryManager();
    }

    [Test]
    public void AddItem_ValidItem_IncreasesCount()
    {
        _inventory.AddItem("Potion");
        Assert.That(_inventory.Items.Count, Is.EqualTo(1), "アイテム追加後のカウントは1になるべき");
        Assert.That(_inventory.Items[0], Is.EqualTo("Potion"), "追加されたアイテムが正しい");
    }

    [Test]
    public void AddItem_EmptyString_ThrowsArgumentException()
    {
        Assert.That(() => _inventory.AddItem(""), 
                    Throws.ArgumentException.With.Message.Contain("空にできません"));
    }

    [Test]
    public void RemoveItem_ExistingItem_ReturnsTrueAndDecreasesCount()
    {
        _inventory.AddItem("Key");
        bool removed = _inventory.RemoveItem("Key");
        Assert.That(removed, Is.True, "既存アイテムは true を返す");
        Assert.That(_inventory.Items, Does.Not.Contain("Key"), "リストから削除されている");
    }

    [Test]
    public void Clear_OnMultipleItems_EmptiesInventory()
    {
        _inventory.AddItem("Sword");
        _inventory.AddItem("Shield");
        _inventory.Clear();
        Assert.That(_inventory.Items.Count, Is.Zero, "クリア後はアイテム数が0になるべき");
    }
}

これらの Edit Mode テスト例を参考に、

• 小さなロジック（計算処理や単純データ操作）から始め、
• セットアップ・検証を明確に分けることで、
• テストの可読性と 保守性 を高められます。

例1: シーンロードとプレイヤー生成確認

テスト概要

• シーン名：`MainScene`  
• 検証内容：シーン読み込み後に必ず `"Player"` という名前のゲームオブジェクトがシーン上に存在すること

テストコード例

using UnityEngine;
using UnityEngine.SceneManagement;
using UnityEngine.TestTools;
using NUnit.Framework;
using System.Collections;

public class SceneLoadTests
{
    private const string SceneName = "MainScene";

    [UnityTest]
    public IEnumerator LoadScene_PlayerIsSpawned()
    {
        // シーン読み込みイベントを待機するフラグ
        bool sceneLoaded = false;
        SceneManager.sceneLoaded += (scene, mode) => {
            if (scene.name == SceneName)
                sceneLoaded = true;
        };

        // シーンを非同期読み込み
        var loadOp = SceneManager.LoadSceneAsync(SceneName);
        yield return new WaitUntil(() => sceneLoaded && loadOp.isDone);

        // プレイヤーを検索
        var player = GameObject.Find("Player");
        Assert.IsNotNull(player, "MainScene 読み込み後に Player オブジェクトがシーン上に存在するはず");

        // プレイヤーの初期位置検証（例：ワールド原点付近）
        Vector3 pos = player.transform.position;
        Assert.That(pos, Is.TypeOf<Vector3>(), "Player の位置が Vector3 で取得できること");
        Assert.That(pos.magnitude, Is.LessThan(0.5f), "Player はワールド原点 (0,0,0) 付近にスポーンされるべき");
    }
}

例2: ユーザー入力シミュレーションと移動挙動検証

テスト概要

• プレイヤーに前進入力を送り、PlayerMovement コンポーネントによる移動が正しく行われることを確認
• Input.GetAxis(“Vertical") をモックして前進させる

テストコード例

using UnityEngine;
using UnityEngine.TestTools;
using NUnit.Framework;
using System.Collections;

// キーボード入力をプログラムから操作するヘルパークラス
public static class InputSimulator
{
    public static void SetVertical(float value)
    {
        // UnityEngine.InputSystem を使う場合はそちらを利用
        // ここでは Movement スクリプト内で参照している変数を直接書き換える想定
        PlayerInputMock.Vertical = value;
    }
}

// モック入力保持用（テスト用に用意しておく）
public static class PlayerInputMock
{
    public static float Vertical;
}

// プレイヤー移動スクリプト例
public class PlayerMovement : MonoBehaviour
{
    public float speed = 5f;
    void Update()
    {
        float v = PlayerInputMock.Vertical;  // 通常は Input.GetAxis("Vertical")
        transform.Translate(Vector3.forward * v * speed * Time.deltaTime);
    }
}

public class PlayerMovementTests
{
    [UnityTest]
    public IEnumerator PlayerMovesForward_WhenInputPositive()
    {
        // テスト用 GameObject とスクリプトを生成
        var go = new GameObject("Player");
        var movement = go.AddComponent<PlayerMovement>();
        movement.speed = 2f;

        // 初期位置を保存
        Vector3 startPos = go.transform.position;

        // 前進入力をシミュレート
        InputSimulator.SetVertical(1f);

        // 一フレームだけ待機して移動させる
        yield return null;  // Update が一度実行される

        Vector3 endPos = go.transform.position;
        Assert.That(endPos.z, Is.GreaterThan(startPos.z), "前進入力で Z 軸正方向に移動するはず");
        Assert.That((endPos - startPos).magnitude, Is.InRange(0.01f, 0.2f), "移動距離が speed * Time.deltaTime 程度であることを検証");
    }
}

例3: UI ボタン押下後の画面遷移テスト

テスト概要

• メインメニュー画面の「Start」ボタンをクリックし、GameScene へ遷移することを検証

テストコード例テストコード例

using UnityEngine;
using UnityEngine.SceneManagement;
using UnityEngine.UI;
using UnityEngine.TestTools;
using NUnit.Framework;
using System.Collections;

public class MenuFlowTests
{
    [UnityTest]
    public IEnumerator ClickStartButton_LoadsGameScene()
    {
        // メニューシーンを同期読み込み
        SceneManager.LoadScene("MenuScene");
        yield return null;

        // ボタン取得
        var buttonGO = GameObject.Find("StartButton");
        Assert.IsNotNull(buttonGO, "StartButton がシーン上に存在すること");
        var button = buttonGO.GetComponent<Button>();

        // SceneManager.sceneLoaded で遷移を待機
        bool sceneLoaded = false;
        SceneManager.sceneLoaded += (sc, mode) => {
            if (sc.name == "GameScene") sceneLoaded = true;
        };

        // ボタンのクリックをエミュレート
        button.onClick.Invoke();
        yield return new WaitUntil(() => sceneLoaded);

        Assert.AreEqual("GameScene", SceneManager.GetActiveScene().name, "ボタン押下後 GameScene に遷移すること");
    }
}

これらの詳細例を参考に、

• シーンの読み込み・イベント待機、
• フレーム単位での入力／移動シミュレーション、
• UI イベントのエミュレート

などを組み合わせて、実際のゲーム挙動を自動化テストできます。