微信小程序之多文件下載的簡單封裝示例
需求
需要生成一個宣傳的圖片分享到朋友圈,這個宣傳圖片包含二維碼,包含不同的背景圖片和不同的文字。對于這種圖片生成,我們考慮過使用服務端生成,但是這樣會比較耗服務器性能,所以最終決定使用本地生成。
首先小程序有一個限制,包不能大于2m,而且我們可能多個背景圖,所以計劃把背景圖和二維碼圖片放在服務端,這樣可以減少小程序包的大小,也可以靈活的切換背景圖。
在繪制分享圖的時候,可以直接使用互聯(lián)網地址,但是遇到了一個問題,有可能不能生成圖片,所以我們需要把這個圖片文件下載下來。
下載文件的方法微信有API,但是返回的是文件的臨時路徑,只在小程序本次啟動期間可以正常使用,如需持久保存,需在主動調用 wx.saveFile,才能在小程序下次啟動時訪問得到。
所以我們先把下載文件和保存文件封裝
封裝下載并且保存一個文件
這個方法比較簡單
參數(shù):一個對象,包含
- id 需要下載文件的id,如果不傳默認是下載的url,之所以需要id,是因為我們要做多文件下載,可以區(qū)分下載的是一個文件
- url 下載文件的網絡地址(需要微信小程序后臺配置,具體配置方法請參考微信官方文檔)
- success 成功回調 返回參數(shù)是一個對象 包含 id,savedFilePath
- 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))需要在微信小程序配置服務器域名,服務器域名請在 小程序后臺-設置-開發(fā)設置-服務器域名 中進行配置 ,具體請參考 微信官方文檔
封裝多文件下載并且保存
多文件下載并且保存,強制規(guī)定,必須所有文件下載成功才算返回成功
參數(shù):一個對象,包含
- urls 下載地址 數(shù)組,支持多個 url下載 [url1,url2]
- success 下載成功 (必須所有文件下載成功才算返回成功) 回調參數(shù) map ,key(id) -> value ({id,savedFilePath})
- fail 下載失敗,只要有一個方法失敗就調用失敗
/** * 多文件下載并且保存,強制規(guī)定,必須所有文件下載成功才算返回成功 */ function downloadSaveFiles(obj) { // console.info("準備下載。。。"); let that = this; let success = obj.success; //下載成功 let fail = obj.fail; //下載失敗 let urls = obj.urls; //下載地址 數(shù)組,支持多個 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); } } }) } /** * 多文件下載并且保存,強制規(guī)定,必須所有文件下載成功才算返回成功 */ function downloadSaveFiles(obj) { // console.info("準備下載。。。"); let that = this; let success = obj.success; //下載成功 let fail = obj.fail; //下載失敗 let urls = obj.urls; //下載地址 數(shù)組,支持多個 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("下載失敗"); } );
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
JavaScript數(shù)組reduce()方法使用實例詳解
reduce是數(shù)組原型對象上的一個方法,可以幫助我們操作數(shù)組。本文將和大家分享4個關于JavaScript中數(shù)組reduce的用法,希望對大家有所幫助2022-07-07fullPage.js和CSS3實現(xiàn)全屏滾動效果
這篇文章主要為大家詳細介紹了fullPage.js和CSS3實現(xiàn)全屏滾動效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-05-05