CharacterController.isGrounded

判断物体是否在地面上，但只有在移动中才进行检测。（在最后的移动中是否触地）

定义

public bool isGrounded;

示例

这是对 CharacterController.Move 中示例的补充，添加了跳跃功能。

由于使用 Move 而不是 SimpleMove，所以需要自己处理重力。

using System;
using UnityEngine;

[RequireComponent(typeof(CharacterController))]
public class ExampleScript : MonoBehaviour
{
    public float moveSpeed = 2.0f; // 移动速度
    public float gravity = 9.8f; // 重力大小
    public float jumpHeight = 2f; // 跳跃高度
    public float sensitivity = 2f; // 鼠标灵敏度

    private CharacterController _controller;
    private float _ySpeed; // Y 轴速度

    private void PlayerRotate()
    {
        var mouseX = Input.GetAxis("Mouse X") * sensitivity;
        transform.Rotate(Vector3.up * mouseX);
    }

    private void PlayerMove()
    {
        var motion =
            transform.right * Input.GetAxis("Horizontal") +
            transform.forward * Input.GetAxis("Vertical");
        motion *= moveSpeed;

        // 跳跃
        switch (_controller.isGrounded)
        {
            case true when Input.GetKeyDown(KeyCode.Space):
                _ySpeed = (float) Math.Sqrt(2 * gravity * jumpHeight);
                break;
            case true:
                _ySpeed = 0;
                break;
            case false:
                _ySpeed -= gravity * Time.deltaTime; // 重力
                break;
        }
        motion += transform.up * _ySpeed;

        _controller.Move(motion * Time.deltaTime);
    }

    private void Start()
    {
        _controller = GetComponent<CharacterController>();
    }

    private void Update()
    {
        PlayerRotate();
        PlayerMove();
    }
}

注意

上述示例也许并不好用，因为 isGrounded 只有角色移动时（调用 SimpleMove 或 Move时）才会进行检测，并且 CharacterController 的 Skin Width 也会对其影响。

建议自己实现地面检测功能，方法有多种，这里使用最简单的 Raycast，关于 Raycast 的用法在 Physics/Raycast 中有介绍。

private bool IsGrounded()
{
    var playTransform = transform;
    var origin = playTransform.position - new Vector3(0, 1f, 0);  // 人物胶囊体底部
    return Physics.Raycast(origin, -playTransform.up, 0.01f, groundLayer);  // 发射长度为 0.01 的射线，判断是否与地面相交
}

将 IsGrounded 替代原本代码中的 _controller.isGrounded，全部代码如下：

using System;
using UnityEngine;

[RequireComponent(typeof(CharacterController))]
public class ExampleScript : MonoBehaviour
{
    public float moveSpeed = 2.0f;  // 移动速度
    public float gravity = 9.8f;  // 重力大小
    public float jumpHeight = 2f;  // 跳跃高度
    public float sensitivity = 2f;  // 鼠标灵敏度
    public LayerMask groundLayer;  // 地面层级

    private CharacterController _controller;
    private float _ySpeed; // Y 轴速度

    private void PlayerRotate()
    {
        var mouseX = Input.GetAxis("Mouse X") * sensitivity;
        transform.Rotate(Vector3.up * mouseX);
    }

    private void PlayerMove()
    {
        var motion =
            transform.right * Input.GetAxis("Horizontal") +
            transform.forward * Input.GetAxis("Vertical");
        motion *= moveSpeed;

        // 跳跃
        switch (IsGrounded())
        {
            case true when Input.GetKeyDown(KeyCode.Space):
                _ySpeed = (float) Math.Sqrt(2 * gravity * jumpHeight);
                break;
            case true:
                _ySpeed = 0;
                break;
            case false:
                _ySpeed -= gravity * Time.deltaTime; // 重力
                break;
        }
        motion += transform.up * _ySpeed;

        _controller.Move(motion * Time.deltaTime);
    }

    private bool IsGrounded()
    {
        var playTransform = transform;
        var origin = playTransform.position - new Vector3(0, 1f, 0);  // 人物胶囊体底部
        return Physics.Raycast(origin, -playTransform.up, 0.01f, groundLayer); // 发射长度为 0.01 的射线，判断是否与地面相交
}
    }

    private void Start()
    {
        _controller = GetComponent<CharacterController>();
    }

    private void Update()
    {
        PlayerRotate();
        PlayerMove();
    }
}