1.2.1 • Published 7 months ago

ar-whiteboard v1.2.1

Weekly downloads
-
License
MIT
Repository
-
Last release
7 months ago

SDK 会在全局导出一个 ArWhiteBoard 对象,可以通过 new 方法创建一个白板实例。一个白板实例代表一个白板客户端。

// 初始化配置
const initConfig = {
  id: '<DOM_ID>',
  appId: '<APP_ID>',
  userId: '<U_ID>',
  channel: '<CHANNEL_ID>',
  token: '<TOKEN>',
};
const Board = new ArWhiteBoard(initConfig);

概览

Board 实例包含了以下方法:

全局事件回调
add-board添加白板页
delete-board删除白板页
goto-board白板页切换
clear-board清空画板
reset-board重置画板
board-can-redo-status当前白板页是否可重做
board-can-undo-status当前白板页是否可撤销
board-error白板错误回调
board-scale-change当前白板页缩放比例变化
board-warning白板警告回调
connection-state-change网络状态回调
board-background-color-change背景颜色更改
核心方法
new ArWhiteBoard白板构造函数,创建白板实例
destroy销毁白板实例
涂鸦相关方法
clear清空当前白板页数据。默认只清除当前白板页的涂鸦,如果 clearBackground 参数为 true,则同时清除涂鸦和背景。
getBrushColor获取画笔颜色。
getBrushThin获取画笔粗细。
getBrushType获取画笔类型。
getEnable获取白板是否可涂鸦。
getTextColor获取设置的文字颜色。
getTextSize获取设置的文字大小。
resize重新计算白板大小,并渲染。
setBrushColor设置画笔颜色。
setBrushThin设置画笔粗细。
setBrushType设置画笔工具类型。
setEnable设置白板是否可涂鸦。
setTextColor设置的文字颜色。
setTextSize设置文字的大小。
白板页相关方法
addBoard添加一页白板并切换到这一页。
deleteBoard删除当前白板页并切换到上一页。
getBoardList获取所有文件的白板列表。
getBoardScale获取当前白板页缩放比例。
getBoardSnapshot获取当前白板页的快照。
getCurrentBoardId获取当前白板页 ID。
getCurrentFileId获取当前文件 ID。
getFileBoardList获取指定文件的白板 ID 列表。
getFileInfo获取白板的基本信息。
gotoBoard切换到指定的白板页。
nextBoard切换到下一页白板。
prevBoard切换到上一页白板。
reset重置白板。
setBoardScale设置当前白板页的缩放大小。
背景相关方法
getBackgroundColor获取当前白板页的背景颜色。
getGlobalBackgroundColor获取全局设置的白板页背景颜色。
setBackgroundColor设置当前白板页的背景颜色。
setGlobalBackgroundColor全局设置白板页的背景颜色。
撤销和恢复相关方法
redo画笔重做。
undo撤销画笔。
其他方法
getVersion获取 SDK 版本。

注意事项

选择画笔工具,避免使用 <select> 标签

因为使用 <select> 标签,document.activeElement 会变成 select 对象,画板会无法捕捉到 mouseout 事件,因此会导致激光笔工具再特定情况下移出画板无法删除激光笔。

收不到(或者收到多次)回调

  • 检查是否在方法调用后监听的回调,确保回调在调用方法之前注册(监听)。
  • 如果收到多次回调,检查是否自己封装的方法中多次监听回调方法(正常回调只需要注册一遍)。

主持人(老师)和观众(学生)

SDK 没有人员身份的标识和逻辑,客户端可以根据自己的业务需求,结合自己的业务系统配合 SDK uid 进行人员权限分配。

橡皮擦

  • 可以擦除任何人的画笔痕迹
  • 擦除后,该画笔变更为改画笔的临时拥有者,可以对该画笔进行撤销和重做

撤销和重做

  • 只能撤销和重做自己的画笔
  • 如果自己的画笔被其他人移动了,则该笔仅能被该移动者撤销和重做
  • 清空白板(或背景)不允许被撤销和重做

重置画板

  • 重置画板会删除所有画板页,仅保留第一页,但是不保留第一页的涂鸦

重连

  • 重连时丢失的画笔,SDK 不保存。
  • 断网期间进行的绘画,重连后不会同步。
1.2.1-fix.1

10 months ago

1.2.1-fix.0

10 months ago

1.2.1-fix.2

8 months ago

1.2.1

7 months ago

1.2.0

11 months ago

1.1.1

12 months ago

1.1.0

12 months ago

1.0.13

1 year ago

1.0.11

2 years ago

1.0.12

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.10

2 years ago

1.0.2

3 years ago

1.0.6

3 years ago

1.0.5

3 years ago

1.0.4

3 years ago

1.0.3

3 years ago

1.0.1

3 years ago

0.0.10

4 years ago

0.0.11

4 years ago

0.0.12

4 years ago

0.0.9

5 years ago

0.0.8

5 years ago

0.0.7

5 years ago

0.0.6

5 years ago

0.0.5

5 years ago

0.0.4

5 years ago

0.0.3

5 years ago

0.0.2

5 years ago

0.0.1

5 years ago