Panel SDK

Appearance

🖥️ SystemUi（系统UI管理）模块 · 开发者指南 ​

🧠 模块介绍 ​

SystemUi（系统UI管理）模块，用于灵活控制状态栏、导航栏、户外模式等系统UI元素，适合多场景定制与批量运维。

🛠️ PanelSDK 初始化 ​

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

🧩 核心方法 · 专业解读 ​

🟦 setStatusBarShowStatus — 设置状态栏显示 ​

java
int setStatusBarShowStatus(int status)
参数说明
参数类型说明
statusint1显示，0隐藏
返回值说明
返回值说明
0成功
其他失败
典型场景代码
java
// 显示状态栏
int result = panelSDK.setStatusBarShowStatus(1);
if (result == 0) {
    // ✅ 设置成功
    Log.d("SystemUi", "状态栏已显示");
} else {
    // ❌ 设置失败
    Log.e("SystemUi", "设置失败，错误码: " + result);
}

🟦 getStatusBarShowStatus — 获取状态栏显示状态 ​

java
int getStatusBarShowStatus()
返回值说明
返回值说明
0隐藏
1显示
其他错误代码
典型场景代码
java
// 获取状态栏显示状态
int status = panelSDK.getStatusBarShowStatus();
if (status == 1) {
    // ✅ 状态栏已显示
    Log.d("SystemUi", "状态栏已显示");
} else if (status == 0) {
    // ⚠️ 状态栏已隐藏
    Log.w("SystemUi", "状态栏已隐藏");
} else {
    // ❌ 获取失败
    Log.e("SystemUi", "获取失败，错误码: " + status);
}

🟥 setNavigationBarShowStatus — 设置导航栏显示 ​

java
int setNavigationBarShowStatus(int status)
参数说明
参数类型说明
statusint0隐藏，1显示
返回值说明
返回值说明
0成功
其他失败
典型场景代码
java
// 隐藏导航栏
int result = panelSDK.setNavigationBarShowStatus(0);
if (result == 0) {
    // ✅ 设置成功
    Log.d("SystemUi", "导航栏已隐藏");
} else {
    // ❌ 设置失败
    Log.e("SystemUi", "设置失败，错误码: " + result);
}

🚫 getNavigationShowStatus — 获取导航栏显示状态 ​

java
int getNavigationShowStatus()
返回值说明
返回值说明
0隐藏
1显示
其他错误代码
典型场景代码
java
// 获取导航栏显示状态
int result = panelSDK.getNavigationShowStatus();
if (status == 1) {
        // ✅ 导航栏已显示
        Log.d("SystemUi", "导航栏已显示");
} else if (status == 0) {
        // ⚠️ 导航栏已隐藏
        Log.w("SystemUi", "导航栏已隐藏");
} else {
        // ❌ 获取失败
        Log.e("SystemUi", "获取失败，错误码: " + status);
}

🚫 disableStatusBarItem — 禁止SystemUI中控件显示 ​

java
int disableStatusBarItem(int flag)
参数说明
参数类型说明
flagint禁止标志，详见文档状态码-UI功能禁用
返回值说明
返回值说明
0成功
其他失败
典型场景代码
java
// 禁止状态栏下拉
int result = panelSDK.disableStatusBarItem(UI_DISABLE_EXPAND);
if (result == 0) {
    // ✅ 设置成功
    Log.d("SystemUi", "状态栏下拉已禁止");
} else {
    // ❌ 设置失败
    Log.e("SystemUi", "设置失败，错误码: " + result);
}

⚡ 专业进阶 · 技术要点 ​

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

🏆 专业总结 ​

只需一个 PanelSDK 实例，系统UI元素灵活管控一站式搞定。无论是批量运维、场景适配还是智能定制，SystemUi 模块让你的设备更美观、更高效！