ViewMode

类型: enum

视图缩放同步选项

成员

属性	值	描述
kBroadcast	`0`	视图控制模式。本端的视图设置将同步给其他用户，设置为自由模式的用户除外。同一个白板可以有多个控制方，缩放设置为最近一次调用 API 传入的设置。
kFollow	`1`	视图跟随模式
kFree	`2`	自由模式，不跟随其他用户的视图缩放设置。同时本地的视图缩放设置也不会影响到设置为跟随的用户。

RemovePagesResult

类型: interface

页面移除事件

userId

类型: string

移除页面的用户

boardId

类型: number

白板 ID

pageIds

类型: string[]

被删除页面 ID

EditType

编辑动作类型

类型
```
ToolMode | ''
ts
```

WebBackgroundInfo

类型: interface

bkColor

类型: string | undefined

背景颜色。例如 rgba(0,0,0,255)。

bkImage

类型: string | undefined

背景图片。

bkImageFillType

类型: BkFillType | undefined

背景图片填充设置。

bkImageSize

类型: BkImageSize | undefined

背景图片尺寸。

BkFillType

类型: enum

背景图片填充方式

成员

属性	值	描述
kFill	`0`	平铺窗口，按照白板比例缩放图片进行填充。
kCenter	`1`	居中放置，不缩放。
kHidden	`2`	等比例缩放，如果画布和图片比例不一致，将对图片进行裁切。

BkImageSize

类型: interface

背景图片尺寸

width

类型: number

宽，单位为画布宽度的万分之一。

height

类型: number

高，单位为画布高度的万分之一。

SetBoardBackgroundResult

类型: interface

设置白板背景信息成功事件

userId

类型: string

设置白板背景的用户

boardId

类型: number

白板 ID

bkInfo

类型: WebBackgroundInfo

白板背景设置

ShapeStyle

类型: interface

选择框样式。

motionType

类型: MotionType | undefined

锚点形状。

motionSize

类型: number | undefined

锚点宽度。

motionBorderWidth

类型: number | undefined

锚点边框线条宽度。

motionBorderColor

类型: string | undefined

锚点边框颜色。例如 rgba(0,0,0,255)。

motionFillColor

类型: string | undefined

锚点填充颜色。例如 rgba(0,0,0,255)。

motionTransparent

类型: boolean | undefined

锚点是否透明。

borderWidth

类型: number | undefined

选择框宽度。

borderColor

类型: string | undefined

选择框颜色。例如 rgba(0,0,0,255)。

rotateImage

类型: string | undefined

旋转手柄图标资源地址。

rotateDistance

类型: number | undefined

旋转手柄距离选择框顶点的距离。

MotionType

类型: enum

成员
属性值描述
kRect 0 矩形。
kCircle 1 圆形。

属性	值	描述
kRect	`0`	矩形。
kCircle	`1`	圆形。

WebPageInfo

类型: interface

页面信息。

pageId

类型: string

页面 ID。

bkInfo

类型: WebBackgroundInfo | undefined

背景设置。

extra

类型: string | undefined

补充信息。

CreatePageOptions

类型: interface

创建页面选项

insertPageIndex

类型: number | undefined

指定页面索引。创建的页面将插入到指定的页面之后。默认插入到当前页后面

autoFlip

类型: boolean | undefined

是否自动翻页。

True: 在页面创建完成后，当前页面变更为刚批量创建的第一页。
False: 不翻页，即创建页面后当前页面不变。默认选项。

CreatePageProgressResult

类型: interface

创建页面成功事件

userId

类型: string

创建页面的用户

pages

类型: WebPageInfo[]

刚创建的白板页面信息

insertPageId

类型: string

指定页面的 pageId，新建页面将插入此页面之后

progress

类型: number

创建进度

totalCount

类型: number

创建页后的白板总页数

SetPageBackgroundResult

类型: interface

设置页面背景信息成功事件

userId

类型: string

设置页面背景的用户

boardId

类型: number

白板 ID

pageId

类型: string

页面 ID

bkInfo

类型: WebBackgroundInfo

页面背景设置

FlipPageResult

类型: interface

currentIndex

类型: number

当前页面 Index。

LockBoardReason

类型: enum

锁定原因。

成员
属性值描述
BOARD_DATA_ERROR 1 数据错误。
NET_WORK_CONGESTION 2 网络拥塞。
NET_WORK_DISCONNECT 3 网络断开。
UNKNOWN -1 未知错误。

属性	值	描述
BOARD_DATA_ERROR	`1`	数据错误。
NET_WORK_CONGESTION	`2`	网络拥塞。
NET_WORK_DISCONNECT	`3`	网络断开。
UNKNOWN	`-1`	未知错误。

ErrorCode

类型
```
EnumValue<typeof ErrorCode>
ts
```

ImageLoadStatus

类型: enum

图片加载状态。

成员
属性值描述
loading 0 加载中。
end 1 加载完成。
error 2 加载错误。

