Panel SDK

Appearance

🖥️🌡️ 硬件状态（HardwareStatus）模块 · 开发者指南 ​

🧠 模块介绍 ​

硬件状态模块，用于实时获取设备 CPU、运行时间等硬件信息。适合批量运维、健康监控场景。

🛠️ PanelSDK 初始化 ​

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

🧩 核心方法 · 专业解读 ​

🏷️ getCpuUsage — 获取CPU占用率 ​

java
int getCpuUsage()
参数说明
参数类型说明
无无参数
返回值说明
返回值说明
int成功返回CPU使用率
-1未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2设备不支持该功能
-3SDK版本不支持该功能
-5服务未启动
典型场景代码
java
int cpuUsage = panelSDK.getCpuUsage();
if (cpuUsage >= 0) {
    // 🎉 获取成功，CPU使用率：${cpuUsage}%
} else if (cpuUsage == -1) {
    // ❗ 未知错误，建议检查日志
} else if (cpuUsage == -2) {
    // 🚫 设备不支持该功能
} else if (cpuUsage == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (cpuUsage == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考错误码表
}

🏷️ getCpuTemperature — 获取CPU温度 ​

java
int getCpuTemperature()
参数说明
参数类型说明
无无参数
返回值说明
返回值说明
int成功返回温度值
-1未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2设备不支持该功能
-3SDK版本不支持该功能
-5服务未启动
典型场景代码
java
int temperature = panelSDK.getCpuTemperature();
if (temperature >= 0) {
    // 🎉 获取成功，CPU温度：${temperature}℃
} else if (temperature == -1) {
    // ❗ 未知错误，建议检查日志
} else if (temperature == -2) {
    // 🚫 设备不支持该功能
} else if (temperature == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (temperature == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考错误码表
}

🏷️ getUpTime — 获取设备运行时间 ​

java
long getUpTime()
参数说明
参数类型说明
无无参数
返回值说明
返回值说明
long成功返回运行时间（毫秒）
-1未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2设备不支持该功能
-3SDK版本不支持该功能
-5服务未启动
典型场景代码
java
long upTime = panelSDK.getUpTime();
if (upTime >= 0) {
    // 🎉 获取成功，运行时间：${upTime}毫秒
} else if (upTime == -1) {
    // ❗ 未知错误，建议检查日志
} else if (upTime == -2) {
    // 🚫 设备不支持该功能
} else if (upTime == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (upTime == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考错误码表
}

🏷️ getExternalCameraDegree — 获取扩展摄像头取景画面默认角度 ​

java
int getExternalCameraDegree();
参数说明
参数类型说明
无无参数
返回值说明
返回值说明
int成功返回扩展摄像头默认角度（度）
-1未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2设备不支持该功能
-3SDK版本不支持该功能
-5服务未启动
典型场景代码
java
int degree = panelSDK.getExternalCameraDegree();
if (degree >= 0) {
    // 🎉 获取成功，当前扩展摄像头默认角度:${degree}度
} else if (degree == -1) {
    // ❗ 未知错误，建议检查日志
} else if (degree == -2) {
    // 🚫 设备不支持该功能
} else if (degree == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (degree == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考错误码表
}

🏷️ setExternalCameraDegree — 设置扩展摄像头取景画面默认角度 ​

java
int setExternalCameraDegree(int degree);
参数说明
参数类型说明
degreeint默认角度，注意设备重启后生效
返回值说明
返回值说明
0设置成功
-1未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2设备不支持该功能
-3SDK版本不支持该功能
-5服务未启动
典型场景代码
java
int result = panelSDK.setExternalCameraDegree(90);
if (result == 0) {
        // 🎉 设置成功，默认桌面已切换
} else if (result == -1) {
    // ❗ 未知错误，建议检查日志
} else if (result == -2) {
    // 🚫 设备不支持该功能
} else if (result == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (result == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考错误码表
}

⚡ 专业进阶 · 技术要点 ​

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

🏆 专业总结 ​

只需一个 PanelSDK 实例，硬件状态随时掌控。无论是批量运维、健康监控还是智能风控，HardwareStatus 模块让你的设备管理更专业、更高效！