🔄 Rotation（屏幕方向）模块 · 开发者指南

---

🧠 模块介绍

Rotation（屏幕方向）模块，用于灵活设置和查询主屏幕系统方向，支持竖屏、横屏、反向竖屏、反向横屏，满足多场景需求。

---

🛠️ PanelSDK 初始化

// 推荐在 Application 或 Activity 中初始化，确保全局唯一
PanelSDK panelSDK = new PanelSDK(this);

---

🧩 核心方法 · 专业解读

🔃 setSystemRotation — 设置主屏幕方向

int setSystemRotation(int rotation)

参数说明

参数	类型	说明
rotation	int	0:竖屏，90:横屏，180:反向竖屏，270:反向横屏

返回值说明

返回值	说明
0	设置成功
-5	服务未启动
-702	主屏幕系统方向错误
-704	屏幕方向参数不规范
其他	参考错误码表

典型场景代码

// 设置屏幕为横屏（90度）
int result = panelSDK.setSystemRotation(90);
if (result == 0) {
    // ✅ 设置成功
    Log.d("Rotation", "屏幕已设置为横屏");
} else if (result == -5) {
    // ❌ 服务未启动
    Log.e("Rotation", "服务未启动");
} else if (result == -704) {
    // ❌ 参数不规范
    Log.e("Rotation", "屏幕方向参数不规范");
} else {
    // ❌ 其他错误
    Log.e("Rotation", "设置失败，错误码: " + result);
}

---

🧭 getSystemRotation — 获取主屏幕方向

int getSystemRotation()

返回值说明

返回值	说明
0	竖屏
90	横屏
180	反向竖屏
270	反向横屏

典型场景代码

// 获取当前屏幕方向
int rotation = panelSDK.getSystemRotation();
switch (rotation) {
    case 0:
        // ✅ 竖屏
        Log.d("Rotation", "当前屏幕方向: 竖屏");
        break;
    case 90:
        // ✅ 横屏
        Log.d("Rotation", "当前屏幕方向: 横屏");
        break;
    case 180:
        // ✅ 反向竖屏
        Log.d("Rotation", "当前屏幕方向: 反向竖屏");
        break;
    case 270:
        // ✅ 反向横屏
        Log.d("Rotation", "当前屏幕方向: 反向横屏");
        break;
    default:
        // ❌ 获取失败
        Log.e("Rotation", "获取屏幕方向失败，错误码: " + rotation);
        break;
}

---

⚡ 专业进阶 · 技术要点

所有方法均为同步调用，返回值可直接判断结果，适合批量自动化脚本。 推荐在具备系统权限的环境下调用，部分功能需 Root 或系统签名。 依赖底层 StRotationManager，请确保相关依赖已集成并兼容目标设备。 支持企业级批量方向策略下发、灵活切换。

---

🏆 专业总结

只需一个 PanelSDK 实例，屏幕方向灵活切换与查询一站式搞定。无论是多场景适配、批量运维还是智能控制，Rotation 模块让你的设备更灵活、更高效！

---