微信小程序?qū)崿F(xiàn)云開發(fā)上傳文件、圖片功能
一、前言
今天的博客所實現(xiàn)的功能很簡單,但是也很常用。
本文將這常用的代碼進行了封裝,可以放入自己utils類中使用,加快開發(fā)速度。
實現(xiàn)的功能有兩個:
一、選擇微信聊天文件并上傳。
二、選擇本地相冊/拍攝圖片上傳。
當(dāng)然,看標題就知道是基于云開發(fā)的環(huán)境之下實現(xiàn)的了。
話不多說,進入正文。
二、功能簡介
1、選擇微信聊天記錄中的文件
有時候小程序的使用場景是需要用戶上傳手機的文件,特別是excel、word、PDF等類型的文件。如果選擇讓用戶從本地文件夾里面去找,顯然有點困難。當(dāng)然,不僅僅只能選擇文件,還可以選擇視頻、圖片類型。具體的可以看官方的開發(fā)文檔。
因此小程序提供了一個API(wx.chooseMessageFile()),可以讓用戶從聊天記錄中選擇文件并上傳。
這樣選擇文件就方便很多了,例如:可以在文件傳輸助手中選擇。

2、選擇本地相冊/拍照圖片
選擇相冊圖片/拍攝圖片上傳這個功能就更加常用了。小程序提供實現(xiàn)的API是 wx.chooseImage()。
至于使用場景就不用多說了,很多場景都需要實現(xiàn)這一功能。這里就不做過多介紹,直接塞文檔了。具體的介紹,同學(xué)們可以前往官方文檔查看。

3、上傳功能
前面說了,本文將這幾個實現(xiàn)函數(shù)都進行了封裝,因此選擇文件、選擇圖片、上傳三個功能是拆分出來的,降低了代碼的耦合性和復(fù)用性。
在云開發(fā)中,文件上傳的API與傳統(tǒng)服務(wù)器開發(fā)中的文件上傳API很像。
云開發(fā):wx.cloud.uploadFile() API介紹文檔
服務(wù)器:wx.uploadFile()API介紹文檔

三、實現(xiàn)代碼
1、選擇聊天文件函數(shù)(js)
/**
* 從聊天記錄選擇文件
* @param {number} count 可選擇數(shù)量(1-100)
* @param {string} type 可選擇文件類型 all:全部類型 video: 僅視頻 image: 僅圖片 file: 除了視頻、圖片外的文件類型
*/
chooseMessageFile(count, type) {
return new Promise((resolve, reject) => {
wx.chooseMessageFile({
count: count,
type: type,
success(res) {
resolve(res)
},
fail(err) {
console.log("選擇文件錯誤 =====>", err)
resolve(false)
}
})
})
},
2、選擇相冊函數(shù)(js)
/** 選擇圖片封裝函數(shù)
* @param count 照片數(shù)量
* @param sizeType 照片的質(zhì)量, 默認 ['original', 'compressed']
* @param sourceType 照片來源, 默認 ['album', 'camera']
*/
chooseImg(count, sizeType, sourceType) {
if (!count) count = 1
if (!sizeType) sizeType = ['original', 'compressed']
if (!sourceType) sourceType = ['album', 'camera']
return new Promise((resolve, reject) => {
wx.chooseImage({
count: count,
sizeType: sizeType,
sourceType: sourceType,
success(res) {
resolve(res)
},
fail(err) {
resolve(false)
console.error("===== 選取照片失敗 =====", err)
}
})
})
},
3、上傳文件函數(shù)(js)
/**
* 上傳文件封裝函數(shù), 文件名隨機性處理,由17位隨機字符+13位時間戳組成
* @param {string} filePath 要上傳圖片的臨時路徑
* @param {string} cloudPathPrefix 云數(shù)據(jù)庫存儲位置的文件路徑前綴
*/
upLoadFile(filePath, cloudPathPrefix) {
// 取隨機名
let str = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
let randomStr = '';
for (let i = 17; i > 0; --i) {
randomStr += str[Math.floor(Math.random() * str.length)];
}
randomStr += new Date().getTime()
return new Promise((resolve, reject) => {
let suffix = /\.\w+$/.exec(filePath)[0] //正則表達式返回文件的擴展名
let cloudPath = cloudPathPrefix + '/' + randomStr + suffix
wx.cloud.uploadFile({
cloudPath: cloudPath,
filePath: filePath,
success(res) {
resolve(res)
},
fail(err) {
resolve(false)
console.error("===== 上傳文件失敗 =====", err)
},
})
})
},
4、調(diào)用示例
4-1、云存儲新建文件夾

