📝 LogRecoder（日志记录）模块 · 开发者指南

---

🧠 模块介绍

LogRecoder（日志记录）模块，用于灵活控制设备日志的开启、定时、查询与导出，助力高效运维与问题追踪。

---

🛠️ PanelSDK 初始化

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

---

🧩 核心方法 · 专业解读

🔘 enableLogRecoder — 开启/关闭日志记录

int enableLogRecoder(boolean enable)

参数说明

参数	类型	说明
enable	boolean	true 开启，false 关闭

返回值说明

返回值	说明
0	成功
-1	失败

典型场景代码

// 开启日志记录功能
int result = panelSDK.enableLogRecoder(true);
if (result == 0) {
    // 🎉 开启成功
    Log.d("LogRecoder", "日志记录功能已开启");
} else {
    // ❌ 开启失败
    Log.e("LogRecoder", "开启失败，错误码: " + result);
}

---

⏰ setRecoderTime — 设置日志记录时间

int setRecoderTime(int hour)

参数说明

参数	类型	说明
hour	int	记录时间（小时）

返回值说明

返回值	说明
0	成功
-1	失败

典型场景代码

// 设置日志记录时间为24小时
int result = panelSDK.setRecoderTime(24);
if (result == 0) {
    // ✅ 设置成功
    Log.d("LogRecoder", "日志记录时间已设置为24小时");
} else {
    // ❌ 设置失败
    Log.e("LogRecoder", "设置失败，错误码: " + result);
}

---

🟢 isLogRecoderEnabled — 查询日志记录功能是否开启

boolean isLogRecoderEnabled()

返回值说明

返回值	说明
true/false	true 开启，false 关闭或失败

典型场景代码

// 查询日志记录功能是否已开启
boolean isEnabled = panelSDK.isLogRecoderEnabled();
if (isEnabled) {
    // ✅ 日志记录功能已开启
    Log.d("LogRecoder", "日志记录功能已开启");
} else {
    // ⚠️ 日志记录功能未开启或查询失败
    Log.w("LogRecoder", "日志记录功能未开启");
}

---

🕒 getRecoderTime — 查询日志记录时间

int getRecoderTime()

返回值说明

返回值	说明
int	记录时间（小时）

典型场景代码

// 查询日志记录时间
int hour = panelSDK.getRecoderTime();
if (hour > 0) {
    // ✅ 获取成功
    Log.d("LogRecoder", "日志记录时间: " + hour + " 小时");
} else {
    // ⚠️ 获取失败或未设置
    Log.w("LogRecoder", "日志记录时间获取失败或未设置");
}

---

📤 logExport — 导出日志

String logExport()

返回值说明

返回值	说明
String	日志字符串

典型场景代码

// 导出日志
String logs = panelSDK.logExport();
if (logs != null && !logs.isEmpty()) {
    // ✅ 导出成功
    Log.d("LogRecoder", "日志导出成功，大小: " + logs.length() + " 字符");
    // 可以将日志保存到文件或上传到服务器
    // saveToFile(logs);
} else {
    // ⚠️ 无日志或导出失败
    Log.w("LogRecoder", "无日志或导出失败");
}

---

⚡ 专业进阶 · 技术要点

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

---

🏆 专业总结

只需一个 PanelSDK 实例，日志采集与导出一站式搞定。无论是问题追踪、批量运维还是合规审计，LogRecoder 模块让你的设备日志管理更高效、更智能！

---