Unity NavMesh.SamplePosition 完全ガイド

2026年4月27日

NavMesh上の有効な位置を取得する方法

1. NavMeshとは
2. なぜ位置の補正が必要なのか
3. NavMesh.SamplePositionの基本
- 3.1. メソッドの定義
- 3.2. 引数の意味
4. 基本コード（最も近いNavMesh位置を取得）
- 4.1. ポイント
5. 実践① クリック位置を補正して移動
- 5.1. 授業での理解ポイント
6. 実践② NavMesh上にオブジェクトをスポーン
7. 実践③ ランダムなNavMesh位置を取得
8. よくあるミス
9. パフォーマンス注意
10. まとめ
11. 最重要ポイント

NavMeshとは

NavMesh（ナビゲーションメッシュ）は、
「キャラクターが歩ける場所」を示した地図です。

歩ける場所 → Walkable
歩けない場所 → Not Walkable

NavMeshAgentは、この地図を使って移動します。

なぜ位置の補正が必要なのか

ゲームではよくこういう状況が起きます：

クリックした位置がNavMesh外
ランダム生成した座標が壁の中
スポーン位置が移動不可エリア

このままだと：

キャラが動かない
ワープできない
不自然な挙動になる

そこで使うのが

NavMesh.SamplePosition

です。

NavMesh.SamplePositionの基本

メソッドの定義

public static bool SamplePosition(
    Vector3 sourcePosition,
    out NavMeshHit hit,
    float maxDistance,
    int areaMask
);

引数の意味

引数	内容
sourcePosition	基準となる位置
hit	結果（NavMeshHit）
maxDistance	探索する半径
areaMask	対象エリア

基本コード（最も近いNavMesh位置を取得）

using UnityEngine;
using UnityEngine.AI;

public class NavMeshUtil
{
    public static Vector3 GetNearestPosition(Vector3 target, float maxDistance = 10f)
    {
        NavMeshHit hit;

        if (NavMesh.SamplePosition(target, out hit, maxDistance, NavMesh.AllAreas))
        {
            return hit.position;
        }

        Debug.LogWarning("NavMesh上に位置が見つかりません");
        return target;
    }
}

ポイント

true → 見つかった
false → 見つからない
hit.position → 有効な座標

実践① クリック位置を補正して移動

void Update()
{
    if (Input.GetMouseButtonDown(0))
    {
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);

        if (Physics.Raycast(ray, out RaycastHit hitInfo))
        {
            NavMeshHit navHit;

            if (NavMesh.SamplePosition(hitInfo.point, out navHit, 2.0f, NavMesh.AllAreas))
            {
                transform.position = navHit.position;
            }
        }
    }
}

授業での理解ポイント

クリック位置は信用しない → 必ずNavMeshに乗せる

実践② NavMesh上にオブジェクトをスポーン

public GameObject prefab;

void Start()
{
    Vector3 randomPos = new Vector3(
        Random.Range(-10, 10),
        0,
        Random.Range(-10, 10)
    );

    NavMeshHit hit;

    if (NavMesh.SamplePosition(randomPos, out hit, 5.0f, NavMesh.AllAreas))
    {
        Instantiate(prefab, hit.position, Quaternion.identity);
    }
}

実践③ ランダムなNavMesh位置を取得

public Vector3 GetRandomPosition(float range)
{
    Vector3 random = Random.insideUnitSphere * range;
    random += transform.position;

    return NavMeshUtil.GetNearestPosition(random, range);
}