# 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"><span class="pln">wx</span><span class="pun">.</span><span class="pln">downloadFile</span><span class="pun">({</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> url</span><span class="pun">:</span><span class="pln"> </span><span class="str">'https://example.com/audio/123'</span><span class="pun">,</span><span class="pln"> </span><span class="com">//僅為示例，并非真實的資源</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> success </span><span class="pun">(</span><span class="pln">res</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="com">// 只要服務器有響應數據，就會把響應內容寫入文件并進入 success 回調，業務需要自行判斷是否下載到了想要的內容</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="kwd">if</span><span class="pln"> </span><span class="pun">(</span><span class="pln">res</span><span class="pun">.</span><span class="pln">statusCode </span><span class="pun">===</span><span class="pln"> </span><span class="lit">200</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> wx</span><span class="pun">.</span><span class="pln">playVoice</span><span class="pun">({</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> filePath</span><span class="pun">:</span><span class="pln"> res</span><span class="pun">.</span><span class="pln">tempFilePath</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">})</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/network/download/wx.downloadFile.html>