wx.downloadFile · 微信小游戏开发API官方文档

# wx.downloadFile ### DownloadTask wx.downloadFile(Object object) 下载文件资源到本地，客户端直接发起一个 HTTPS GET 请求，返回文件的本地临时路径。使用前请注意阅读[相关说明](https://developers.weixin.qq.com/minigame/dev/tutorial/ability/network.html)。注意：请在服务端响应的 header 中指定合理的 `Content-Type` 字段，以保证客户端正确处理文件类型。 #### 参数 ##### Object object 属性类型默认值是否必填说明支持版本urlstring是下载资源的 urlheaderObject否HTTP 请求的 Header，Header 中不能设置 RefererfilePathstring否指定文件下载后存储的路径>= 1.8.0successfunction否接口调用成功的回调函数failfunction否接口调用失败的回调函数completefunction否接口调用结束的回调函数（调用成功、失败都会执行）###### object.success 回调函数 **参数** **Object res** 属性类型说明支持版本tempFilePathstring临时文件路径。如果没传入 filePath 指定文件存储路径，则下载后的文件会存储到一个临时文件statusCodenumber开发者服务器返回的 HTTP 状态码#### 返回值 ##### DownloadTask > 支持版本 >= 1.4.0 一个可以监听下载进度变化事件和取消下载的对象 #### 示例代码 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">wx.downloadFile({</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> url: 'https://example.com/audio/123', //仅为示例，并非真实的资源</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> success (res) {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> // 只要服务器有响应数据，就会把响应内容写入文件并进入 success 回调，业务需要自行判断是否下载到了想要的内容</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> if (res.statusCode === 200) {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> wx.playVoice({</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> filePath: res.tempFilePath</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> })</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> }</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> }</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/network/download/wx.downloadFile.html>