Protocol

2026-01-16


ZegoSuperBoardManagerDelegate	ZegoSuperBoardSubViewDelegate
ZegoSuperBoardViewDelegate

ZegoSuperBoardManagerDelegate

ZegoSuperBoardManager 的一些同步信息和错误信息回调

Declared in ZegoSuperBoardManager.h

方法

onError:error:

- (void)onError:(ZegoSuperBoardError) error;

SuperBoard发生内部错误产生的回调通知，可根据对应的错误码知道具体的错误类型，错误码见 ZegoSuperBoardError

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
error	ZegoSuperBoardError

通知时机：使用ZegoSuperBoard SDK过程中的错误回调。

支持版本：v2.0.0。

onRemoteSuperBoardSubViewAdded:model:

- (void)onRemoteSuperBoardSubViewAdded:(ZegoSuperBoardSubViewModel *) model;

收到SuperBoardSubView新增的回调

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
model	ZegoSuperBoardSubViewModel *	对应新增的SuperBoardSubView的model

通知时机：同一房间内其他用户成功创建白板或者文件(调用 [createWhiteboardView]、[createFileView])后，本端会收到此通知。

支持版本：v2.0.0。

onRemoteSuperBoardSubViewRemoved:model:

- (void)onRemoteSuperBoardSubViewRemoved:(ZegoSuperBoardSubViewModel *) model;

接收到SuperBoardSubView销毁信息的回调

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
model	ZegoSuperBoardSubViewModel *	对应的SuperBoardSubView的model

通知时机：同一房间内其他成员成功销毁ZegoSuperBoardSubView（调用 [destroySuperBoardSubView]）后，本端会收到此通知。

支持版本：v2.0.0。

onRemoteSuperBoardSubViewSwitched:uniqueID:

- (void)onRemoteSuperBoardSubViewSwitched:(NSString *) uniqueID;

接收到SuperBoardSubView切换的消息回调

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
uniqueID	NSString *	切换到的对应的SuperBoardSubView的唯一标识uniqueID

通知时机：同一房间内其他成员成功切换ZegoSuperBoardSubView（调用 [switchSubView]）后，本端会收到此通知。

支持版本：v2.0.0。

onRemoteSuperBoardAuthChanged:authInfo:

- (void)onRemoteSuperBoardAuthChanged:(NSDictionary *) authInfo;

收到SuperBoardSubView操作权限变更后的回调方法

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
authInfo	NSDictionary *	authInfo 包含 scale、scroll 2个key value为 0 和 1 （0代表对应权限关闭 1代表对应权限打开）

详情

操作权限变更回调,用于控制对白板的操作，包括缩放，滚动。

通知时机：收到后台的权限变更通知。

支持版本：v2.0.0。

onRemoteSuperBoardGraphicAuthChanged:authInfo:

- (void)onRemoteSuperBoardGraphicAuthChanged:(NSDictionary *) authInfo;

图元操作权限变更回调<br/>图元操作权限包括创建、删除、移动、更新、清空所有图元

Declared in ZegoSuperBoardManager.h

参数

名称	类型	描述
authInfo	NSDictionary *	authInfo 包含 create、delete、move、update、clear 5个key value为 0 和 1 （0代表对应权限关闭 1代表对应权限打开）

详情

图元操作权限包括创建、删除、移动、更新、清空所有图元。

调用时机/通知时机：收到后台的权限变更通知。

支持版本：v2.0.0。

ZegoSuperBoardSubViewDelegate

ZegoSuperBoardSubView 的内部变更的回调

Declared in ZegoSuperBoardSubView.h

方法

onScrollChange:currentPage:pageCount:subViewModel:

- (void)onScrollChange:(NSInteger) currentPage pageCount:(NSInteger) pageCount subViewModel:(ZegoSuperBoardSubViewModel *) subViewModel;

接收到页面变更的回调

Declared in ZegoSuperBoardSubView.h

参数

名称	类型	描述
currentPage	NSInteger	页面变更后当前页码
pageCount	NSInteger	总的页码
subViewModel	ZegoSuperBoardSubViewModel *	ZegoSuperBoardSubView对象对应的subViewModel

详情

