本地日志

  • HarmonyOS

更新时间

适用于 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 }
};

状态与按需上报

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为准;不要把不同平台的回调对象当作相同模型解析。