# 新版 API 与多窗口课件控制 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/native-api-extension/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Whiteboard iOS SDK 2.16.145**。使用 Objective-C 或 Swift Native 接口。 ## WhiteSDK [#whitesdk] ```objc - (void)reloadBackgroundImage:(WhiteReloadBackgroundImageParams *)params completionHandler:(WhiteReloadBackgroundImageCompletionHandler)completionHandler; - (void)hasBackgroundImage:(WhiteHasBackgroundImageParams *)params completionHandler:(WhiteHasBackgroundImageCompletionHandler)completionHandler; ``` ## WhiteRoom [#whiteroom] ```objc - (void)addApp:(WhiteAppParam *)appParams completionHandler:(void (^)(NSString * _Nullable appId))completionHandler; - (void)fitOriginSizeAndCamera; - (void)focusApp:(NSString *)appId; - (void)focusApp:(NSString *)appId completionHandler:(void (^ _Nullable)(BOOL committed))completionHandler; - (void)dispatchDocsEvent:(WhiteWindowDocsEventKey)docsEvent options:(WhiteWindowDocsEventOptions * _Nullable)options completionHandler:(void (^)(WhiteDispatchDocsEventResult *result))completionHandler; - (void)querySlidePageState:(NSString * _Nullable)appId completionHandler:(void (^)(WhiteSlidePageState * _Nullable pageState, NSError * _Nullable error))completionHandler; - (void)getPageState:(WhiteWindowPageStateOptions * _Nullable)options completionHandler:(void (^)(WhiteUnifiedPageState * _Nullable pageState, NSError * _Nullable error))completionHandler; ``` ## 统一页面控制 [#统一页面控制-1] MainView、DocsViewer、Slide、Presentation 的 page 从 1 开始;target 输入可为 mainView 或 appId,省略时跟随焦点。查询输出的 target 为 mainView/DocsViewer/Slide/Presentation。scale 为相对适配尺寸倍率,1 表示适配尺寸,DocsViewer 不支持 scalePage。 accepted=true 表示命令接收;accepted=false 包含 reason/message。通过统一页事件或查询观察实际状态,不能把命令回调作为首帧完成信号。 ## 窗口与课件配置 [#窗口与课件配置] | 参数 | 行为 | | --- | --- | | originSize | 正数 width/height 参考尺寸;MainView 与各 App 分别设置 | | pageScaleRange | 相对适配尺寸的 minScale/maxScale,均为有限正数 | | forceMaximized | 房间级强制最大化,与 useBoxesStatus 不兼容 | | lazySetupInMaximizedMode | 本端按焦点初始化,默认关闭 | | maxCachedAppsInMaximizedMode | 本端 LRU runtime 缓存,默认 4 | | navigationButtonMode | Slide 底部按钮:page 默认按页,step 按动画步骤 | | syncEventQueuePolicy | fifo 默认;latest-pending-render 仅合并待执行渲染页 | focusApp 的布尔值表示焦点提交完成;不能用它判断 setup 或全部资源就绪。插入课件需先转换,普通图片页可以创建 Presentation;原有静态文档 API 保持 DocsViewer 行为。 ## 插件背景与本端回调 [#插件背景与本端回调] 背景配置与查询/恢复见[背景图加载与恢复](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/background-image-recovery)。WhiteCommonCallbackDelegate 的背景图与初始化回调使用 WhiteBackgroundImageLoadEvent、WhiteApplianceInitLoadingChangeEvent;统一页事件通过 WhiteRoomCallbackDelegate.onUnifiedPageStateChange 接收。