IWhiteBoardRoomManager

类型: interface

getSdkVersion()

获得当前 SDK 版本号。

类型
```
() => string
ts
```
返回值
类型: string
版本号。

init()

白板 SDK 初始化。

类型
```
(params: IInitParams) => void
ts
```
注意
在开始使用白板服务前，应调用本接口初始化白板。
参数
- IInitParams
  类型: IInitParams
  初始化参数

joinRoom()

创建白板实例并加入白板房间。

类型

(params: IJoinRoomParams) => Promise<IWhiteBoardRoom>
ts

注意
如果白板房间在服务端不存在，则服务端按照传入参数创建房间，并触发 onCreateWhiteBoard。
- 进房成功后，远端触发 onUserCountChanged 房间内人数回调。
- 进房成功后，可以调用 leaveRoom 离开房间。
- 如果房间内所有用户都已结束互动，你可以调用 destroyRoom 关闭房间。
参数
- params
  类型: IJoinRoomParams
  进入白板房间参数
返回值
类型: Promise<IWhiteBoardRoom>
白板房间实例

destroy()

销毁 IWhiteBoardRoomManager 对象，释放资源。

类型
```
() => void
ts
```

IWhiteBoardRoom

类型: interface

getRoomId()

获得当前白板房间 ID。

类型
```
() => string
ts
```
注意
当本端用户已经进入白板房间后，你可以调用本接口查询当前房间 ID。
返回值
类型: string
白板房间 ID

getRoomStatus()

获取房间状态。

类型
```
() => Promise<StatusType>
ts
```
返回值
类型: Promise<StatusType>
房间状态

leaveRoom()

退出白板房间。

类型
```
() => Promise<void>
ts
```
注意
- 互动白板按照用户在房间内的时长进行计费，你应在当前用户结束白板使用时调用本接口退出房间。
- 用户退出房间后，可以调用 joinRoom 再次加入该房间。
- 如果房间内所有用户都已结束互动，你可以调用 destroyRoom 关闭房间。
返回值
类型: Promise<void>
退房成功后，远端触发 onUserCountChanged 房间内人数回调。

destroyRoom()

关闭房间内所有白板，重进房间后无法进行写画。

类型
```
() => Promise<CloseRoomResult>
ts
```
注意
- 如果你希望在下次进房时仍可以继续进行白板互动，应调用 leaveRoom 退房，此后调用 joinRoom 进房，可以继续此前的白板操作。
- 如果已经在控制台开通和配置了白板录制，白板创建后自动录制。只有当调用本接口关闭白板之后，才可以开始播放录像。
返回值
类型: Promise<CloseRoomResult>
关闭白板提示

switchWhiteBoard()

指定当前白板。

类型

(boarId: number) => Promise<SwitchBoardResult>
ts

注意
调用成功后房间内所有用户将收到 onCurrentWhiteBoardChanged
参数
- boarId
  类型: number
  白板 ID
返回值
类型: Promise<SwitchBoardResult>

removeWhiteBoard()

关闭指定白板。

类型

(boardId: number) => Promise<RemoveWhiteBoardResult>
ts

注意
调用后将触发 onRemoveWhiteBoard
参数
- boarId
  类型: number
  白板 ID
返回值
类型: Promise<RemoveWhiteBoardResult>

getCurrentWhiteBoard()

获取当前的白板实例。

类型
```
() => Promise<IWhiteBoard | null>
ts
```
注意
- 调用 joinRoom 加入房间后，调用本接口获取当前白板。如果返回 null，则调用 createWhiteBoard 创建一个白板。
返回值
类型: Promise<IWhiteBoard | null>
- 当前的白板实例
- 当前房间内没有白板，返回 null

getCurrentWhiteBoardId()

获取当前的白板 ID。

类型
```
() => Promise<number>
ts
```
返回值
类型: Promise<number>
当前白板 ID

getAllWhiteBoardInfo()

获取房间内所有白板的信息。

类型
```
() => Promise<WebBoardInfo[]>
ts
```
返回值
类型: Promise<WebBoardInfo[]>
房间内所有白板的信息

getUserCount()

获取房间内当前用户数。

类型
```
() => Promise<number>
ts
```
返回值
类型: Promise<number>
房间内当前用户数

createTranscodeTask()

创建一个转码任务。

类型

