# 本地日志 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/local-log/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Whiteboard Android SDK 2.16.134**。 Android 已内嵌日志运行时,通过 Native 配置开启,无需业务部署 Web Worker。 ## 创建 SDK 前开启 [#创建-sdk-前开启] ```java LoggerOptions logger = new LoggerOptions(); logger.setLocalLog(new LocalLogOptions().setEnabled(true).setEnabledUpload(true)); config.setLoggerOptions(logger); ``` ## 状态与按需上报 [#状态与按需上报] ```java // SDK 初始化完成后操作。 whiteSdk.getLocalLogState(new Promise() { @Override public void then(JSONObject state) { Log.i("Whiteboard", state.toString()); } @Override public void catchEx(SDKError error) { Log.e("Whiteboard", "状态查询失败", error); } }); whiteSdk.uploadLocalLogs(new Promise() { @Override public void then(JSONObject result) { Log.i("Whiteboard", result.toString()); } @Override public void catchEx(SDKError error) { Log.e("Whiteboard", "上传失败", error); } }); ``` 状态查询用于确认运行时是否可用;配置 enabled=true 仍需结合状态确认,不能只据配置判断落盘成功。`collectLocalLogs` 收集导出结果,不等价于上传;`flushLocalLogs` 等待缓冲写入;`uploadLocalLogs` 触发上传,需要等待结果并处理失败。enabledUpload=false 时可以保留本地写入而关闭上传。 ```java whiteSdk.setCommonCallbacks(new CommonCallback() { @Override public void onLocalLogStateChange(JSONObject state) { Log.i("Whiteboard", state.toString()); } }); ``` 将此方法合并到已有 CommonCallback,保持其他业务回调。 建议在错误反馈流程中按需收集/上传,记录结果并限制重复触发。自定义上传参数和返回字段以[客户端 /api-ref/whiteboard/android/overview](/zh-CN/api-reference/whiteboard/whiteboard-sdk/android/overview)为准;不要把不同平台的回调对象当作相同模型解析。