画布文件操作

更新时间 2024/11/18 12:57:03

画布 Web SDK 的工具栏中内置了文件上传工具，支持将本地文件上传至 oss 服务器，并加载在画布中。除此之外还支持自定义上传工具，直接通过 url 进行文件上传。

图片上传

画布 Web SDK 支持 JPEG、JPG、PNG、GIF 等格式图片上传，除了通过工具栏直接上传外，还支持通过 url 进行图片上传。下方为图片上传 API 说明：

sdkInstance.insertImage(
  url, // 图片文件url地址
  name, // 图片文件名称
);

通过执行该 API 能够将图片上传至服务器，并加载在画布当前视野中心。

文档上传

画布 Web SDK 支持 PDF、PPT、EXCEL、WORD 文档格式上传，除了通过工具栏直接上传外，还支持通过 url 进行文档上传，并提供转码服务。下方为文档上传 API 说明：

sdkInstance.insertDocument(
  url, // 文档文件url地址
  name, // 文档文件名称
  docType, // 文档类型, DOCUMENT_TYPE包括："ppt" | "pdf" | "excel" | "word"
);

通过执行该 API 能够将文档上传至服务器，并加载在画布当前视野的中心。

视频上传

画布 Web SDK 支持 MP4、MOV 等格式视频上传，除了通过工具栏直接上传外，还支持通过 url 进行视频资源上传，并提供转码服务。下方为视频上传 API 说明：

sdkInstance.insertVideo(
  url, // 视频文件url地址
  name, // 视频文件名称
);

通过执行该 API 能够将视频上传至服务器，并加载在画布当前视野的中心。

音频上传

画布 Web SDK 支持 MP3、WAV 等格式音频上传，除了通过工具栏直接上传外，还支持通过 url 进行音频上传。下方为音频上传 API 说明：

sdkInstance.insertAudio(
  url, // 音频文件url地址
  name, // 音频文件名称
);

通过执行该 API 能够将音频上传至服务器，并加载在画布当前视野的中心。

辅助工具函数

为方便您判断使用哪种 Web SDK api 来插入文件，我们还提供了几个文件相关的工具函数，支持根据文件后缀快速判断文件类型：

获取文件类型

import { getFileType } from '@plaso-infi/whiteboard-sdk';

type FileType = 'image' | 'document' | 'video' | 'audio';
const type: FileType | undefined = getFileType(
  ext, // 文件后缀字符串
);

获取文档类型

import { getDocumentType } from '@plaso-infi/whiteboard-sdk';

type DocumentType = 'ppt' | 'pdf' | 'excel' | 'word';
const type: DocumentType | undefined = getDocumentType(
  ext, // 文件后缀字符串
);