(params: IDocsCreateTranscodeTask) => Promise<IDocsTranscodeResult>
ts

参数
- params
  类型: IDocsCreateTranscodeTask
返回值
类型: Promise<IDocsTranscodeResult>
转码任务结果

createWhiteBoard()

在房间内创建一个白板。

类型

(createBoardOptions?: CreateWhiteBoardInfo | undefined) => Promise<CreateWhiteBoardResult>
ts

注意
- 调用 joinRoom 加入房间后，你可以调用本接口创建白板。
- 调用成功后，房间内所有用户都将收到 onCreateWhiteBoard 回调。
- 如果当前房间已有白板，你应该调用 getCurrentWhiteBoard 获取当前白板。
- 你可以传入不同的白板参数，在同一个房间内创建多个白板。
参数
- createBoardOptions
  类型: CreateWhiteBoardInfo | undefined
  白板初始化参数
返回值
类型: Promise<CreateWhiteBoardResult>

getWhiteBoardInfo()

通过白板 ID 获取白板信息。

类型

(boardId: number) => Promise<WebBoardInfo | undefined>
ts

参数
- boardId
  类型: number
  白板 ID
返回值
类型: Promise<WebBoardInfo | undefined>
白板信息。
获取失败时，返回 null。例如，传入的 boardID 有误。

startPlayback()

开始播放白板录像。

类型
```
() => void
ts
```
注意
- 调用后将触发 onPlaybackStateChanged。
- 使用录像和回放时，需要在控制台开通和配置白板录制功能。
- 调用时机：房间中至少有一个用户 destroyRoom 关闭白板，之后，所有用户在重新进房后，即调用 leaveRoom 退房，再调用 joinRoom 重新进房后，才可以调用本接口开始播放录像。

pausePlayback()

暂停播放录像。

类型
```
() => void
ts
```
注意
- 调用 startPlayback 开始播放回放后，你可以调用本接口暂停播放。
- 调用后将触发 onPlaybackStateChanged。

stopPlayback()

停止播放录像。

类型
```
() => void
ts
```
注意
- 调用 startPlayback 开始播放回放后，你可以调用本接口停止播放。
- 调用后将触发 onPlaybackStateChanged。

setPlaybackProgress()

设置白板回放进度。

类型
```
(progress: number) => void
ts
```
注意
- 调用 startPlayback 开始播放回放后，你可以调用本接口停止播放。
- 调用后将触发 onPlaybackProgressUpdate。
参数
- progress
  类型: number
  播放位置相当于录像时长的占比。范围 [0,1]。

IWhiteBoard

类型: interface

setViewMode()

设置白板视图跟随模式。

类型
```
(viewMode: ViewMode) => ViewMode
ts
```
注意
- 设置为跟随模式时，无需手动调用 zoomIn， zoomOut 或 zoomTo，SDK 将自动同步为控制方的视图设置。
参数
- viewMode
  类型: ViewMode
  视角同步模式。默认为跟随模式。
返回值
类型: ViewMode
当前视角同步模式

getViewMode()

获取视图模式。

类型
```
() => ViewMode
ts
```
返回值
类型: ViewMode
视图跟随模式

removePages()

按照指定的索引号，删除白板页。

类型

(pageIdList: string[], flipPageIndex?: number | undefined) => Promise<RemovePagesResult>
ts

注意
调用本接口成功后，白板 SDK 将按原顺序给剩下的页面重新编号。被删除页面之后的页面索引号会发生改变，房间中所有用户将收到 onPageIndexChanged 回调。
参数
- pageIdList
  类型: string[]
  需要删除的页面的 PageId 列表。
- flipPageIndex
  类型: number | undefined
  删除页面后，跳转到指定索引号页面。参数为空时的表现：

当前页未被删除时，不翻页。
删除包含当前页在内的不连续多页时：翻到第一个被删除的页面的下一页。
删除当前页或包含当前页在内的连续多页时：翻到下一页，如果删除的页面为最末页，则翻到前一页。

返回值
类型: Promise<RemovePagesResult>
- Resolve: 成功。成功调用后，房间中所有用户将收到 onRemovePages 和 onPagesCountChanged 回调。
- Reject: 失败。频繁调用，小于 500 ms；或传入的参数为空。

zoomIn()

以当前视图中心为中心点放大白板视图。

