微信小程序文档解读(一)--api提供支持有哪些

本文重点在于小程序API提供的微信功能支持及获取用户信息的解读,具体的用法和调用不在本文讨论范围之内,文章基于20161222版文档解读

API官方文档原文链接

---

小程序API官方定义:

框架提供丰富的微信原生API，可以方便的调起微信提供的能力，如获取用户信息，本地存储，支付功能等。

微信小程序提供的API分类与提供能力

• 网络

  每个微信小程序需要事先设置一个通讯域名，小程序可以跟指定的域名与进行网络通信。包括普通 HTTPS 请求（wx.request）、 WebSocket 通信（wx.connectSocket）、上传文件（wx.uploadFile）和下载文件（wx.downloadFile)。

• 媒体

  该类接口提供图片音频上传下载,以及视频播放控制的能力

• 文件

  该类接口主要提供本地文件保存读取与媒体类接口配合使用,支持打开本体文档,支持格式：doc, xls, ppt, pdf, docx, xlsx, pptx

• 数据缓存

  每个微信小程序都可以有自己的本地缓存，可以通过 wx.setStorage（wx.setStorageSync）、wx.getStorage（wx.getStorageSync）、wx.clearStorage（wx.clearStorageSync）可以对本地缓存进行设置、获取和清理。本地缓存最大为10MB。

---

以上三个接口是配合使用的,但是由于类型不同被文档分开描述.

• 位置

  该类接口主要提供获取当前的地理位置(GPS经纬度或基于网络模拟的经纬度)、速度，使用微信内置地图选择和查看位置，或者通过地图组件交互的能力

• 设备

  该类接口主要提供获得用户设备的系统信息、网络状态、重力感应、罗盘、拨打电话和扫码的能力

  1. 系统信息
     
     该接口可以获取：
     
     | 手机型号 | 设备像素比 | 窗口宽高 | 微信设置语言 | 微信版本号 | 操作系统版本 | 客户端平台 |
  2. 网络状态
     
     2g、3g、4g、WiFi
  3. 重力感应
     
     通过xyz三轴的方式监听重力感应数据，频率：5次/秒,通过微信APP拿到系统陀螺仪给出的数据
  4. 罗盘
     
     通过面对方向度数的方式监听罗盘数据，频率：5次/秒
  5. 拨打电话
  6. 扫码
     
     调起客户端扫码界面，扫码成功后返回对应的结果

• 界面

  该类接口主要提供页面直接交互能力

  1. 交互反馈
     
     微信在这一版的调整里，将toast和confirm两类弹窗划入了接口，可以直接调用微信APP原生的弹窗
  2. 设置导航条
     
     设置导航菜单
  3. 导航
     
     提供基于地图和gps的导航，还是腾讯地图的api
  4. 动画
     
     启用动画加载的效果
  5. 绘图
     
     提供canvas绘图的能力，这次更新微信完善了wx框架下canvas各个接口的能力
  6. 下拉刷新
     
     调起下拉刷新的能力，也是贴近原生APP的一种能力

• 开放接口

  该类接口主要提供微信APP自身开放的能力

  1. 微信登录
  2. 获取用户信息
     
     以上两个接口与微信公众平台的接口类似，几乎一样
  3. 微信支付
     
     支付相关的能力，与微信公众平台的接口类似
  4. 模板消息
     
     提供发送服务通知模板消息，要求是用户提交表单或支付动作触发，可获得一次推送次数，7天内可以发送模板消息
  5. 客服功能
     
     提供接入微信客户功能和基于微信客服接口消息能力自助开发或接入第三方的客服系统
  6. 分享
     
     点右上角三个点出现菜单中出现分享，截图当前用户页面80%作为缩略图，可发送给朋友和群
  7. 获取二维码
     
     通过后台接口可以获取小程序任意页面的二维码，扫描该二维码可以直接进入小程序对应的页面，也可以获取渠道二维码，需要服务器保存