@xylink/xy-upload-sdk v0.0.3

XY Upload SDK

一、简介

XY Upload SDK 是为集成小鱼OSS上传提供的JS SDK，支持分片上传、断点续传

二、安装

$ yarn add @xylink/xy-upload-sdk --dev
or
$ npm install @xylink/xy-upload-sdk --dev

三、API详述

1. 创建上传实例

重点说明：每上传一个文件都应创建一个上传实例，切勿用一个上传实例，连续上传多个文件

import xyUpload from '@xylink/xy-upload-sdk';

const client = xyUpload.createClient({
  server,
  enterpriseId,
  jsCode,
  uploadNonce,
  storeType
});

interface IConfig {
  // 必填：api 服务地址
  server: string;
  // 必填：企业id
  enterpriseId: string;
  // 必填：临时jsCode
  jsCode: string; 
  // 必填：随机字符
  uploadNonce: string; 
  // 必填：storeType
  storeType: string;
  // 选填：上传文件类型限制 例：['video/mp4','image/jpeg']，若不设置，可上传任何格式文件
  supportFileTypes?: string[];
}

2. 监听上传过程中的事件、状态变化

// 上传成功
client.on('success', (res: IResource) => { 
});

// 上传异常
client.on('error', (err: IError) => { 
});

// 监听上传进度 例：0.1 0.2 ..., 可转化成百分比
client.on('progress', (progress: number) => { 
});

// 上传暂停
client.on('pause', () => {
});

// 上传取消，会删除正在进行的上传，并且已经上传完成的片段也会被删除
client.on('abort', () => {
});

// 上传开始 开始上传或恢复上传后会触发
client.on('start', () => {
});

// 上传成功返回数据类型
interface IResource {
  preresourceId: string;
  resourceId: string;
  url: string;  // 资源路径
}

// 错误信息格式
interface IError {
  errorCode: number;
  errorMessage: string;
}

3. 开始上传

开始上传后，会触发start事件

// file 为将要上传的文件对象
client.startUpload(file: File);

4. 暂停上传

上传暂停后，会触发pause事件

client.pauseUpload();

5. 恢复上传

恢复上传后会触发start事件

client.resumeUpload();

6. 取消上传

• 取消上传后会触发abort事件
• 取消上传只能在当前上传暂停或者进行中调用，如果上传已经成功，则无法取消

client.abortUpload();

四、异常处理

监控异常请在error事件中监听

1. 操作异常

2. 服务端异常

服务端异常只有在传参错误的情况下才会发生

五、demo

github地址：https://github.com/xylink-com/xylink-upload-demo

六、版本说明