• swan.downloadFile
  • 方法參數(shù)
    • object 參數(shù)說明
    • success 返回參數(shù)說明
    • fail 返回參數(shù)說明
  • 示例
    • 圖片示例
    • 代碼示例 1
    • 代碼示例 2：指定下載路徑
  • Bug & Tip

swan.downloadFile

請(qǐng)參考使用注意事項(xiàng)進(jìn)行開發(fā)。
解釋：下載文件資源到本地，客戶端直接發(fā)起一個(gè) HTTP GET 請(qǐng)求，返回文件的本地臨時(shí)路徑。

創(chuàng)新互聯(lián)建站于2013年成立，是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司，擁有項(xiàng)目成都做網(wǎng)站、成都網(wǎng)站制作網(wǎng)站策劃，項(xiàng)目實(shí)施與項(xiàng)目整合能力。我們以讓每一個(gè)夢(mèng)想脫穎而出為使命，1280元南川做網(wǎng)站,已為上家服務(wù),為南川各地企業(yè)和個(gè)人服務(wù),聯(lián)系電話:18980820575

方法參數(shù)

Object object

object 參數(shù)說明

屬性名	類型	必填	默認(rèn)值	說明
url	String	是		下載資源的 url
header	Object	否		HTTP 請(qǐng)求 Header ，Header 中不能設(shè)置 Referer
filePath	String	否		指定文件下載后存儲(chǔ)的路徑
success	Function	否		下載成功后以 tempFilePath 的形式傳給頁面，res = {tempFilePath: ‘文件的臨時(shí)路徑’}
fail	Function	否		接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否		接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）

success 返回參數(shù)說明

參數(shù)	類型	說明
tempFilePath	String	臨時(shí)文件路徑，下載后的文件會(huì)存儲(chǔ)到一個(gè)臨時(shí)文件
statusCode	Number	開發(fā)者服務(wù)器返回的 HTTP 狀態(tài)碼

fail 返回參數(shù)說明

• Android

錯(cuò)誤碼	說明
202	解析失敗，請(qǐng)檢查參數(shù)是否正確
1001	執(zhí)行錯(cuò)誤

• iOS

錯(cuò)誤碼	說明
202	解析失敗，請(qǐng)檢查參數(shù)是否正確
1001	請(qǐng)求文件超過 50M
1002	無法確定下載文件大小

示例

跳轉(zhuǎn)編輯工具

在開發(fā)者工具中打開

在 WEB IDE 中打開

掃碼體驗(yàn)

代碼示例

請(qǐng)使用百度APP掃碼

圖片示例

代碼示例 1

• SWAN
• JS

 
 
 

  
  
  
  
  
  
 
  
  
  
 
  
  
  
 
  
  
  
 
  
  
  
 
  
  
  
 示例文件.pdf
  
  
  
 
  
  
  
 下載文件
  
  
  
 
  
  
  
 
 
 

代碼示例 2：指定下載路徑

在開發(fā)者工具中打開

在開發(fā)者工具中打開

在 WEB IDE 中打開

• JS

 
 
 

  
  
  
Page({
  
  
  
 onLoad(e) {
  
  
  
 console.log('建議在真機(jī)查看效果');
  
  
  
 },
  
  
  
 downloadFile() {
  
  
  
 this.toast('正在保存', 'loading');
  
  
  
 swan.downloadFile({
  
  
  
 url: 'https://b.bdstatic.com/miniapp/assets/docs/sprddemofile-sample.pdf',
  
  
  
 header: {
  
  
  
 'content-type': 'application/json'
  
  
  
 },
  
  
  
 filePath: 'bdfile://usr/辦理指南文檔.pdf',
  
  
  
 success: res => {
  
  
  
 let filePath = res.filePath;
  
  
  
 swan.showModal({
  
  
  
 title: '文件下載完成',
  
  
  
 content: '是否需要打開？',
  
  
  
 confirmText: '打開',
  
  
  
 success: res => {
  
  
  
 if (res.confirm) {
  
  
  
 swan.openDocument({
  
  
  
 filePath: filePath,
  
  
  
 fileType: 'pdf',
  
  
  
 success: res => {
  
  
  
 console.log('openDocument', res)
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 console.log('openDocument', err)
  
  
  
 this.toast('打開失敗');
  
  
  
 }
  
  
  
 });
  
  
  
 }
  
  
  
 }
  
  
  
 });
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 this.toast('下載文件失敗');
  
  
  
 },
  
  
  
 complete: () => {
  
  
  
 swan.hideToast();
  
  
  
 }
  
  
  
 });
  
  
  
 },
  
  
  
 toast(title, icon = 'none') {
  
  
  
 swan.showToast({title, icon});
  
  
  
 }
  
  
  
});
 
 
 

返回值：
返回一個(gè) downloadTask 對(duì)象，通過 downloadTask ，可監(jiān)聽下載進(jìn)度變化事件，以及取消下載任務(wù)。

Bug & Tip

• Tip：文件的臨時(shí)路徑，在智能小程序本次啟動(dòng)期間可以正常使用，如需持久保存，需再主動(dòng)調(diào)用 swan.saveFile ，才能在智能小程序下次啟動(dòng)時(shí)訪問得到。
• Tip：請(qǐng)?jiān)?Header 中指定合理的 Content-Type 字段，以保證客戶端正確處理文件類型。
• Tip：下載最大限制 50MB 。

本文題目：創(chuàng)新互聯(lián)百度小程序教程：swan.downloadFile
URL網(wǎng)址：http://uogjgqi.cn/article/dpisidj.html