1. 使用说明
![]()
1.1.1. 版本说明
jssdk最新版本为 tmcdn v1 2.26.X 稳定版为 tmcdn v1 2.26.X
稳定版地址链接为: https://cdn-cp.tmuyun.com/jssdk/v1/zjrb-cp.v1.min.js
1.1.2. 使用说明
在开发的html网页中引入jssdk
- 一般网页引用,请放到html的body标签中加载
<script type="text/javascript" src="https://cdn-cp.tmuyun.com/jssdk/v1/zjrb-cp.v1.min.js" charset="UTF-8"></script>- 一般网页引用,请放到html的body标签中加载
使用vue等js框架nodejs打包加载,请放到html的body中加载
let zjrbCp = document.createElement('script'); zjrbCp.async = "async"; zjrbCp.src = 'https://cdn-cp.tmuyun.com/jssdk/v1/zjrb-cp.v1.min.js'; zjrbCp.charset = "UTF-8"; document.body.appendChild(zjrbCp); zjrbCp.onload = function(){ //初始化jssdk }
初始化jssdk,加载js后,js全局添加对象CP,以下为初始化jssdk代码,全局只需在最开始时配置一次(CP对象说明请参照CP对象说明,如需微信QQ二次分享请查看微信及QQ二次分享)
//初始化jssdk if(CP && typeof CP.ready === 'function'){ CP.ready({ debug:false, //可选,是否是开启调试模式, 默认false es6Require: false, //可选,是否需要加载es6库,默认false wxOption: { //可选,内容需要二次分享时请配置此项 debug:false, //是否是开启微信调试模式 appid: 'xxxx', //授权的微信公众号的appid 微信二次分享使用,具体使用方式请参照 附录:微信及微信二次分享 method: 'getShareSign', //获取微信信息方法,写死 uploadImage: '', //使用微信录音,图片上传等功能时需要的上传后台服务器地址 redirect: location.href.split('#')[0], //回调域名,一般为加载后签名时页面,如跳转可能会签名失败 附录:微信及微信二次分享 jsApiList: [ 'onMenuShareTimeline', 'onMenuShareAppMessage', 'onMenuShareQQ', 'onMenuShareWeibo', 'onMenuShareQZone', 'startRecord', 'stopRecord', 'onVoiceRecordEnd', 'onVoicePlayEnd', 'uploadVoice', 'playVoice', 'getLocation', 'chooseImage', 'uploadImage','stopVoice','pauseVoice','previewImage','translateVoice','updateAppMessageShareData','updateTimelineShareData' ] // 分享到微信必填,需要使用的微信JS接口列表,所有JS接口列表见 附录:微信JS接口列表 }, ready:function(client_info){ //jssdk加载完成调用此方法 //client_info > { client_code: 'web', version: '1.0', detail: ''} clientInfo 接口返回数据 main();// 业务逻辑初始化的main函数 }, error: function (error) { //jssdk运行时报错,但不会阻断程序运行 //error > {code: 4000, msg: res.errMsg, data: res} res为原生报错 微信的报错也在这处理 } }); }
调用业务逻辑(接上文main函数),调用接口方法(对应接口方法及兼容性请查看 调用接口说明 下接口方法)。
如未加载成功或方法调用失败,请确认CP的加载时序,开启debug模式,进行调试// 业务逻辑初始化的main函数 function main() { //自身的业务代码,以下为调用样例 CP.isLogin({ //判断是否登录的接口, completed: function(data){ CP.tools.writelog('get_is_login', data); }, cpIncompatible: function () { CP.tools.writelog('', '此环境不支持此方法'); } }); }调试当CP.ready中的debug设置为true时,jssdk会默认加载vconsole,并初始化vconsole(如多次引用会覆盖测试打印信息)在页面边缘出现一个绿色浮动按钮vconsole,可点击vconsole按钮查看调试信息。
ps:所有CP接口皆为异步调用,请注意时序问题。