AD:靠谱的微信小程序外包开发

admin

admin

发表于 2017-02-06 11:54:07

上传下载wx.uploadFile,wx.downloadFile详解-网络API-微信小程序API-微信 小程序开发教程



wx.uploadFile(OBJECT)

将本地资源上传到开发者服务器。如页面通过 wx.chooseImage 等接口获取到一个本地资源的临时文件路径后,可通过此接口将本地资源上传到指定服务器。客户端发起一个 HTTPS POST 请求,其中 content-type 为 multipart/form-data 。

OBJECT参数说明:

参数类型必填说明
urlString开发者服务器 url
filePathString要上传文件资源的路径
nameString文件对应的 key , 开发者在服务器端通过这个 key 可以获取到文件二进制内容
headerObjectHTTP 请求 Header , header 中不能设置 Referer
formDataObjectHTTP 请求中其他额外的 form data
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明:

参数类型说明
dataString开发者服务器返回的数据
statusCodeNumberHTTP状态码

示例代码:

wx.chooseImage({
  success: function(res) {    var tempFilePaths = res.tempFilePaths
    wx.uploadFile({
      url: 'http://example.weixin.qq.com/upload', //仅为示例,非真实的接口地址
      filePath: tempFilePaths[0],
      name: 'file',
      formData:{        'user': 'test'
      },
      success: function(res){        var data = res.data        //do something
      }
    })
  }
})

Bug & Tip

  1. tip: 最大并发限制是 10 个

  2. tip: 默认超时时间和最大超时时间都是 60s

wx.downloadFile(OBJECT)

下载文件资源到本地。客户端直接发起一个 HTTP GET 请求,返回文件的本地临时路径。

OBJECT参数说明:

参数类型必填必填
urlString下载资源的 url
headerObjectHTTP 请求 Header
successFunction下载成功后以 tempFilePath 的形式传给页面,res = {tempFilePath: '文件的临时路径'}
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

注:文件的临时路径,在小程序本次启动期间可以正常使用,如需持久保存,需在主动调用 wx.saveFile,在小程序下次启动时才能访问得到。

示例代码:

wx.downloadFile({
  url: 'http://example.com/audio/123', //仅为示例,并非真实的资源
  success: function(res) {
    wx.playVoice({
      filePath: res.tempFilePath
    })
  }
})

Bug & Tip

  1. tip: 最大并发限制是 10 个

  2. tip: 默认超时时间和最大超时时间都是 60s

  3. tip: 网络请求的 referer 是不可以设置的,格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html,其中 {appid} 为小程序的 appid,{version} 为小程序的版本号,版本号为 0 表示为开发版。

  4. tip: 6.5.3 以及之前版本的 iOS 微信客户端 header 设置无效




扩展阅读:

发起请求wx.request详解-网络API-微信小程序API-微信 小程序开发教程

上传下载wx.uploadFile,wx.downloadFile详解-网络API-微信小程序API-微信 小程序开发教程

WebSocket详解-网络API-微信小程序API-微信 小程序开发教程

wx.request详解-发起请求-网络API-微信小程序API-微信 小程序开发教程

wx.uploadFile详解-上传下载-网络API-微信小程序API-微信 小程序开发教程

wx.downloadFile详解-上传下载-网络API-微信小程序API-微信 小程序开发教程

wx.connectSocket详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.onSocketOpen详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.onSocketError详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.sendSocketMessage详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.onSocketMessage详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.closeSocket详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程

wx.onSocketClose详解-WebSocket-网络API-微信小程序API-微信 小程序开发教程



126阅读 | 0评论
你的回应
写文章

1505