4-2、完整調(diào)用代碼
WXML代碼
<button type="primary" style="margin-top: 105rpx;" bindtap="uploadFileTap" data-type="file">上傳文件</button> <button type="primary" style="margin-top: 45rpx;" bindtap="uploadFileTap" data-type="img">上傳圖片</button>
JS代碼
// pages/uploadFile/uploadFile.js
Page({
/**
* 頁面的初始數(shù)據(jù)
*/
data: {},
/** 上傳按鈕點擊監(jiān)聽 */
async uploadFileTap(res) {
// 上傳類型
const type = res.currentTarget.dataset.type
let filePathObj = null
let filePathList = []
if (type == 'file') {
filePathObj = await this.chooseMessageFile(1, 'file')
if (!filePathObj) return
filePathList.push(filePathObj.tempFiles[0].path)
} else if (type == 'img') {
filePathObj = await this.chooseImg(2)
if (!filePathObj) return
filePathList = filePathObj.tempFilePaths
} else {
return
}
console.log("選擇文件信息 ====>", filePathObj)
let cloudPathList = []
for (let i = 0; i < filePathList.length; i++) {
const cloudPathObj = await this.upLoadFile(filePathList[i], 'file')
if (!cloudPathObj) {
continue
}
console.log(filePathList[i], "文件上傳成功=====>", cloudPathObj)
cloudPathList.push(cloudPathObj.fileID)
}
console.log("最終返回云文件ID列表 =====>", cloudPathList)
},
/**
* 從聊天記錄選擇文件
* @param {number} count 可選擇數(shù)量(1-100)
* @param {string} type 可選擇文件類型 all:全部類型 video: 僅視頻 image: 僅圖片 file: 除了視頻、圖片外的文件類型
*/
chooseMessageFile(count, type) {
return new Promise((resolve, reject) => {
wx.chooseMessageFile({
count: count,
type: type,
success(res) {
resolve(res)
},
fail(err) {
console.log("選擇文件錯誤 =====>", err)
resolve(false)
}
})
})
},
/** 選擇圖片封裝函數(shù)
* @param count 照片數(shù)量
* @param sizeType 照片的質(zhì)量, 默認 ['original', 'compressed']
* @param sourceType 照片來源, 默認 ['album', 'camera']
*/
chooseImg(count, sizeType, sourceType) {
if (!count) count = 1
if (!sizeType) sizeType = ['original', 'compressed']
if (!sourceType) sourceType = ['album', 'camera']
return new Promise((resolve, reject) => {
wx.chooseImage({
count: count,
sizeType: sizeType,
sourceType: sourceType,
success(res) {
resolve(res)
},
fail(err) {
resolve(false)
console.error("===== 選取照片失敗 =====", err)
}
})
})
},
/**
* 上傳文件封裝函數(shù), 文件名隨機性處理,由17位隨機字符+13位時間戳組成
* @param {string} filePath 要上傳圖片的臨時路徑
* @param {string} cloudPathPrefix 云數(shù)據(jù)庫存儲文件路徑前綴
*/
upLoadFile(filePath, cloudPathPrefix) {
// 取隨機名
let str = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
let randomStr = '';
for (let i = 17; i > 0; --i) {
randomStr += str[Math.floor(Math.random() * str.length)];
}
randomStr += new Date().getTime()
return new Promise((resolve, reject) => {
let suffix = /\.\w+$/.exec(filePath)[0] //正則表達式返回文件的擴展名
let cloudPath = cloudPathPrefix + '/' + randomStr + suffix
wx.cloud.uploadFile({
cloudPath: cloudPath,
filePath: filePath,
success(res) {
resolve(res)
},
fail(err) {
resolve(false)
console.error("===== 上傳文件失敗 =====", err)
},
})
})
},
})
4-3、實現(xiàn)效果

上傳成功

將文件或圖片上傳成功后,會返回存儲文件的fileID鏈接。將這個鏈接以及相關(guān)的信息存入數(shù)據(jù)庫即可,當(dāng)需要讀取的時候,從數(shù)據(jù)庫讀取,并將鏈接賦值給Image即可將圖片顯示出來。
四、結(jié)語
實際開發(fā)中的其他邏輯就不寫了。需要同學(xué)們自己去考慮異常情況處理等問題啦。
到此這篇關(guān)于微信小程序?qū)崿F(xiàn)云開發(fā)上傳文件、圖片功能的文章就介紹到這了,更多相關(guān)微信小程序云開發(fā)上傳文件圖片內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
jQuery Mobile動態(tài)刷新頁面樣式的實現(xiàn)方法
下面小編就為大家?guī)硪黄猨Query Mobile動態(tài)刷新頁面樣式的實現(xiàn)方法。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2016-05-05

