官方 API 地址: https://developer.qiniu.com/kodo/sdk/1283/javascript
由于七牛提供了 JavaScript 上传的插件,本文将采用该插件实现七牛直传。
1. 获取七牛上传凭证
与阿里云OSS直传不同的是,七牛只需要获取一个
token
即可(本质是一样的)。获取需要后端的配合,提供一个接口。
要注意获取和保存的时机,根据过期时间记录相关
sessionStorage
比较好,既能减少请求的次数,又能保证上传时凭证有效。获取
token
流程:
(1)发送获取 token
请求 --> (2)得到 token
并本地保存,用于之后的直传 --> (3)带着 token
参数向七牛发送请求,直传图片 --> (4) 上传成功,七牛会返回相应的图片地址(这个地址后续需要按照一定规则传给后端)
- 获取
token
示例
/**
* 获取七牛图片上传 token (进入相关页面预先请求)
* @returns {Promise.<T>}
*/
const getUploadToken = () => {
http.post('getUploadToken').then(res => {
if (res.code === 200) {
this.isPull = false;
const expireTime = 30 * 60 * 1000; // 过期时间,单位毫秒(ms)
sessionStorage.setItem('uploadToken', res.data.upload_token);
sessionStorage.setItem('uploadTokenExpireTime', new Date().getTime() + expireTime); // 设置 token 过期时间
sessionStorage.setItem('imgURL', res.data.image_url); // 暂存图片地址
} else {
// 错误统一处理函数
this.errorHandler(res);
}
}).catch(() => {
console.log('error');
});
}
2. 图片处理
- 这里即将使用的
qiniu.min.js
也包含了图片裁剪、缩放、旋转等功能。有兴趣的可以看下这个文档:七牛 - 图片高级处理
这里介绍一下自己实现图片的简单处理。
(1) 压缩图片在 iOS 上存在一个旋转的问题,需要先做处理,这里引入了 exif-js
import Exif from 'exif-js'
(2)图片旋转
/**
* iOS 旋转图片
* @param img 图片
* @param direction 旋转方向
* @param canvas 画布
*/
const rotateImg = (img, direction, canvas) => {
// 最小与最大旋转方向,图片旋转4次后回到原方向
const min_step = 0;
const max_step = 3;
if (img === null) return;
// img 的高度和宽度不能在 img 元素隐藏后获取,否则会出错
let height = img.height;
let width = img.width;
let step = 2;
if (step === null) {
step = min_step;
}
if (direction === 'right') {
step++;
// 旋转到原位置,即超过最大值
step > max_step && (step = min_step);
} else {
step--;
step < min_step && (step = max_step);
}
// 旋转角度以弧度值为参数
let degree = step * 90 * Math.PI / 180;
let ctx = canvas.getContext('2d');
switch (step) {
case 0:
canvas.width = width;
canvas.height = height;
ctx.drawImage(img, 0, 0);
break;
case 1:
canvas.width = height;
canvas.height = width;
ctx.rotate(degree);
ctx.drawImage(img, 0, -height);
break;
case 2:
canvas.width = width;
canvas.height = height;
ctx.rotate(degree);
ctx.drawImage(img, -width, -height);
break;
case 3:
canvas.width = height;
canvas.height = width;
ctx.rotate(degree);
ctx.drawImage(img, -width, 0);
break;
}
}
(3)图片压缩
/*
* canvas 压缩图片
* @param img 图片
* @param Orientation 旋转参数
* @returns ndata 压缩后的数据
*/
const compress = (img, Orientation) => {
let canvas = document.createElement("canvas");
let ctx = canvas.getContext('2d');
//瓦片canvas
let tCanvas = document.createElement("canvas");
let tctx = tCanvas.getContext("2d");
let initSize = img.src.length;
let width = img.width;
let height = img.height;
let time = new Date().getTime();
// 如果图片大于四百万像素,计算压缩比并将大小压至400万以下
let ratio;
if ((ratio = width * height / 4000000) > 1) {
console.log("大于400万像素");
ratio = Math.sqrt(ratio);
width /= ratio;
height /= ratio;
} else {
ratio = 1;
}
canvas.width = width;
canvas.height = height;
// 铺底色
ctx.fillStyle = "#fff";
ctx.fillRect(0, 0, canvas.width, canvas.height);
// 如果图片像素大于100万则使用瓦片绘制
let count;
if ((count = width * height / 1000000) > 1) {
console.log("超过100W像素");
count = ~~(Math.sqrt(count) + 1); //计算要分成多少块瓦片
// 计算每块瓦片的宽和高
let nw = ~~(width / count);
let nh = ~~(height / count);
tCanvas.width = nw;
tCanvas.height = nh;
for (let i = 0; i < count; i++) {
for (let j = 0; j < count; j++) {
tctx.drawImage(img, i * nw * ratio, j * nh * ratio, nw * ratio, nh * ratio, 0, 0, nw, nh);
ctx.drawImage(tCanvas, i * nw, j * nh, nw, nh);
}
}
} else {
ctx.drawImage(img, 0, 0, width, height);
}
// 修复ios上传图片的时候 被旋转的问题
if (Orientation != '' && Orientation != 1) {
switch (Orientation) {
case 6: // 需要顺时针(向左)90度旋转
this.rotateImg(img, 'left', canvas);
break;
case 8: // 需要逆时针(向右)90度旋转
this.rotateImg(img, 'right', canvas);
break;
case 3: // 需要180度旋转
this.rotateImg(img, 'right', canvas);//转两次
this.rotateImg(img, 'right', canvas);
break;
}
}
// 进行最小压缩
let ndata = canvas.toDataURL('image/jpeg', 0.1);
console.log('压缩前:' + initSize);
console.log('压缩后:' + ndata.length);
console.log('压缩率:' + ~~(100 * (initSize - ndata.length) / initSize) + "%");
tCanvas.width = tCanvas.height = canvas.width = canvas.height = 0;
console.log('使用时间:' + (new Date().getTime() - time) + 'ms');
return ndata;
}
(4) 将 base64 图片编码转为 Blob 对象
/*
* 将 base64 图片编码转为 Blob 对象
* @dataURI 图片 base64 编码
* @returns {Blob}
*/
const dataURItoBlob = (dataURI) => {
let byteString = atob(dataURI.split(',')[1]);
let mimeString = dataURI.split(',')[0].split(':')[1].split(';')[0];
let ab = new ArrayBuffer(byteString.length);
let ia = new Uint8Array(ab);
for (let i = 0; i < byteString.length; i++) {
ia[i] = byteString.charCodeAt(i);
}
return new Blob([ab], {type: mimeString});
}
3. 七牛上传方法
(1)引入七牛
import * as qiniu from 'qiniu-js'
(2)上传方法
/**
* 七牛上传
* @param base64String 文件信息(Blob 或 base64String)
*/
const qiniuUpload = (base64String) => {
// 由于有些大图进行压缩后变成了 base64String,而小图没有经过处理仍是 Blob 对象,七牛接收的参数是 Blob 对象,故对字符串类型的参数进行转换
let file;
if (typeof base64String === 'string'){
file = this.dataURItoBlob(base64String);
} else {
file = base64String;
}
// 七牛上传的方法
// 第一个参数是文件对象(Blob),第二个参数是文件名称(这个名称不能相同,命名时候请加入时间搓,确保文件名称唯一),第三个参数是 token
const observable = qiniu.upload(file, file.name, sessionStorage.getItem('uploadToken'), {
fname: file.name,
params: {},
mimeType: [] || null
}, {
useCdnDomain: true, // cdn
unique_names: false, // 唯一名称
region: qiniu.region.z0 // 根据区域设置上传的域名
});
// 返回 Promise,在里面执行七牛直传
return new Promise( (resolve, reject) => {
const subscription = observable.subscribe({
next (res) {
// 上传的进度,可以获得总大小,已传大小,上传百分比进度
},
error (err) {
console.log('失败');
console.log(err);
},
complete (res) {
// 成功后,回调操作
console.log('上传成功');
resolve({
base64String: base64String,
imgUrl: sessionStorage.getItem('imgURL')+'/'+ res.key
});
}
});
});
}
4. 前面所做的都是准备工作,真正触发上传的在这里
/*
* 读文件(<input type="file"> 由 change 事件触发)
* @param file 文件 Blob 对象,由 change 事件触发后传入该参数
* @returns {Promise}
*/
const readFiles = (file) => {
// 首先判断 token 是否过期
async function getToken() {
if (new Date().getTime() > sessionStorage.getItem('uploadTokenExpireTime')) {
getUploadToken();
}
}
return getToken().then(() => {
let Orientation;
let base64String = '';
const reader = new FileReader(); // 创建 FileReader 对象 并调用 render 函数来完成渲染
// 将图片将转成 base64 格式
base64String = reader.readAsDataURL(file);
// iOS 旋转问题
Exif.getData(file, function () {
Orientation = Exif.getTag(this, 'Orientation');
});
// 读取后压缩文件
return new Promise(resolve => {
reader.onloadend = function () {
let result = this.result;
let img = new Image();
img.src = result;
//判断图片是否大于100K,是就直接上传,反之压缩图片
if (this.result.length <= (100 * 1024)) {
resolve(qiniuUpload(result));
} else {
img.onload = function () {
let data = that.compress(img, Orientation);
resolve(that.qiniuUpload(data));
}
}
};
});
});
}
在低版本浏览器使用上存在一定的兼容问题;
上面的方法使用了 es6 语法;
上面的方法不能搬来直接使用,需要做一点小改动。