微信小程序對接七牛云存儲的方法

2019-11-19 15:57:10

字體：大中小

來源：轉載

供稿：網友

前言：

做小程序有一段時間了，總結一下做過的技術點，特此貢獻給小伙伴們！項目中，有圖片存儲、視頻存儲、錄音存儲這三個需要云對接存儲。

一、圖片/視頻/錄音上傳七牛對接

準備工作：

a、你要有一個七牛賬號，實名認證后，在七牛的個人中心，有個秘鑰管理-里面有一對秘鑰，是上傳必須的。這對秘鑰，配置在后端，配置時可以設置允許上傳格式，也可以設置為任何格式都可上傳，讓我們的后端大哥去慢慢弄吧。另外，還需要在七牛的對象存儲里新建一個存儲空間，所要上傳的文件就是存儲在你創建的空間里，如果你為了方便管理，也可以圖片/視頻/錄音/其他各創建一個存儲空間。這個存儲空間名字，也要配置在后端的。

b、需要一個上傳令牌token，一個文件上傳對應一個token，這是必須的。上傳令牌token還有時效性，后端配置1h，足以讓你完成上傳操作就行。這個token由我們自己后端生成，前端調接口獲取token，或者像我這樣，直接把接口丟在[uptokenURL]后面，七牛的會自己去取。也可以由我們自己先得到token，再丟給七牛。

uptokenURL:'https://get.qiniutoken.com/minibx/geo_f/gain_qn_toke',uploadURL:'https://up.qbox.me',//華東

uptoken: token,uploadURL:'https://up.qbox.me',//華東

c、七牛的js文件qiniuUploader.js，在下面給的七牛地址里面，可以去下載。里面有個小程序的SDK，解壓找到里面的qiniuUploader.js，在你需要上傳的頁面，導入這個js。https://developer.qiniu.com/sdk#community-sdk

1、圖片上傳七牛

通過小程序的方法，為用戶提供添加本地圖片，或者拍照，之后你會得到方法返回的圖片臨時路徑。我們可以把圖片維護在一個數組里，這樣在上傳七牛時，以隊列的形式上傳。

constqiniuUploader = require("../../libs/qiniuUploader.js");var sourceType = [['camera'], ['album'], ['camera','album']];var sizeType = [['compressed'], ['original'], ['compressed','original']];var imageArray = [];// 點擊事件，從本地相冊選擇圖片或使用相機拍照。chooseImage: function (e) {var that =this;wx.chooseImage({　　sourceType: sourceType[this.data.sourceTypeIndex],　　sizeType: sizeType[this.data.sizeTypeIndex],　　count:this.data.count[this.data.countIndex],//這個count可以用來刪除當前圖片　　success: function (res) {　　// 返回照片的本地文件路徑，tempFilePath可以作為img標簽的src屬性顯示圖片vartempFilePaths = res.tempFilePaths;　　imageArray.push(tempFilePaths);　　that.setData({　　imageList: tempFilePaths　　})　　that.pictureUploadqiniuMethod(imageArray,"tupian_");　　},})},//得到圖片路徑數組后，準備上傳七牛pictureUploadqiniuMethod: function (imageArray, fileHead){var that =this;for(vari =0; i < imageArray.length; i++) {　 var filePath = imageArray[i];　　var imgName = filePath.substr(30,50);　　qiniuUploader.upload(filePath, (res) => {　　//上傳成功，上傳成功一張圖片，進入一次這個方法，也就是返回一次　　 console.log(res)},(error) => {　 //圖片上傳失敗，可以在七牛的js里面自己加了一個err錯誤的返回值console.log('error: '+ error)},{　　domain:'oqxfq54dn.bkt.clouddn.com',　 uptokenURL:'https://get.qiniutoken.com/minibx/geo_f/gain_qn_token',　　uploadURL:'https://up.qbox.me',//華東key: fileHead + imgName,// 自定義文件 keyregion:'ECN',});}},

