微信JSSDK说明文档.docVIP

微信JSSDK说明文档 微信JS-SDK说明文档 目录 1?概述 1.1?JSSDK使用步骤 1.1.1?步骤一：绑定域名 1.1.2?步骤二：引入JS文件 1.1.3?步骤三：通过config接口注入权限验证配置 1.1.4?步骤四：通过ready接口处理成功验证 1.1.5?步骤五：通过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-DEMO页面和示例代码 20?附录7-问题反馈 微信JS-SDK是微信公众平台面向网页开发者提供的基于微信内的网页开发工具包。 通过使用微信JS-SDK，网页开发者可借助微信高效地使用拍照、选图、语音、位置等手机系统的能力，同时可以直接使用微信分享、扫一扫、卡券、支付等微信特有的能力，为微信用户提供更优质的网页体验。 此文档面向网页开发者介绍微信JS-SDK如何使用及相关注意事项。 先登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。 备注：登录后可在“开发者中心”查看对应的接口权限。 在需要调用JS接口的页面引入如下JS文件，（支持https）：/open/js/jweixin-1.0.0.js 备注：支持使用 AMD/CMD 标准模块加载方法加载 所有需要使用JS-SDK的页面必须先注入配置信息，否则将无法调用（同一个url仅需调用一次，对于变化url的SPA的web app可在每次url变化时进行调用）。 步骤四：通过ready接口处理成功验证 wx.ready(function(){ // config信息验证后会执行ready方法，所有接口调用都必须在config接口获得结果之后，config是一个客户端的异步操作，所以如果需要在页面加载时就调用相关接口，则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口，则可以直接调用，不需要放在ready函数中。 }); 步骤五：通过error接口处理失败验证 wx.error(function(res){ // config信息验证失败会执行error函数，如签名过期导致验证失败，具体错误信息可以打开config的debug模式查看，也可以在返回的res参数中查看，对于SPA可以在这里更新签名。 }); 接口调用说明 所有接口通过wx对象(也可使用jWeixin对象)来调用，参数是一个对象，除了每个接口本身需要传的参数之外，还有以下通用参数： success：接口调用成功时执行的回调函数。 fail：接口调用失败时执行的回调函数。 complete：接口调用完成时执行的回调函数，无论成功或失败都会执行。 cancel：用户点击取消时的回调函数，仅部分有用户取消操作的api才会用到。 trigger: 监听Menu中的按钮点击时触发的方法，该方法仅支持Menu中的相关接口。 以上几个函数都带有一个参数，类型为对象，其中除了每个接口本身返回的数据之外，还有一个通用属性err