Android平台下LibGDX相机旋转功能失效问题排查

1. 渲染顺序完全错误 #

你当前的代码逻辑是先渲染模型，再更新相机状态——这意味着每一帧渲染用的都是上一帧的相机参数，当前帧的旋转更新根本没参与渲染，自然看不到模型旋转变化。

正确的执行顺序必须是：

• 先获取/计算姿态角
• 更新相机旋转并调用cam.update()
• 最后执行渲染操作

修正后的render()方法结构：

@Override
public void render() {
    ScreenUtils.clear(Color.BLACK, true);

    // 第一步：更新相机状态
    float Yaw = ...;
    float Pitch = ...;
    float Roll = ...;

    // 处理相机旋转
    cam.view.setFromEulerAngles(Yaw, Pitch, Roll);
    cam.update();
    
    // 第二步：执行渲染
    modelBatch.begin(cam);
    modelBatch.render(instance, lights);
    modelBatch.end();
}

2. 角度单位不匹配：度数 vs 弧度 #

LibGDX的Matrix4.setFromEulerAngles()方法要求传入弧度值，但你从传感器获取的是度数。直接传度数的话，实际旋转量会被缩小到原来的1/57左右（1弧度≈57.3度），肉眼几乎察觉不到变化。

解决方法：用LibGDX内置的MathUtils.degreesToRadians常量将度数转换为弧度：

float yawRad = Yaw * MathUtils.degreesToRadians;
float pitchRad = Pitch * MathUtils.degreesToRadians;
float rollRad = Roll * MathUtils.degreesToRadians;
cam.view.setFromEulerAngles(yawRad, pitchRad, rollRad);

3. 坐标系与欧拉角顺序的适配问题 #

Android传感器的姿态角坐标系和LibGDX相机的默认坐标系存在差异，可能导致旋转方向或轴对应错误：

• Android传感器的Yaw（偏航）绕垂直地面的Z轴旋转，而LibGDX相机默认Z轴是从屏幕指向用户（向外），Y轴向上
• 传感器的Pitch（俯仰）绕手机横向X轴旋转，Roll绕手机纵向Y轴旋转

如果转成弧度后旋转方向仍不对，可以尝试调整欧拉角的符号或顺序，比如：

// 反转Yaw方向，或调整参数顺序，根据实际测试效果修改
cam.view.setFromEulerAngles(-yawRad, pitchRad, rollRad);

建议先解决前两个问题，再通过实际测试微调角度的符号和顺序，找到最匹配的效果。

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