紅線框內的這塊代碼，是七牛qiniuUploader.js文件里的，我加了一個if判斷，為了防止雖然上傳成功，但沒有返回data，這樣在代碼112行獲取返回data時，不至于直接報錯。

解釋:：

imageArray：準備上傳的圖片臨時地址數組。

fileHead：自定義上傳七牛文件名的頭，為了區別上傳文件，比如圖片/視頻/錄音/其他，

imgName：自定義上傳七牛文件名，前端處理嘛，我就簡單的通過截取臨時路徑（filePath ）的30-50位字符作為儲存到七牛的文件名，即使你添加了兩張相同的圖片，小程序給你的臨時路徑也是不一樣的，所以不會存在重名情況。

domain：下載資源時用到。如果設置，在上傳后的success里返回的res.ImageURL字段,是一個帶http的直接可以訪問的文件地址，否則需要自己拼接。

key：最終儲存到七牛的文件名，我這里的圖片文件名=文件頭(fileHead)+偽文件名(imgName)

uploadURL：上傳到七牛的那個存儲區域，上傳區域和上傳區域代碼一定要對應上。

region：上傳區域代碼。

shouldUseQiniuFileName:表示是否由七牛來定義上傳文件名，如果是 true，則文件 key 由 qiniu 服務器分配 (全局去重)。默認是 false，也就是我們自己來定義。如果key設置了，優先級最高。

七牛存儲區域表:

這樣，在需要上傳頁面調用七牛的qiniuUploader.js，就可以上傳了。

會遇到的問題：

某張圖片/視頻/錄音上傳失敗可能的原因：

①上傳文件不是后端所允許的大小，圖片一般小于3M。視頻/錄音我限制是小于1M

②上傳文件格式在后端沒有被允許。

③token獲取失敗，比如我遇到的，七牛的qiniuUploader.js文件通過接口獲取token，默認是這樣[var token = res.data.token;]，而我們后端接口返回的token是這樣

所以我需要在七牛的js文件里修改為[var token = res.data.extra;],要么讓后端改。

2、視頻上傳七牛

視頻上傳和圖片上傳是一個套路，只是文件格式不同，視頻一般就一個文件，不像圖片有多張，需要搞個隊列來上傳。所以上傳視頻就這樣：

//事件綁定，添加視頻chooseVideo: function (res) {　　var that =this;　　wx.chooseVideo({　　　　sourceType: sourceType[this.data.sourceTypeIndex],　　　　camera: camera[this.data.cameraIndex],　　　　maxDuration: duration[this.data.durationIndex],　　　　success: function (res) {　　　　var shipinFile= res.tempFilePath;　　　　that.setData({　　　　src: shipinFile　　});　 　　//用戶尋選擇好圖片后，調用上傳方法　　　　　　that.shipinUploadqiniuMethod(shipinFile,"shipin_");　　　　}　　})},//視頻上傳七牛shipinUploadqiniuMethod: function (shipinFile, fileHead){　　　　var that =this;　　　　var shipinName = shipinFile.substr(30,50);　　　　　　qiniuUploader.upload(shipinFile, (res) => {　　　　//視頻上傳成功console.log(res)　　},　　(error) => {　　　　//視頻上傳失敗，可以在七牛的js里面自己加了一個err錯誤的返回值　　　　console.log('error: '+ error)　　},　　{　　　　domain:'oqxfq54dn.bkt.clouddn.com',　　　　　　uptokenURL:'https://get.qiniutoken.com/minibx/geo_f/gain_qn_token',　　　　　　uploadURL:'https://up.qbox.me',//華東　　　　key: fileHead + shipinName ,// 自定義文件 keyregion:'ECN',//華東區域代碼});　　}},

3、錄音文件上傳七牛

小程序的錄音格式為silk，錄音上傳七牛，可以和視頻共用一個方法。但雖然上傳成功了，狀態碼為403，七牛沒有返回data，像這樣：