视频1 视频21 视频41 视频61 视频文章1 视频文章21 视频文章41 视频文章61 推荐1 推荐3 推荐5 推荐7 推荐9 推荐11 推荐13 推荐15 推荐17 推荐19 推荐21 推荐23 推荐25 推荐27 推荐29 推荐31 推荐33 推荐35 推荐37 推荐39 推荐41 推荐43 推荐45 推荐47 推荐49 关键词1 关键词101 关键词201 关键词301 关键词401 关键词501 关键词601 关键词701 关键词801 关键词901 关键词1001 关键词1101 关键词1201 关键词1301 关键词1401 关键词1501 关键词1601 关键词1701 关键词1801 关键词1901 视频扩展1 视频扩展6 视频扩展11 视频扩展16 文章1 文章201 文章401 文章601 文章801 文章1001 资讯1 资讯501 资讯1001 资讯1501 标签1 标签501 标签1001 关键词1 关键词501 关键词1001 关键词1501 专题2001
微信小程序之多文件下载的简单封装示例
2020-11-27 22:20:37 责编:小采
文档

需求

需要生成一个宣传的图片分享到朋友圈,这个宣传图片包含二维码,包含不同的背景图片和不同的文字。对于这种图片生成,我们考虑过使用服务端生成,但是这样会比较耗服务器性能,所以最终决定使用本地生成。

首先小程序有一个,包不能大于2m,而且我们可能多个背景图,所以计划把背景图和二维码图片放在服务端,这样可以减少小程序包的大小,也可以灵活的切换背景图。

在绘制分享图的时候,可以直接使用互联网地址,但是遇到了一个问题,有可能不能生成图片,所以我们需要把这个图片文件下载下来。

下载文件的方法微信有API,但是返回的是文件的临时路径,只在小程序本次启动期间可以正常使用,如需持久保存,需在主动调用 wx.saveFile,才能在小程序下次启动时访问得到。

所以我们先把下载文件和保存文件封装

封装下载并且保存一个文件

这个方法比较简单

参数:一个对象,包含

  1. id 需要下载文件的id,如果不传默认是下载的url,之所以需要id,是因为我们要做多文件下载,可以区分下载的是一个文件
  2. url 下载文件的网络地址(需要微信小程序后台配置,具体配置方法请参考微信官方文档)
  3. success 成功回调 返回参数是一个对象 包含 id,savedFilePath
  4. fail 失败回调 ,下载失败,保存都是都算失败
/**
 * 下载保存一个文件
 */
function downloadSaveFile(obj) {
 let that = this;
 let success = obj.success;
 let fail = obj.fail;
 let id = "";
 let url = obj.url;
 if (obj.id){
 id = obj.id;
 }else{
 id = url;
 }
 // console.info("%s 开始下载。。", obj.url);
 wx.downloadFile({
 url: obj.url,
 success: function (res) {
 wx.saveFile({
 tempFilePath: res.tempFilePath,
 success: function (result) {
 result.id = id;
 if (success) {
 success(result);
 }
 },
 fail: function (e) {
 console.info("保存一个文件失败");
 if (fail) {
 fail(e);
 }
 }
 })
 },
 fail: function (e) {
 console.info("下载一个文件失败");
 if (fail) {
 fail(e);
 }
 }
 })
}

使用下载方法(wx.downloadFile(obj))需要在微信小程序配置服务器域名,服务器域名请在 小程序后台-设置-开发设置-服务器域名 中进行配置 ,具体请参考 微信官方文档

封装多文件下载并且保存

多文件下载并且保存,强制规定,必须所有文件下载成功才算返回成功

参数:一个对象,包含

  1. urls 下载地址 数组,支持多个 url下载 [url1,url2]
  2. success 下载成功 (必须所有文件下载成功才算返回成功) 回调参数 map ,key(id) -> value ({id,savedFilePath})
  3. fail 下载失败,只要有一个方法失败就调用失败
