概览
ARBoardHandler 接口类向 App 发送回调通知,上报运行时的事件。
ARBoardHandler 包含了以下方法:
| 全局事件回调 | |
|---|---|
| onAddBoard | 添加白板页回调 |
| onDeleteBoard | 删除白板页回调 |
| onGotoBoard | 白板页切换回调 |
| onUndoStateChange | 当前白板页是否可撤销 |
| onRedoStateChange | 当前白板页是否可重做 |
| onOccurError | 白板错误回调 |
| onScaleChannge | 当前白板页缩放比例变化回调 |
| connectionChangedToState | 网络状态回调 |
| onSnapshot | 截图回调 |
| onHistoryDataSyncCompleted | 白板数据同步完成回调 |
| onBoardReset | 白板重置时回调 |
| onBoardClear | 白板被清空时回调 |
| onBoardImageStatusChanged | 画板背景图片加载状态回调 |
| onBoardRatioChange | 画板背景图片加载状态回调 |
onAddBoard
void onAddBoard(String boardIds, String fileId);
添加白板页的回调
| 参数 | 描述 |
|---|---|
| boardIds | 白板页 ID 列表 |
| fileId | 白板的文件 ID |
onDeleteBoard
void onDeleteBoard(String boardIds, String fileId);
删除白板页的回调
| 参数 | 描述 |
|---|---|
| boardIds | 白板页 ID 列表 |
| fileId | 白板的文件 ID |
onGotoBoard
void onGotoBoard(String boardIds, String fileId);
白板页切换的回调
| 参数 | 描述 |
|---|---|
| boardIds | 白板页 ID 列表 |
| fileId | 白板的文件 ID |
onUndoStateChange
void onUndoStatusChanged(boolean enable);
当前白板页是否可撤销
| 参数 | 描述 |
|---|---|
| enable | 白板是否可执行 undo 操作 |
onRedoStateChange
void onRedoStatusChanged(boolean enable);
当前白板页是否可重做
| 参数 | 描述 |
|---|---|
| enable | 白板是否可执行 redo 操作 |
onOccurError
void onOccurError(ARBoardErrorCode err, String message);
当前白板页是否可重做
| 参数 | 描述 |
|---|---|
| err | 错误类型 |
| message | 错误信息 |
scaleChannge
void onScaleChanged(String boardId, int scale);
白板页缩放的回调
| 参数 | 描述 |
|---|---|
| boardId | 缩放变化的白板页 ID |
| scale | 缩放比例 |
connectionChangedToState
void connectionChangedToState(ARBoardConnectionState state, ARBoardConnectionChangedReason reason);
白板页缩放的回调
| 参数 | 描述 |
|---|---|
| state | 当前的网络连接状态 |
| reason | 触发当前网络连接状态的原因 |
onSnapshot
void onSnapshot(String path, ARBoardSnapshotCode code);
截图回调
| 参数 | 描述 |
|---|---|
| path | 快照本地输出路径 |
| code | 状态码 |
onhistorydatasynccompleted
void onHistoryDataSyncCompleted();
数据同步完成回调
注:操作白板需在回调此方法后(getter setter.. 等)
onBoardReset
void onBoardReset();
画板被重置时会执行此方法
onBoardClear
void onBoardClear(String boardId, String fileId, boolean clearBackground);
画板被清空时会执行此方法
| 参数 | 描述 |
|---|---|
| boardId | 快照本地输出路径 |
| fileId | 白板的文件 ID |
| clearBackground | 是否清空背景,背景包括颜色&图片 |
onBoardImageStatusChanged
void onBoardImageStatusChanged(String boardId, String fileId, ARBoardImageStatus status, String imgUrl, ARBoardFillMode fillMode)
画板背景图片加载状态回调,ARBoardImageStatus详见ARBoardImageStatus、ARBoardFillMode详见ARBoardFillMode
| 参数 | 描述 |
|---|---|
| boardId | 快照本地输出路径 |
| fileId | 白板的文件 ID |
| status | 设置背景图片后的图片加载状态 |
| imgUrl | 背景图片地址 |
| fillMode | 背景图片填充方式 |
onBoardRatioChange
void onBoardRatioChange(String boardId, String ratio)
当前白板页比例变更时回调
| 参数 | 描述 |
|---|---|
| boardId | 快照本地输出路径 |
| ratio | 当前画板比例,如:"4:3" |

