新聞中心
- swan.downloadFile
- 方法參數(shù)
- object 參數(shù)說明
- success 返回參數(shù)說明
- fail 返回參數(shù)說明
- 示例
- 圖片示例
- 代碼示例 1
- 代碼示例 2:指定下載路徑
- Bug & Tip
- 方法參數(shù)
swan.downloadFile
請參考使用注意事項進(jìn)行開發(fā)。
解釋:下載文件資源到本地,客戶端直接發(fā)起一個 HTTP GET 請求,返回文件的本地臨時路徑。

創(chuàng)新互聯(lián)建站于2013年成立,是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司,擁有項目成都做網(wǎng)站、成都網(wǎng)站制作網(wǎng)站策劃,項目實施與項目整合能力。我們以讓每一個夢想脫穎而出為使命,1280元南川做網(wǎng)站,已為上家服務(wù),為南川各地企業(yè)和個人服務(wù),聯(lián)系電話:18980820575
方法參數(shù)
Object object
object 參數(shù)說明
| 屬性名 | 類型 | 必填 | 默認(rèn)值 | 說明 |
|---|---|---|---|---|
url |
String |
是 |
下載資源的 url | |
header |
Object |
否 |
HTTP 請求 Header ,Header 中不能設(shè)置 Referer | |
filePath |
String |
否 |
指定文件下載后存儲的路徑 | |
success |
Function |
否 |
下載成功后以 tempFilePath 的形式傳給頁面, | |
fail |
Function |
否 |
接口調(diào)用失敗的回調(diào)函數(shù) | |
complete |
Function |
否 |
接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行) |
success 返回參數(shù)說明
| 參數(shù) | 類型 | 說明 |
|---|---|---|
tempFilePath |
String |
臨時文件路徑,下載后的文件會存儲到一個臨時文件 |
statusCode |
Number |
開發(fā)者服務(wù)器返回的 HTTP 狀態(tài)碼 |
fail 返回參數(shù)說明
- Android
| 錯誤碼 | 說明 |
|---|---|
202 |
解析失敗,請檢查參數(shù)是否正確 |
1001 |
執(zhí)行錯誤 |
- iOS
| 錯誤碼 | 說明 |
|---|---|
202 |
解析失敗,請檢查參數(shù)是否正確 |
1001 |
請求文件超過 50M |
1002 |
無法確定下載文件大小 |
示例
跳轉(zhuǎn)編輯工具
在開發(fā)者工具中打開
在 WEB IDE 中打開
掃碼體驗
代碼示例
請使用百度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});}});
返回值:
返回一個 downloadTask 對象,通過 downloadTask ,可監(jiān)聽下載進(jìn)度變化事件,以及取消下載任務(wù)。
Bug & Tip
- Tip:文件的臨時路徑,在智能小程序本次啟動期間可以正常使用,如需持久保存,需再主動調(diào)用 swan.saveFile ,才能在智能小程序下次啟動時訪問得到。
- Tip:請在 Header 中指定合理的 Content-Type 字段,以保證客戶端正確處理文件類型。
- Tip:下載最大限制 50MB 。
網(wǎng)頁題目:創(chuàng)新互聯(lián)百度小程序教程:swan.downloadFile
分享網(wǎng)址:http://www.5511xx.com/article/dpisidj.html


咨詢
建站咨詢
