本地日志

适用于 Fastboard Android SDK 1.8.2（内置 Whiteboard 2.16.131）。

Android 已内嵌日志运行时，通过 Native 配置开启，无需业务部署 Web Worker。

创建 SDK 前开启

Java

LoggerOptions logger = new LoggerOptions();
logger.setLocalLog(new LocalLogOptions().setEnabled(true).setEnabledUpload(true));
roomOptions.getSdkConfiguration().setLoggerOptions(logger);

状态与按需上报

Java

// FastRoom ready 后操作；不要重新创建内部 SDK。
fastRoom.getWhiteSdk().getLocalLogState(new Promise<JSONObject>() {
    @Override public void then(JSONObject state) { Log.i("Whiteboard", state.toString()); }
    @Override public void catchEx(SDKError error) { Log.e("Whiteboard", "状态查询失败", error); }
});
fastRoom.getWhiteSdk().uploadLocalLogs(new Promise<JSONObject>() {
    @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

fastRoom.setCommonCallback(new CommonCallback() {
    @Override public void onLocalLogStateChange(JSONObject state) {
        Log.i("Whiteboard", state.toString());
    }
});

将此方法合并到已有 CommonCallback，保持其他业务回调。Fastboard 通过 setCommonCallback 组合外部回调，不能覆盖内部 SDK 回调。

建议在错误反馈流程中按需收集/上传，记录结果并限制重复触发。自定义上传参数和返回字段以客户端 /api-ref/fastboard/android/fastboard-api为准；不要把不同平台的回调对象当作相同模型解析。