[Django+微信小程序开发]03常用的微信API开放能力

墨蓝 2023-07-12 05:09 97阅读 0赞

### 微信api,开放能力,基础组件 ###

#### 首先我的最终目的是为了开发PythonDjango+微信小程序的校园应用,所以查看我这个系列就可以查看一些有用的内容 ####

#### 微信api ####

*  网络请求
    
     *  HTTP请求
     *      testNetwork: function (event) { 
                wx.request({ 
                  url: 'http://www.imooc.com',
                  method: "GET",
                  header: { },
                  success: function (res) { 
                    console.log(res.data)
                  },
                  fail: function (res) { 
                    console.log("request failed")
                  }
                })
              }
     *  文件上传,下载
        
        [wx.uploadFile][]
        
        [wx.downloadFile][]
     *  Task(网络任务对象)
     *  ### [RequestTask.abort()][RequestTask.abort] ###
        
        中断请求任务
        
        ### [RequestTask.onHeadersReceived(function callback)][RequestTask.onHeadersReceived_function callback] ###
        
        监听 HTTP Response Header 事件。会比请求完成事件更早
        
        ### [RequestTask.offHeadersReceived(function callback)][RequestTask.offHeadersReceived_function callback] ###
        
        取消监听 HTTP Response Header 事件
        
            const requestTask = wx.request({ 
                url: 'test.php', //仅为示例，并非真实的接口地址
                data: { 
                    x: '' ,
                    y: ''
                },
                header: { 
                    'content-type': 'application/json'
                },
                success (res) { 
                    console.log(res.data)
                }
            })
            requestTask.abort() // 取消请求任务
 *  ### [DownloadTask.abort()][DownloadTask.abort] ###
    
    中断下载任务
    
    ### [DownloadTask.onProgressUpdate(function callback)][DownloadTask.onProgressUpdate_function callback] ###
    
    监听下载进度变化事件
    
    ### [DownloadTask.offProgressUpdate(function callback)][DownloadTask.offProgressUpdate_function callback] ###
    
    取消监听下载进度变化事件
    
    ### [DownloadTask.onHeadersReceived(function callback)][DownloadTask.onHeadersReceived_function callback] ###
    
    监听 HTTP Response Header 事件。会比请求完成事件更早
    
    ### [DownloadTask.offHeadersReceived(function callback)][DownloadTask.offHeadersReceived_function callback] ###
    
    取消监听 HTTP Response Header 事件
    
    ## 示例代码 ##
    
        const downloadTask = wx.downloadFile({ 
          url: 'http://example.com/audio/123', //仅为示例，并非真实的资源
          success (res) { 
            wx.playVoice({ 
              filePath: res.tempFilePath
            })
          }
        })
        
        downloadTask.onProgressUpdate((res) => { 
          console.log('下载进度', res.progress)
          console.log('已经下载的数据长度', res.totalBytesWritten)
          console.log('预期需要下载的数据总长度', res.totalBytesExpectedToWrite)
        })
        
        downloadTask.abort() // 取消下载任务
 *  本地存储
    
    ## wx.setStorage(Object object)(异步) ##
    
    将数据存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。
    
    ## wx.getStorage(Object object) ##
    
    从本地缓存中异步获取指定 key 的内容
    
    ## wx.removeStorage(Object object) ##
    
    从本地缓存中移除指定 key
    
    ## wx.clearStorage(Object object) ##
    
    清理本地数据缓存
    
    ## wx.setStorageSync(string key, any data) ##
    
    [wx.setStorage][] 的同步版本
    
    ## 参数 ##
    
    ### Object object ###
    
    <table> 
     <thead> 
      <tr> 
       <th align="left">属性</th> 
       <th align="left">类型</th> 
       <th align="left">默认值</th> 
       <th align="left">必填</th> 
       <th align="left">说明</th> 
      </tr> 
     </thead> 
     <tbody> 
      <tr> 
       <td align="left">key</td> 
       <td align="left">string</td> 
       <td align="left"></td> 
       <td align="left">是</td> 
       <td align="left">本地缓存中指定的 key</td> 
      </tr> 
      <tr> 
       <td align="left">data</td> 
       <td align="left">any</td> 
       <td align="left"></td> 
       <td align="left">是</td> 
       <td align="left">需要存储的内容。只支持原生类型、Date、及能够通过<code>JSON.stringify</code>序列化的对象。</td> 
      </tr> 
      <tr> 
       <td align="left">success</td> 
       <td align="left">function</td> 
       <td align="left"></td> 
       <td align="left">否</td> 
       <td align="left">接口调用成功的回调函数</td> 
      </tr> 
      <tr> 
       <td align="left">fail</td> 
       <td align="left">function</td> 
       <td align="left"></td> 
       <td align="left">否</td> 
       <td align="left">接口调用失败的回调函数</td> 
      </tr> 
      <tr> 
       <td align="left">complete</td> 
       <td align="left">function</td> 
       <td align="left"></td> 
       <td align="left">否</td> 
       <td align="left">接口调用结束的回调函数（调用成功、失败都会执行）</td> 
      </tr> 
     </tbody> 
    </table>
    
    ## 示例代码 ##
    
        wx.setStorage({ 
          key:"key",
          data:"value"
        })
        try { 
          wx.setStorageSync('key', 'value')
        } catch (e) {  }
 *  # 文件系统 #
    
     *  全局文件管理器
        
         *  获取全局唯一的文件管理器
         *  var fs = wx.getFileSystemManager()
     *  文件的增删改查
        
         *  fs.saveFile \# 保存文件
         *  fs.removeSavedFile \# 删除本地缓存文件
         *  fs.writeFile \# 写一个文件
         *  fs.appendFile \# 给文件添加一些内容
         *  fs.readFile \# 读取一个文件
     *  文件夹的操作
        
         *  fs.mkdir \#新建文件夹
         *  fs.rmdir \# 删除文件夹
         *  fs.isDirectory \#判断是不是文件夹
         *  fs.isFile \# 判断是不是文件

#### 开放能力 ####

*  用户数据
    
     *  头像,昵称等公开信息—wx.getUserInfo()
     *  openid等敏感数据
 *  推送数据
    
     *  数据卡片
 *  运营数据
    
     *  小程序后台-数据分析
     *  小程序数据助手

#### 基础组件 ####

WeUI-WXSS

[wx.uploadFile]: https://developers.weixin.qq.com/miniprogram/dev/api/network/upload/wx.uploadFile.html
[wx.downloadFile]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/wx.downloadFile.html
[RequestTask.abort]: https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.abort.html
[RequestTask.onHeadersReceived_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.onHeadersReceived.html
[RequestTask.offHeadersReceived_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/request/RequestTask.offHeadersReceived.html
[DownloadTask.abort]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/DownloadTask.abort.html
[DownloadTask.onProgressUpdate_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/DownloadTask.onProgressUpdate.html
[DownloadTask.offProgressUpdate_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/DownloadTask.offProgressUpdate.html
[DownloadTask.onHeadersReceived_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/DownloadTask.onHeadersReceived.html
[DownloadTask.offHeadersReceived_function callback]: https://developers.weixin.qq.com/miniprogram/dev/api/network/download/DownloadTask.offHeadersReceived.html
[wx.setStorage]: https://developers.weixin.qq.com/miniprogram/dev/api/storage/wx.setStorage.html