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. 使用说明

  1. 在开发的html网页中引入jssdk

    1. 一般网页引用,请放到html的body标签中加载

    <script type="text/javascript" src="https://cdn-cp.tmuyun.com/jssdk/v1/zjrb-cp.v1.min.js" charset="UTF-8"></script>

  1. 使用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
    }
    
  1. 初始化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为原生报错 微信的报错也在这处理
             }
         });
     }
    
  1. 调用业务逻辑(接上文main函数),调用接口方法(对应接口方法及兼容性请查看 调用接口说明 下接口方法)。
    如未加载成功或方法调用失败,请确认CP的加载时序,开启debug模式,进行调试

    // 业务逻辑初始化的main函数
    function main() {
         //自身的业务代码,以下为调用样例
         CP.isLogin({  //判断是否登录的接口,
             completed: function(data){
                   CP.tools.writelog('get_is_login', data);
             },
             cpIncompatible: function () {
                  CP.tools.writelog('', '此环境不支持此方法');
             }
         });
    }
    
  2. 调试当CP.ready中的debug设置为true时,jssdk会默认加载vconsole,并初始化vconsole(如多次引用会覆盖测试打印信息)在页面边缘出现一个绿色浮动按钮vconsole,可点击vconsole按钮查看调试信息。

    ps:所有CP接口皆为异步调用,请注意时序问题。

Copyright © 新媒体云服务平台 2019 all right reserved,powered by Gitbook该文件修订时间: 2023-01-17 16:13:33

results matching ""

    No results matching ""