微信JS SDK 接口调用详解.docxVIP

微信JS SDK 调用详解 目录 1 概述 1.1 使用说明 1.1.1 步骤一：引入JS文件 1.1.2 步骤二：通过config接口注入权限验证配置 1.1.3 步骤三：通过ready接口处理成功验证 1.1.4 步骤四：通过error接口处理失败验证 1.2 接口调用说明 2 基础接口 2.1 判断当前客户端版本是否支持指定JS接口 3 分享接口 3.1 获取“分享到朋友圈”按钮点击状态及自定义分享内容接口 3.2 获取“分享给朋友”按钮点击状态及自定义分享内容接口 3.3 获取“分享到QQ”按钮点击状态及自定义分享内容接口 3.4 获取“分享到腾讯微博”按钮点击状态及自定义分享内容接口 4 图像接口 4.1 拍照或从手机相册中选图接口 4.2 预览图片接口 4.3 上传图片接口 4.4 下载图片接口 5 音频接口 5.1 开始录音接口 5.2 停止录音接口 5.3 监听录音自动停止接口 5.4 播放语音接口 5.5 暂停播放接口 5.6 停止播放接口 5.7 监听语音播放完毕接口 5.8 上传语音接口 5.9 下载语音接口 6 智能接口 6.1 识别音频并返回识别结果接口 7 设备信息 7.1 获取网络状态接口 8 地理位置 8.1 使用微信内置地图查看位置接口 8.2 获取地理位置接口 9 界面操作 9.1 隐藏右上角菜单接口 9.2 显示右上角菜单接口 9.3 关闭当前网页窗口接口 9.4 批量隐藏功能按钮接口 9.5 批量显示功能按钮接口 9.6 隐藏所有非基础按钮接口 9.7 显示所有功能按钮接口 10 微信扫一扫 10.1 调起微信扫一扫接口 11 微信小店 11.1 跳转微信商品页接口 12 微信卡券 12.1 调起适用于门店的卡券列表并获取用户选择列表 12.2 批量添加卡券接口 12.3 查看微信卡包中的卡券接口 13 微信支付 13.1 发起一个微信支付请求 14 附录1-JS-SDK使用权限签名算法 15 附录2-所有JS接口列表 16 附录3-所有菜单项列表 17 附录4-位置签名生成算法 18 附录5-支付扩展字段及签名生成算法 19 附录6-卡券扩展字段及签名生成算法 20 附录7-常见错误及解决方法 21 附录8-DEMO页面和示例代码 22 附录9-问题反馈 概述 微信JS-SDK是微信公众平台面向网页开发者提供的基于微信内的网页开发工具包。 通过使用微信JS-SDK，网页开发者可借助微信高效地使用拍照、选图、语音、位置等手机系统的能力，同时可以直接使用微信分享、扫一扫、卡券、支付等微信特有的能力，为微信用户提供更优质的网页体验。 此文档面向网页开发者介绍微信JS-SDK如何使用及相关注意事项。 使用说明 在使用微信JS-SDK对应的JS接口前，需确保公众号已获得使用对应JS接口的权限，可登录 微信公众平台进入“开发者中心”查看对应的接口权限。 注意： 所有的JS接口只能在公众号绑定的域名下调用，公众号开发者需要先登录 微信公众平台进入“公众号设置”》“功能设置”里填写“JS接口安全域名”。 步骤一：引入JS文件 在需要调用JS接口的页面引入如下JS文件，（支持https）： /open/js/jweixin-1.0.0.js 备注：支持使用 AMD/CMD 标准模块加载方法加载 步骤二：通过config接口注入权限验证配置 所有需要使用JS-SDK的页面必须先注入配置信息，否则将无法调用（同一个url仅需调用一次，对于变化url的SPA的web app可在每次url变化时进行调用）。 wx.config({ debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。 appId: , // 必填，公众号的唯一标识 timestamp: , // 必填，生成签名的时间戳 nonceStr: , // 必填，生成签名的随机串 signature: ,// 必填，签名，见附录1 jsApiList: [] // 必填，需要使用的JS接口列表，所有JS接口列表见附录2 }); 步骤三：通过ready接口处理成功验证 wx.ready(function(){ // config信息验证后会执行ready方法，所有接口调用都必须在config接口获得结果之后，co