# 本地日志 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/local-log/harmonyos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Whiteboard HarmonyOS SDK 0.2.11**。 HarmonyOS 已内嵌日志运行时,通过 WhiteboardOptions 配置开启。 ## 入房前开启 [#入房前开启] ```typescript const options: WhiteboardOptions = { appIdentifier: appIdentifier, roomUuid: roomUuid, roomToken: roomToken, uid: uid, region: Region.CN_HZ, localLogOptions: { enabled: true, enabledUpload: true } }; ``` ## 状态与按需上报 [#状态与按需上报-3] ```typescript try { console.info(JSON.stringify(await controller.getLocalLogState())); console.info(JSON.stringify(await controller.uploadLocalLogs())); } catch (error) { console.warn('本地日志操作失败'); } ``` 状态查询用于确认运行时是否可用;配置 enabled=true 仍需结合状态确认,不能只据配置判断落盘成功。`collectLocalLogs` 收集导出结果,不等价于上传;`flushLocalLogs` 等待缓冲写入;`uploadLocalLogs` 触发上传,需要等待结果并处理失败。enabledUpload=false 时可以保留本地写入而关闭上传。 ```typescript const callbacks = new WhiteboardCallbacks().setOnLocalLogStateChange(state => { console.info(JSON.stringify(state)); }); // 将 callbacks 放入本次 WhiteboardOptions。 ``` 建议在错误反馈流程中按需收集/上传,记录结果并限制重复触发。自定义上传参数和返回字段以[客户端 /api-ref/whiteboard/harmonyos/overview](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)为准;不要把不同平台的回调对象当作相同模型解析。