概览

最近更新时间:2023-07-14 08:47:02

anyRTC Web SDK 是通过 HTML 网页加载的 JavaScriptTypescript 库。你可以使用 anyRTC Web SDK 在网页浏览器中调用 API 建立连接,控制音视频通话和直播服务。

API 概览

核心方法

方法描述
ArWhiteBoard构造函数
destroy销毁白板

涂鸦相关

方法描述
clear清空当前白板页数据。默认只清除当前白板页的涂鸦,如果 clearBackground 参数为 true,则同时清除涂鸦和背景。
getBrushColor获取画笔颜色。
getBrushThin获取画笔粗细。
getBrushType获取画笔类型。
getEnable获取白板是否可涂鸦。
getTextColor获取设置的文字颜色。
getTextSize获取设置的文字大小。
resize重新计算白板大小,并渲染。
setBrushColor设置画笔颜色。
setBrushThin设置画笔粗细。
setBrushType设置画笔工具类型。
setEnable设置白板是否可涂鸦。
setTextColor设置的文字颜色。
setTextSize设置文字的大小。

白板页操作接口

方法描述
addBoard添加一页白板并切换到这一页。
deleteBoard删除当前白板页并切换到上一页。
getBoardList获取所有文件的白板列表。
getBoardScale获取当前白板页缩放比例。
getBoardRatio获取当前白板页宽高比例。
getBoardSnapshot获取当前白板页的快照。
getCurrentBoardId获取当前白板页 ID。
getCurrentFileId获取当前文件 ID。
getFileBoardList获取指定文件的白板 ID 列表。
getFileInfo获取白板的基本信息。
gotoBoard切换到指定的白板页。
nextBoard切换到下一页白板。
prevBoard切换到上一页白板。
reset重置白板。
setBoardScale设置当前白板页的缩放大小。
setBoardRatio设置当前白板页宽高比例。

背景相关

方法描述
getBackgroundColor获取当前白板页的背景颜色。
getGlobalBackgroundColor获取全局设置的白板页背景颜色。
setBackgroundColor设置当前白板页的背景颜色。
setGlobalBackgroundColor全局设置白板页的背景颜色。
getBackgroundImage获取当前白板页的背景图片。
getBackgroundImageFillMode设置当前白板页的背景图片。
setBackgroundImage获取当前白板页背景图片的填充模式。

撤销和恢复相关

方法描述
redo画笔重做。
undo撤销画笔。

其他

方法描述
getVersion获取 SDK 版本。

引入方式

CDN 引入

unpkg

// 最新版本
<script src="https://unpkg.com/ar-whiteboard"></script>
// 指定版本
<script src="https://unpkg.com/ar-whiteboard@VERSION"></script>

jsdelivr

// 最新版本
<script src="https://cdn.jsdelivr.net/npm/ar-whiteboard"></script>
// 指定版本
<script src="https://cdn.jsdelivr.net/npm/ar-whiteboard@VERSION"></script>

npm 引入

安装

npm install ar-whiteboard -D

项目导入

import ArWhiteBoard from "ar-whiteboard";
const board = new ArWhiteBoard(initParams);

类型模块(适用于 Typescript)

对于 Typescript 开发者,我们提供了 .d.ts 文件导出详细的类型定义。

import ArWhiteBoard, {
  BoardToolType,
  IArBoardInitBaseParams,
  IArBoardInitParams,
  IArBoardInitStyleParams,
  IArBoardInitAuthParams,
  IConfigParameters,
  EBoardToolType,
  EBoardTextStyle,
  EConnectionState,
  EBoardErrorCode
} from "ar-whiteboard";

const board = new ArWhiteBoard(initParams);