LibGDX相机旋转：如何实现类似Minecraft的俯仰偏航控制？

嘿，我完全懂你用LibGDX相机旋转时的头疼——轴角旋转那套确实绕，尤其是刚接触3D开发的时候，我之前也踩过这个坑。后来摸索出了适配Minecraft风格俯仰（Pitch）/偏航（Yaw）的控制方法，给你详细拆解一下：

核心思路是放弃直接用LibGDX相机的rotate(Vector3 axis, float angle)方法，转而自己维护yaw和pitch两个角度变量，通过三角函数计算相机的方向向量——这和Minecraft的视角逻辑完全一致，也避开了轴角旋转的复杂度。

1. 初始化基础变量 #

先定义两个全局变量存储视角角度，再设置相机的初始位置：

// 偏航角（Y轴旋转，左右看），初始值0代表正前方
private float yaw = 0f;
// 俯仰角（X轴旋转，上下看），初始值0代表水平向前
private float pitch = 0f;
// 相机初始位置（比如玩家出生点）
private PerspectiveCamera camera = new PerspectiveCamera(67, Gdx.graphics.getWidth(), Gdx.graphics.getHeight());

// 在create()里初始化
camera.position.set(0, 2, 5); // 位置：x=0，y=2（玩家高度），z=5
camera.near = 0.1f;
camera.far = 100f;

2. 处理输入更新角度 #

通过鼠标移动来更新yaw和pitch，记得限制俯仰角的范围（防止相机翻跟头）：

// 在render()或input处理器里获取鼠标偏移
float mouseDeltaX = Gdx.input.getDeltaX();
float mouseDeltaY = Gdx.input.getDeltaY();

// 灵敏度可调，比如0.1f，数值越大视角转动越快
float sensitivity = 0.1f;
yaw += mouseDeltaX * sensitivity;
// 这里用减法是因为鼠标向上移动时，相机应该抬头（pitch增加）
pitch -= mouseDeltaY * sensitivity;

// 限制pitch在-90°到90°之间，避免相机翻转到背面
pitch = MathUtils.clamp(pitch, -90f, 90f);

3. 根据角度计算相机方向 #

用三角函数把欧拉角（yaw/pitch）转换成3D方向向量，再让相机看向这个方向：

Vector3 direction = new Vector3();
// 球面坐标转笛卡尔坐标：计算前向向量
direction.x = MathUtils.cos(MathUtils.degRad * yaw) * MathUtils.cos(MathUtils.degRad * pitch);
direction.y = MathUtils.sin(MathUtils.degRad * pitch);
direction.z = MathUtils.sin(MathUtils.degRad * yaw) * MathUtils.cos(MathUtils.degRad * pitch);

// 归一化向量，确保方向长度始终为1，避免视角缩放问题
direction.nor();

// 让相机看向当前位置 + 方向向量的点（也就是正前方）
camera.lookAt(camera.position.cpy().add(direction));
// 必须更新相机的矩阵，否则视角不会生效
camera.update();

LibGDX的rotate()是基于局部轴的轴角旋转，多次旋转后容易出现万向锁（比如俯仰到90°时，偏航和翻滚会变成同一个轴），而且很难精确控制俯仰/偏航的角度范围。自己维护yaw和pitch变量，每次重新计算方向，反而更稳定，逻辑也更符合Minecraft的第一人称视角逻辑。

• LibGDX官方3D入门文档：里面详细讲解了相机的投影矩阵、视图矩阵原理，是理解3D相机的基础，建议先吃透这部分。
• LibGDX社区第一人称相机示例：社区里很多开发者分享过完整的第一人称视角代码，你可以搜索“LibGDX first person camera”找到相关讨论，里面会包含鼠标捕获、按键移动结合视角的完整逻辑。
• 3D数学基础：不用啃大部头，先理解欧拉角（Yaw/Pitch/Roll）和笛卡尔坐标的转换，以及向量的基本运算（归一化、点乘、叉乘）——LibGDX的MathUtils和Vector3类已经封装了这些操作，多看看API文档就能快速上手。

内容的提问来源于stack exchange，提问作者Juliano Hilario