/**
 * 多文件下载并且保存,强制规定,必须所有文件下载成功才算返回成功
 */
function downloadSaveFiles(obj) {
 // console.info("准备下载。。");
 let that = this;
 let success = obj.success; //下载成功
 let fail = obj.fail; //下载失败
 let urls = obj.urls; //下载地址 数组,支持多个 url下载 [url1,url2]
 let savedFilePaths = new Map();
 let urlsLength = urls.length; // 有几个url需要下载
 for (let i = 0; i < urlsLength; i++) {
 downloadSaveFile({
 url: urls[i],
 success: function (res) {
 //console.dir(res);
 //一个文件下载保存成功
 let savedFilePath = res.savedFilePath;
 
 savedFilePaths.set(res.id, res);
 console.info("savedFilePath:%s", savedFilePath);
 if (savedFilePaths.size == urlsLength) { //如果所有的url 才算成功
 if (success){
 success(savedFilePaths)
 }
 
 }
 },
 fail: function (e) {
 console.info("下载失败");
 if (fail) {
 fail(e);
 }

 }
 })
 }
}

完整的download.js文件

/**
 * 下载管理器
 * Created by 全科 on 2018/1/27.
 */
/**
 * 下载保存一个文件
 */
function downloadSaveFile(obj) {
 let that = this;
 let success = obj.success;
 let fail = obj.fail;
 let id = "";
 let url = obj.url;
 if (obj.id){
 id = obj.id;
 }else{
 id = url;
 }
 // console.info("%s 开始下载。。", obj.url);
 wx.downloadFile({
 url: obj.url,
 success: function (res) {
 wx.saveFile({
 tempFilePath: res.tempFilePath,
 success: function (result) {
 result.id = id;
 if (success) {
 success(result);
 }
 },
 fail: function (e) {
 console.info("保存一个文件失败");
 if (fail) {
 fail(e);
 }
 }
 })

 },
 fail: function (e) {
 console.info("下载一个文件失败");
 if (fail) {
 fail(e);
 }

 }
 })
}
/**
 * 多文件下载并且保存,强制规定,必须所有文件下载成功才算返回成功
 */
function downloadSaveFiles(obj) {
 // console.info("准备下载。。");
 let that = this;
 let success = obj.success; //下载成功
 let fail = obj.fail; //下载失败
 let urls = obj.urls; //下载地址 数组,支持多个 url下载 [url1,url2]
 let savedFilePaths = new Map();
 let urlsLength = urls.length; // 有几个url需要下载
 for (let i = 0; i < urlsLength; i++) {
 downloadSaveFile({
 url: urls[i],
 success: function (res) {
 console.dir(res);
 //一个文件下载保存成功
 let savedFilePath = res.savedFilePath; 
 savedFilePaths.set(res.id, res);
 console.info("savedFilePath:%s", savedFilePath);
 if (savedFilePaths.size == urlsLength) { //如果所有的url 才算成功
 if (success){
 success(savedFilePaths)
 } 
 }
 },
 fail: function (e) {
 console.info("下载失败");
 if (fail) {
 fail(e);
 }
 }
 })
 }
}
module.exports = {
 downloadSaveFiles: downloadSaveFiles
}

使用

首先导入

import download from "download.js"

之后调用

let url1 = 'https://xcx.upload.utan.com/article/coverimage/2018/01/25/eyJwaWMiOiIxNTE2ODU2Nzc0Njk3OCIsImRvbWFpbiI6InV0YW50b3V0aWFvIn0=';
let url2 = 'https://xcx.upload.utan.com/article/coverimage/2018/01/26/eyJwaWMiOiIxNTE2OTcyNDg0NDUzOSIsImRvbWFpbiI6InV0YW50b3V0aWFvIn0=';
download.downloadSaveFiles({
 urls: [url1, url2],
 success: function (res) {
 // console.dir(res);
 
 console.info(res.get(url2).savedFilePath)
 },
 fail: function (e) {
 console.info("下载失败");
 }
);

下载本文
显示全文
专题