# 本地日志 (/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/extend-whiteboard/local-log/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Fastboard iOS SDK 1.4.6(依赖 Whiteboard 2.16.145)**。 iOS 已内嵌日志运行时,通过 Native 配置开启。 ## 创建 SDK 前开启 [#创建-sdk-前开启-1] ```swift let logs = WhiteLocalLogOptions() logs.enabled = true logs.enabledUpload = true config.whiteSdkConfiguration.localLogOptions = logs // config 为 FastRoomConfiguration,在创建 FastRoom 前设置。 ``` ## 状态与按需上报 [#状态与按需上报-1] ```swift // FastRoom 的 whiteSDK 已创建且宿主有效时调用。 fastRoom.whiteSDK.getLocalLogState { result, error in print(result as Any, error as Any) } fastRoom.whiteSDK.uploadLocalLogs { result, error in print(result as Any, error as Any) } ``` 状态查询用于确认运行时是否可用;配置 enabled=true 仍需结合状态确认,不能只据配置判断落盘成功。`collectLocalLogsWithCompletionHandler:` 收集导出结果,不等价于上传;`flushLocalLogsWithCompletionHandler:` 等待缓冲写入;`uploadLocalLogsWithCompletionHandler:` 触发上传,需要等待结果并处理失败。enabledUpload=false 时可以保留本地写入而关闭上传。 ```swift fastRoom.commonDelegate = self // 宿主实现 WhiteCommonCallbackDelegate。 func localLogStateChange(_ state: [AnyHashable: Any]) { print(state) } ``` 使用 commonDelegate 代理接收事件,保持宿主存活并避免覆盖内部 WhiteSDK delegate。 建议在错误反馈流程中按需收集/上传,记录结果并限制重复触发。自定义上传参数和返回字段以[客户端 /api-ref/fastboard/ios/fastboard-api](/zh-CN/api-reference/whiteboard/fastboard/ios)为准;不要把不同平台的回调对象当作相同模型解析。 iOS 12 及以下版本会强制关闭本地日志写入与上传,以规避 WKWebView Worker IndexedDB 的兼容问题;应读取状态确认可用性。