IArBoardInitParams

最近更新时间:2023-06-08 01:31:38

SDK 加入频道时需要的身份凭证以及自定义房间号用户 ID 的设置

用于配置 SDK 连接的私有化网关。

你可以在 new ArWhiteBoard 方法中传入该配置对象来配置。

示例:

import ArWhiteBoard, { IArBoardInitParams } from 'ar-whiteboard'

const initParams: IArBoardInitParams = {
  id: '<DOM_ID>',
  appId: '<YOUR_APPID>',
  channel: '<YOUR_CHANNEL_ID>',
  userId: '<YOUR_USER_ID>',
  token: null, // YOUR_TOKEN
}const board = new ArWhiteBoard(initParams);

id

id: string

白板父容器 DOM id。

appId

appId: string

应用 ID

channel

channel: string

频道 ID。标识通话的频道名称,长度在 64 字节以内的字符串。以下为支持的字符集范围(共 89 个字符):

  • 26 个小写字母 a-z。
  • 26 个大写字母 A-Z。
  • 10 个数字 0-9。
  • 空格。
  • "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "*", "{", "}", "|", "~", ","。

userId

userId: string

标识用户的 ID,长度在 64 字节以内的字符串。以下为支持的字符集范围(共 89 个字符):

  • 26 个小写字母 a-z。
  • 26 个大写字母 A-Z。
  • 10 个数字 0-9。
  • 空格。
  • "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "*", "{", "}", "|", "~", ","。

Optional token

token?: string

用于鉴权的 token

  • 如果你的项目没有开启 token 鉴权,这里填 null。
  • 安全要求不高: 你可以使用控制台生成的临时 token,详见获取临时 Token
  • 安全要求高:传入从你的服务端获得的正式 token(不支持 Channel Key),详见获取正式 Token

Optional baseParams

baseParams?: IArBoardInitBaseParams

基础配置。

progressBarUrl 地址必须是 http 、https 或者 base64 图片地址。

属性名类型描述
ratiostring宽高比例,默认 16:9
scalenumber白板缩放比例,默认 100
toolTypeBoardToolType白板工具类型,默认 BoardToolType.FREE_DRAW
progressBarUrlstring自定义加载图标,在 progressEnabletrue 时生效,支持 jpg、gif、png、svg
imageResourceTimeoutnumber白板背景图片加载超时时间(单位:毫秒),默认 30000

Optional styleParams

styleParams?: IArBoardInitStyleParams

样式配置。

属性名类型描述
textStyleEArBoardTextStyle文字的样式:粗体、斜体、粗斜体
textSizenumber文字大小
textColorstring文字颜色
brushColorstring画笔颜色
brushThinnumber画笔粗细
globalBackgroundColorstring全局背景颜色
selectBoxColorstring框选工具边框颜色

Optional authParams

authParams?: IArBoardInitAuthParams

权限配置。

属性名类型描述
drawEnableboolean是否允许涂鸦,默认为 true
progressEnableboolean是否启用SDK内置 Loading 图标, 默认为 false

Optional serverParams

serverParams?: IConfigParameters

私有服务配置。

  • Optional ConfPriCloudAddr

私有服务配置

属性名类型描述
ServerAddstring私有服务域名或 IP
Portnumber私有服务端口号
Wssboolean私有服务是否使用安全协议 HTTPS/WSS
  • Optional ConfPriCloudAddr1

备用私有服务配置

属性名类型描述
ServerAddstring私有服务域名或 IP
Portnumber私有服务端口号
Wssboolean私有服务是否使用安全协议 HTTPS/WSS