属性	值	描述
loading	`0`	加载中。
end	`1`	加载完成。
error	`2`	加载错误。

ZoomInfoChangedEvent

类型: interface

当前白板的缩放信息改变事件
继承 ZoomOffsetInfo[#zoomoffsetinfo] 全部属性

userId

类型: string

缩放白板视图的用户

StatusType

类型: enum

当前白板是否可编辑

成员

属性	值	描述
Active	`0`	可编辑
Inactive	`1`	已关闭，不可编辑。如果开启了录像，在此状态下可以开始播放录像。不可用。房间中有用户调用 destroyRoom 关闭白板后，再次进房时，白板状态将为已关闭。

CloseRoomResult

类型: interface

白板关闭结果

closed

类型: boolean

是否成功关闭白板

SwitchBoardResult

类型: interface

当前白板更换成功提示

userId

类型: string

更换白板的用户 ID

boardId

类型: number

当前白板 ID

whiteBoard

类型: IWhiteBoard

当前白板实例

RemoveWhiteBoardResult

类型: interface

白板删除提示

userId

类型: string

删除白板的用户 ID

boardId

类型: number

删除的白板 ID

WebBoardInfo

类型: interface

白板信息

boardId

类型: number

白板 ID

boardName

类型: string | undefined

白板名称

pages

类型: WebPageInfo[]

页面信息

bkInfo

类型: WebBackgroundInfo | undefined

背景设置

currentPageId

类型: string

当前页面 ID

status

类型: StatusType

白板状态，是否可用

controlCount

类型: { [key: string]: number; }

每个页面操作记录数，key 为 page ID。

boardControlCount

类型: number

白板中的操作记录数。

userCursorInfo

类型: { [key: string]: UserCursorInfo; }

自定义光标设置。

zoomInfo

类型: ZoomOffsetInfo

缩放相关信息

createTimestamp

类型: number

创建时间，为精确到毫秒的 UNIX 时间戳

UserCursorInfo

类型: interface

自定义光标设置

showState

类型: CursorShowState

显示状态

cursorType

类型: CursorType

光标类型

CursorShowState

类型: enum

光标显示状态

成员
属性值描述
kHide 0 隐藏
kShow 1 显示
kSimulate 2 同步

属性	值	描述
kHide	`0`	隐藏
kShow	`1`	显示
kSimulate	`2`	同步

CursorType

类型: enum

光标类型

成员

属性	值	描述
kPointer	`0`	选择工具
kPen	`2`	画笔工具
kShape	`3`	形状绘制工具
kText	`4`	文本工具
kErase	`5`	橡皮擦工具
kLaserPen	`6`	激光笔工具
kMove	`7`	图形平移光标，光标不同步此类型，仅 Web 端本地用
kRotate	`8`	图形旋转光标，光标不同步此类型，仅 Web 端本地用
kZoom	`9`	放大缩小工具，光标不同步此类型，仅 Web 端本地用

ZoomOffsetInfo

类型: interface

缩放相关信息

zoom

类型: number

缩放系数

offsetX

类型: number

缩放中心 x 坐标。坐标原点为画板中心。

offsetY

类型: number

缩放中心 y 坐标。坐标原点为画板中心。

IDocsCreateTranscodeTask

类型: interface

文件转码任务配置
参数说明参见文件转码说明。

app_id

类型: string

App ID
你可以在控制台上查看 App ID。或通过调用 Open API 获取。

resource

类型: string

operator

类型: string

transcode_config

类型: TranscodeConfig

参数说明详见 TranscodeConfig

storage_config

类型: StorageConfig

参数说明详见 StorageConfig

transcode_mode

类型: TranscodeMode | undefined

priority

类型: Priority | undefined

onProgress()

类型

(transcodePercent: number, transcodeStatus: TaskStatus, taskId: string) => void
ts

参数
- transcodePercent
  类型: number
- transcodeStatus
  类型: TaskStatus
- taskId
  类型: string

TranscodeConfig

类型: interface

参数说明详见 TranscodeConfig

input_format

类型: InputFormat

output_format

类型: OutputFormat

output_width

类型: number

output_height

类型: number

force_use_resolution

类型: boolean | undefined

thumbnail

类型: boolean | undefined

thumbnail_width

类型: number | undefined

thumbnail_height

类型: number | undefined

InputFormat

类型: enum

文件转码输入格式

成员
属性值描述
ppt 1 --
pptx 2 --
doc 3 --
docx 4 --
pdf 5 --

属性	值	描述
ppt	`1`	--
pptx	`2`	--
doc	`3`	--
docx	`4`	--
pdf	`5`	--

OutputFormat

类型: enum

文件转码输出格式

成员
属性值描述
png 1
'jpg/jpeg' 2

属性	值	描述
png	`1`
'jpg/jpeg'	`2`

StorageConfig

类型: interface

参数说明详见 StorageConfig

type

类型: StorageType

tos_config

类型: TosConfig | undefined

custom_config

类型: CustomConfig | undefined

StorageType

类型: enum

储存方式

成员
属性值描述
Tos 0 火山引擎 TOS 服务
S3 1 第三方的 TOS 服务

属性	值	描述
Tos	`0`	火山引擎 TOS 服务
S3	`1`	第三方的 TOS 服务

TosConfig

类型: interface

使用火山 TOS 时此项必填。

account_id

类型: string

账户 ID。火山引擎主账户的账号 ID

bucket

类型: string

桶名称。登陆 TOS 控制台开通和获取。

CustomConfig

类型: interface

使用第三方 TOS 时此项必填。向你的 TOS 服务供应商获取以下信息。

vendor

类型: Vendor

第三方对象存储供应商

0: Amazon 亚马逊
1: Alicloud 阿里云

region

类型: string

地区 ID。参考数据结构进行赋值。

bucket

类型: string

桶名称

access_key

类型: string

接入凭证

secret_key

类型: string

接入密钥

Vendor

类型: enum

成员
属性值描述
amazon 0
alicloud 1

属性	值	描述
amazon	`0`
alicloud	`1`

TranscodeMode

类型: enum

转码类型

成员
属性值描述
static 0 静态

属性	值	描述
static	`0`	静态

Priority

类型: enum

转码优先级

成员
属性值描述
nonrealtime 0 非实时转码(默认)
realtime 1 实时转码

属性	值	描述
nonrealtime	`0`	非实时转码(默认)
realtime	`1`	实时转码

TaskStatus

类型: enum

转码任务状态

成员
属性值描述
Pending 0 等待开始
Ongoing 1 执行中
Completed 2 已完成
Fail 3 失败

属性	值	描述
Pending	`0`	等待开始
Ongoing	`1`	执行中
Completed	`2`	已完成
Fail	`3`	失败

IDocsTranscodeResult

类型: interface

发起文件转码任务成功提示

transcode_mode

类型: TranscodeMode

转码模式

images

类型: IDocsImage[]

转码结果

h5_url

类型: string

file_name

类型: string

width

类型: number

height

类型: number

CreateWhiteBoardInfo

类型: interface

白板初始化信息

boardId

类型: number | undefined

白板 ID，可选，默认从 1 开始自增的数字

boardName

类型: string | undefined

白板名称，可选，默认和 id 一样

pages

类型: WebPageInfo[] | undefined

页面信息，默认创建一个空白页面

bkInfo

类型: WebBackgroundInfo | undefined

白板背景信息，默认无背景

CreateWhiteBoardResult

类型: interface

创建白板成功提示

userId

类型: string

创建白板的用户 ID

boardId

类型: number

当前白板 ID

whiteBoard

类型: IWhiteBoard

当前白板实例

PlaybackState

类型: enum

白板录像回放状态

成员
属性值描述
INIT 0 初始化
PAUSE 1 暂停播放
START 2 开始播放
END 3 停止播放

属性	值	描述
INIT	`0`	初始化
PAUSE	`1`	暂停播放
START	`2`	开始播放
END	`3`	停止播放

PlaybackReason

类型: enum

白板录像回放状态改变原因

成员
属性值描述
DEFAULT 0 用户或系统主动行为
PREPARE_FOR_START 101 开始播放时资源加载
FINISH 601 播放结束
ERROR_DATA 603 数据错误
ERROR_DOWNLOAD_FAIL 604 录像回放数据下载失败

属性	值	描述
DEFAULT	`0`	用户或系统主动行为
PREPARE_FOR_START	`101`	开始播放时资源加载
FINISH	`601`	播放结束
ERROR_DATA	`603`	数据错误
ERROR_DOWNLOAD_FAIL	`604`	录像回放数据下载失败

ConnectionState

类型: enum

RTS 连接状态

成员

属性	值	描述
CONNECTION_START	`0`	进行连接前准备，锁定相关资源。
CONNECTION_STATE_DISCONNECTED	`1`	连接断开。
CONNECTION_STATE_CONNECTING	`2`	首次连接，正在连接中。
CONNECTION_STATE_CONNECTED	`3`	首次连接成功。
CONNECTION_STATE_RECONNECTING	`4`	连接断开后重新连接中。
CONNECTION_STATE_RECONNECTED	`5`	连接断开后重连成功。

IInitParams

类型: interface

白板 SDK 初始化参数

domId

类型: string

绑定网页上的 DOM 元素 ID。

appId

类型: string

每个应用的唯一标识符，由控制台随机生成的。
不同的 appId 生成的实例在互动白板中无法互通。
获取 appId 详见开通服务。

env

类型: Env | undefined

SDK 连接的环境。默认为 0，正式环境。
无需修改。

Env

类型: enum

SDK 连接的环境

成员
属性值描述
kEnvProduct 0 正式环境
kEnvTest 2 测试环境