类型
```
(scale: number) => boolean
ts
```
注意
- 当多个用户同时进行缩放设置时，发起较晚的用户设置失败。
- 如果需要用户通过手势进行缩放可以通过 setEditType 设置为 ZOOM。
参数
- scale
  类型: number
  缩放系数增量。每次调用后，缩放系数增加 scale。
  当缩放系数超过范围时，将置为临界点。缩放系数的范围 [1, 20]。1 表示原始大小。放大系数上限默认为 20，以调用 setMaxZoom 设置的为准。
返回值
类型: boolean
调用结果
- true: 成功
- false: 失败。当前白板状态不可编辑，即通过 setWritable[#setwritable] 设置为 False。或当前用户的视图设置为跟随模式 kFollow = 1。

zoomOut()

以当前视图中心为中心点缩小白板视图。

类型
```
(scale: number) => boolean
ts
```
注意
- 当多个用户同时进行缩放设置时，发起较晚的用户设置失败。
- 如果需要用户通过手势进行缩放可以通过 setEditType 设置为 ZOOM。
参数
- scale
  类型: number
  缩放系数减量。每次调用后，缩放系数减少 scale。
  当缩放系数超过范围时，将置为临界点。缩放系数的范围 [1, 20]。1 表示原始大小。放大系数上限默认为 20，以调用 setMaxZoom 设置的为准。
返回值
类型: boolean
调用结果
- true: 成功
- false: 失败。当前白板状态不可编辑，即通过 setWritable[#setwritable] 设置为 False。或当前用户的视图设置为跟随模式 kFollow = 1。

zoomTo()

按照指定中心点和缩放系数缩放白板视图。

类型

(scale: number, offsetX: number, offsetY: number) => boolean
ts

注意
- 缩放中心点为当前视图中心。
- 当多个用户同时进行缩放设置时，将按服务端收到指令的时间顺序应用设置。
- 如果需要用户通过手势进行缩放可以通过 setEditType 设置为 ZOOM。
参数
- scale
  类型: number
  缩放系数，范围 [1, 20]。1 表示原始大小。放大系数上限默认为 20，以调用 setMaxZoom 设置的为准。
- offsetX
  类型: number
  缩放中心点 X 坐标，默认为 0
- offsetY
  类型: number
  缩放中心点 Y 坐标，默认为 0
返回值
类型: boolean
调用结果
- true: 成功
- false: 失败。例如缩放系数错误超过合法范围。

resetZoom()

恢复默认缩放视图。还原到原始大小，视图中心点恢复为白板中心点。

类型
```
() => boolean
ts
```
返回值
类型: boolean
调用结果
- true: 成功
- false: 失败。

getZoomFactor()

获取当前白板视图缩放系数。

类型
```
() => number
ts
```
返回值
类型: number
当前白板视图缩放系数。范围 [1, 20]。1 表示原始大小。放大系数上限默认为 20，以调用 setMaxZoom 设置的为准。

setMaxZoom()

设置白板视图最大放大系数。

类型
```
(maxScale: number) => void
ts
```
注意
设置成功后，将改变调用以下 API 的参数上限： zoomIn， zoomOut 或 zoomTo。
参数
- maxScale
  类型: number
  白板视图最大放大系数，范围 [1, 20]。默认为 20。

exportSnapshot()

将当前白板中指定页面保存为一张本地图片

类型

(params?: ExportSnapshotOptions | undefined) => Promise<string | undefined>
ts

参数
- params
  类型: ExportSnapshotOptions | undefined
  快照选项
返回值
类型: Promise<string | undefined>
Resolve 返回图片，格式为经过 Base 64 编码的字符串。
注意
短时间内多次调用本 API 时，等待获取结果回调时间可能增加。

getWhiteBoardId()

获取当前的白板 ID。

类型
```
() => number
ts
```
返回值
类型: number
白板 ID

getWhiteBoardRoomId()

获取当前白板所在的房间 ID。

类型
```
() => string
ts
```
返回值
类型: string
白板房间 ID

setWritable()

设置当前白板是否可以编辑。

类型
```
(writeable: boolean) => void
ts
```
参数
- writeable
  类型: boolean
  是否可以编辑

getWritable()

获取当前白板是否可以编辑。

类型
```
() => boolean
ts
```
返回值
类型: boolean

setEditType()

设置编辑动作类型。

类型
```
(key: EditType) => void
ts
```
注意
如果默认的光标图形无法满足你的需求，调用 setCursorStyle，为不同工具过指定光标图形和样式。
参数
- key
  类型: EditType
  编辑动作类型。

getEditType()

获取当前编辑动作类型。

类型
```
() => EditType
ts
```
注意
如果默认的光标图形无法满足你的需求，调用 setCursorStyle，为不同工具过指定光标图形和样式。
返回值
类型: EditType
编辑动作类型

setBoardBackground()

修改当前白板的背景设置，例如背景图片颜色等。

类型

(params: WebBackgroundInfo) => Promise<SetBoardBackgroundResult>
ts

注意
- 调用本回调后会在本端和远端触发 onBoardBackgroundChanged。
- 调用 setPageBackground 可以设置页面背景。页面背景显示优先级高于白板背景，与调用顺序无关。
参数
- params
  类型: WebBackgroundInfo
  背景信息
返回值
类型: Promise<SetBoardBackgroundResult>
- Resolve：成功
- Reject: 失败原因

addImage()

在当前页面中添加图片。

类型

(url: string, options?: AddImageOptions | undefined) => Promise<void>
ts

参数
- url
  类型: string
  图片的 url。
- options
  类型: AddImageOptions | undefined
  图片的位置和尺寸，单位为画布宽度的万分之一。
  选填。默认居中放置，如果图片尺寸比白板页面小，不缩放；如果图片尺寸比白板页面大，按原始尺寸的比例缩小后居中放置。
返回值
类型: Promise<void>

setSelectionBoxStyle()

设置选择框样式。如果默认的选择框样式无法满足你的需求，调用本接口，并传入需要修改的属性。

类型
```
(shapeStyle: ShapeStyle) => void
ts
```
参数
- shapeStyle
  类型: ShapeStyle
  选择框样式。

setShapeSize()

设置图形线条尺寸。

类型
```
(thickness: number) => void
ts
```
参数
- thickness
  类型: number
  图形线条尺寸，[1, 10000]。单位为画布宽度的万分之一

setShapeColor()

设置图形颜色。

类型
```
(color: string) => void
ts
```
参数
- color
  类型: string
  图形的颜色，例如 rgba(0,0,0,255)。

setPenSize()

设置画笔尺寸。

类型
```
(thickness: number) => void
ts
```
参数
- thickness
  类型: number
  笔尖尺寸。[1, 10000]。单位为画布宽度的万分之一

setPenColor()

设置画笔颜色。

类型
```
(color: string) => void
ts
```
参数
- color
  类型: string
  画笔的颜色，例如 rgba(0,0,0,255)。

setTextColor()

设置文字颜色。

类型
```
(color: string) => void
ts
```
参数
- color
  类型: string
  文字的颜色，例如 rgba(0,0,0,255)。

setTextFontSize()

设置文本字号大小。

类型
```
(thickness: number) => void
ts
```
参数
- thickness
  类型: number
  文本字号大小，[1, 10000]。单位为画布高的万分之一

redo()

重做本端对白板的编辑操作。

类型
```
() => number | false
ts
```
返回值
类型: number | false
- >0：成功。数字为剩余的可重做次数。当前用户将收到 onRecordUpdated 回调。
- False：失败

undo()

撤销本端对白板的编辑操作。

类型
```
() => number | false
ts
```
返回值
类型: number | false
- >0：剩余的可撤回次数。当前用户将收到 onRecordUpdated 回调。
- False：失败

createPages()

创建多个白板页面。在使用文件转码功能后，可以调用本接口，将生成的多个图片批量插入到多个新的白板页面中。

类型

(pageConfigs: WebPageInfo[], options?: CreatePageOptions | undefined) => Promise<CreatePageProgressResult>
ts

参数
- pageConfigs
  类型: WebPageInfo[]
  页面信息数组。
- options
  类型: CreatePageOptions | undefined
  创建页面选项
返回值
类型: Promise<CreatePageProgressResult>
- Resolve：调用成功后，本端和远端都将收到 onCreatePagesProgress 回调，提示页面创建进度。
- Reject：失败原因。

clearPage()

清空白板。
删除当前白板页面上所有的笔迹元素和已插入的图片。

类型
```
() => void
ts
```
注意

调用成功后，房间内所有用户都将收到 onClearPage 回调。
如果你需要删除白板上的部分笔迹或形状等元素，可以引导用户在使用选择工具选择元素后，再按下键删除选中元素。

setPageBackground()

修改当前白板页面的背景设置，例如背景图片颜色等。

类型

(params: WebBackgroundInfo) => Promise<SetPageBackgroundResult>
ts

注意
- 调用本回调后会在本端和远端触发 onPageBackgroundChanged。
- 调用本接口传入不同的页面配置可以更新背景设置。
- 调用 setBoardBackground 可以设置白板背景。页面背景显示优先级高于白板背景，与调用顺序无关。
参数
- params
  类型: WebBackgroundInfo
  当前白板页面的背景设置
返回值
类型: Promise<SetPageBackgroundResult>
- Resolve：成功
- Reject: 失败原因

flipPage()

白板翻页。

类型

(pageIndex: number) => Promise<FlipPageResult>
ts

参数
- pageIndex
  类型: number
  目标页 Index。
返回值
类型: Promise<FlipPageResult>
- Resolve: 成功。返回当前页 Index。并在房间内所有客户端触发 onPageIndexChanged
- Reject: 失败。频繁调用，小于 500 ms；或传入的参数为空。

flipNextPage()

白板翻到下一页。

类型
```
() => Promise<FlipPageResult>
ts
```
返回值
类型: Promise<FlipPageResult>
- True: 成功。返回当前页 Index。并在房间内所有客户端触发 onPageIndexChanged
- False: 失败。频繁调用，小于 500 ms；或传入的参数为空。

flipPrevPage()

白板翻到上一页。

类型
```
() => Promise<FlipPageResult>
ts
```
返回值
类型: Promise<FlipPageResult>
- True: 成功。返回当前页 Index。并在房间内所有客户端触发 onPageIndexChanged
- False: 失败。频繁调用，小于 500 ms；或传入的参数为空。

getAllPageInfo()

获取所有页面信息。

类型
```
() => WebPageInfo[]
ts
```
返回值
类型: WebPageInfo[]
白板页信息。

getCurrentPageId()

获取当前页面的 PageId。

类型
```
() => string
ts
```
返回值
类型: string
页面 ID

getCurrentPageInfo()

获取当前页面信息。

类型
```
() => WebPageInfo | undefined
ts
```
返回值
类型: WebPageInfo | undefined
白板页信息

getCurrentPageIndex()

获取当前页面索引。

类型
```
() => number
ts
```
返回值
类型: number
索引, -1 表示没有找到索引

getPageCount()

获取当前页面总数。

类型
```
() => number
ts
```
返回值
类型: number
页面总数

getPageInfoByIndex()

通过索引号获取白板页信息。

类型

(index: number) => WebPageInfo | undefined
ts

参数
- index
  类型: number
  索引
返回值
类型: WebPageInfo | undefined
白板信息

enableCursorSync()

开启光标同步。开启后，房间中其他用户可以看到当前用户光标的实时移动轨迹。默认关闭。

类型
```
(enabled: boolean) => void
ts
```
参数
- enabled
  类型: boolean
  同步状态：

true: 开启
false: 关闭

setCursorStyle()

自定义不同的工具光标样式。如果默认的光标图形无法满足你的需求，调用本接口，为不同工具过指定光标图形和样式。

类型
```
(params: Partial<CursorMap>) => void
ts
```
参数
- params
  类型: Partial<CursorMap>
  自定义光标样式。[key in CursorType]: CursorInfo;
  CursorType 定义如下：

kArrow = 0, //箭头光标
kSelect = 1, //选择
kPen = 2, //画笔
kShape = 3, //形状
kText = 4, //文字
kErase = 5, //橡皮擦
kLaserPen = 6, //激光笔
kMove = 7, //图形平移光标，光标不同步此类型，仅 Web 端可见
kRotate = 8, //图形旋转光标，光标不同步此类型，仅 Web 端可见

CursorInfo 定义如下：

export interface CursorInfo {
useSystemCursor?: boolean;               // Web 端特有，是否使用浏览器自带光标
systemCursorType?: SystemCursorType;     // Web 端特有，对应 Web 端系统光标枚举
filePath?: string;                       // 光标资源路径 url
offsetX?: number;                        // 焦点位置，在光标图形上 X 方向偏移量
offsetY?: number;                        // 焦点位置，在光标图形上 Y 方向偏移量
}
ts