在接收到onScrollChange回调时，SDK内部已经处理好了白板和文件页码的更新，界面上可以通过回调拿到当前最新的页码用户展示。

调用时机/通知时机：当文件或者白板内部发生滚动或者翻页的时候会触发该回调。

支持版本：支持版本：v2.0.0。

onSizeChange:size:subViewModel:

- (void)onSizeChange:(CGSize) size subViewModel:(ZegoSuperBoardSubViewModel *) subViewModel;

页面大小变更回调

Declared in ZegoSuperBoardSubView.h

参数

名称	类型	描述
size	CGSize	SuperBoardSubView内部可见内容的size
subViewModel	ZegoSuperBoardSubViewModel *	ZegoSuperBoardSubView对象对应的subViewModel

详情

接收到onSizeChange回调时，SDK内部已经处理好了白板和文件Size的更新，界面上可以通过回调拿到当前SuperBoardSubView视图上可视内容区域的大小。

调用时机/通知时机：当修改了ZegoSuperBoardSubView大小后会触发该回调。

支持版本：v2.0.0。

onScaleChangedWithScaleFactor:scaleFactor:scaleOffsetX:scaleOffsetY:subViewModel:

- (void)onScaleChangedWithScaleFactor:(CGFloat) scaleFactor scaleOffsetX:(CGFloat) scaleOffsetX scaleOffsetY:(CGFloat) scaleOffsetY subViewModel:(ZegoSuperBoardSubViewModel *) subViewModel;

缩放变化通知。

Declared in ZegoSuperBoardSubView.h

参数

名称	类型	描述
scaleFactor	CGFloat	缩放系数
scaleOffsetX	CGFloat	缩放过程中产生的水平偏移
scaleOffsetY	CGFloat	缩放过程中产生的垂直偏移
subViewModel	ZegoSuperBoardSubViewModel *	ZegoSuperBoardSubView 对象的 subViewModel

详情

实现此方法以响应缩放。

通知时机：缩放操作后，调用该回调方法通知服务层。 SDK用户根据方法参数获取缩放系数。

onStepChange

- (void)onStepChange;

动态PPT内动画步骤变化通知。

Declared in ZegoSuperBoardSubView.h

实现此方法监听动态PPT内动画步骤变化。

通知时机：动态PPT内动画步骤变化时通知。

ZegoSuperBoardViewDelegate

ZegoSuperBoardView 的事件回调

Declared in ZegoSuperBoardView.h

方法

onScrollChange:currentPage:pageCount:subViewModel:

- (void)onScrollChange:(NSInteger) currentPage pageCount:(NSInteger) pageCount subViewModel:(ZegoSuperBoardSubViewModel *) subViewModel;

页面变更回调

Declared in ZegoSuperBoardView.h

参数

名称	类型	描述
currentPage	NSInteger	页面变更后当前页码
pageCount	NSInteger	总页数
subViewModel	ZegoSuperBoardSubViewModel *	ZegoSuperBoardSubView对象对应的subViewModel

详情

在接收到onScrollChange回调时，SDK内部已经处理好了白板和文件页码的更新，界面上可以通过回调拿到当前最新的页码用户展示。

调用时机/通知时机：当文件或者白板内部发生滚动或者翻页的时候会触发该回调。

支持版本：支持版本：v2.0.0。

onSizeChange:size:subViewModel:

- (void)onSizeChange:(CGSize) size subViewModel:(ZegoSuperBoardSubViewModel *) subViewModel;

页面大小变更回调

Declared in ZegoSuperBoardView.h

参数

名称	类型	描述
size	CGSize	SuperBoardSubView可见内容的大小
subViewModel	ZegoSuperBoardSubViewModel *	ZegoSuperBoardSubView对象对应的subViewModel

详情

接收到onSizeChange回调时，SDK内部已经处理好了白板和文件Size的更新，界面上可以通过回调拿到当前SuperBoardSubView视图上可视内容区域的大小。

调用时机/通知时机：当修改了ZegoSuperBoardSubView大小后会触发该回调。

支持版本：v2.0.0。

onStepChange

- (void)onStepChange;

动态PPT内动画步骤变化通知。

Declared in ZegoSuperBoardView.h

实现此方法监听动态PPT内动画步骤变化。

通知时机：动态PPT内动画步骤变化时通知。