欢迎来到[自学php网] ①群 AG亚游集团

AG亚游集团 > 网站后台 > 微信开发 >

专门用于微信公众平台的Javascript API - 微信公众平

来源:自学PHP网 ?? 时间:2015-04-14 12:58?作者:

[导读] 1 **! 2 * 微信内置浏览器的Javascript API,功能包括: 3 * 4 * 1、分享到微信朋友圈 5 * 2、分享给微信好友 6 * 3、分享到腾讯微博 7 * 4、新的分享接口,...

 /**!
    * 微信内置浏览器Javascript API,功能包括:
    *
    * 1、分享到微信朋友圈
    * 2、分享给微信好友
    * 3、分享到腾讯微博
    * 4、新的分享接口,包含朋友圈、好友、微博的分享(for iOS)
    * 5、隐藏/显示右上角的菜单入口
    * 6、隐藏/显示底部浏览器工具栏
   * 7、获取当前的网络状态
   * 8、调起微信客户端的图片播放组件
   * 9、关闭公众平台Web页面
   * 10、判断当前网页是否在微信内置浏览器中打开
   * 11、增加打开扫描二维码
   * 12、支持WeixinApi的错误监控
   * 13、检测应用程序是否已经安装(需要官方开通权限)
   * 14、发送电子邮件
   * 15、禁止用户分享
   *
   * @author guanguoxiang(/wwwaff4ggxappaff4com)
   */
  (function (window) {
 
     "use strict";
  
      /**
       * 定义WeixinApi
       */
      var WeixinApi = {
          version: 4.1
      };
  
      /将WeixinApi暴露到window下:全局可使用,对旧版本向下兼容
      window.WeixinApi = WeixinApi;
  
      //////////////CommonJS /////////////////
      if (typeof define === 'function' && (define.amd || define.cmd)) {
          if (define.amd) {
              /AMD 规范,for:requirejs
              define(function () {
                  return WeixinApi;
              });
          } else if (define.cmd) {
              /CMD 规范,for:seajs
              define(function (require, exports, module) {
                  module.exports = WeixinApi;
              });
          }
      }
  
     /**
       * 对象简单继承,后面的覆盖前面的,继承深度:deep=1
       * @private
       */
      var _extend = function () {
          var result = {}, obj, k;
          for (var i = 0, len = arguments.length; i < len; i++) {
              obj = arguments[i];
              if (typeof obj === 'object') {
                  for (k in obj) {
                      obj[k] && (result[k] = obj[k]);
                  }
              }
          }
          return result;
      };
  
      /**
       * 内部私有方法,分享用
       * @private
       */
      var _share = function (cmd, data, callbacks) {
          callbacks = callbacks || {};
  
          /分享过程中的一些回调
          var progress = function (resp) {
              switch (true) {
                  /用户取消
                  case /\:cancel$/i.test(resp.err_msg) :
                      callbacks.cancel && callbacks.cancel(resp);
                      break;
                  /发送成功
                  case /\:(confirm|ok)$/i.test(resp.err_msg):
                      callbacks.confirm && callbacks.confirm(resp);
                      break;
                  /fail 发送失败
                  case /\:fail$/i.test(resp.err_msg) :
                  default:
                      callbacks.fail && callbacks.fail(resp);
                      break;
              }
              /无论成功失败都会执行的回调
              callbacks.all && callbacks.all(resp);
          };
  
          /执行分享,并处理结果
          var handler = function (theData, argv) {
  
              /加工一下数据
             if (cmd.menu == 'menu:share:timeline' ||
                 (cmd.menu == 'general:share' && argv.shareTo == 'timeline')) {
 
                 var title = theData.title;
                 theData.title = theData.desc || title;
                 theData.desc = title || theData.desc;
             }
 
             /新的分享接口,单独处理
             if (cmd.menu === 'general:share') {
                 /如果是收藏操作,并且在wxCallbacks中配置了favorite为false,则不执行回调
                 if (argv.shareTo == 'favorite' || argv.scene == 'favorite') {
                     if (callbacks.favorite === false) {
                         return argv.generalShare(theData, function () {
                         });
                     }
                 }
                 if (argv.shareTo === 'timeline') {
                     WeixinJSBridge.invoke('shareTimeline', theData, progress);
                 } else if (argv.shareTo === 'friend') {
                     WeixinJSBridge.invoke('sendAppMessage', theData, progress);
                 } else if (argv.shareTo === 'QQ') {
                     WeixinJSBridge.invoke('shareQQ', theData, progress);
                 }else if (argv.shareTo === 'weibo') {
                     WeixinJSBridge.invoke('shareWeibo', theData, progress);
                 }
             } else {
                 WeixinJSBridge.invoke(cmd.action, theData, progress);
             }
         };
 
         /监听分享操作
         WeixinJSBridge.on(cmd.menu, function (argv) {
             callbacks.dataLoaded = callbacks.dataLoaded || new Function();
             if (callbacks.async && callbacks.ready) {
                 WeixinApi["_wx_loadedCb_"] = callbacks.dataLoaded;
                 if (WeixinApi["_wx_loadedCb_"].toString().indexOf("_wx_loadedCb_") > 0) {
                     WeixinApi["_wx_loadedCb_"] = new Function();
                 }
                 callbacks.dataLoaded = function (newData) {
                     callbacks.__cbkCalled = true;
                     var theData = _extend(data, newData);
                     theData.img_url = theData.imgUrl || theData.img_url;
                     delete theData.imgUrl;
                     WeixinApi["_wx_loadedCb_"](theData);
                     handler(theData, argv);
                 };
                 /然后就绪
                 if (!(argv && (argv.shareTo == 'favorite' || argv.scene == 'favorite') && callbacks.favorite === false)) {
                     callbacks.ready && callbacks.ready(argv, data);
                     /如果设置了async为true,但是在ready方法中并没有手动调用dataLoaded方法,则自动触发一次
                     if (!callbacks.__cbkCalled) {
                         callbacks.dataLoaded({});
                         callbacks.__cbkCalled = false;
                }
             } else {
                 /就绪状态
                 var theData = _extend(data);
                 if (!(argv && (argv.shareTo == 'favorite' || argv.scene == 'favorite') && callbacks.favorite === false)) {
                     callbacks.ready && callbacks.ready(argv, theData);
                 }
                 handler(theData, argv);
             }
         });
     };
 
     /**
      * 分享到微信朋友圈
      * @param       {Object}    data       待分享的信息
      * @p-config    {String}    appId      公众平台的appId(服务号可用)
      * @p-config    {String}    imgUrl     图片地址
      * @p-config    {String}    link       链接地址
      * @p-config    {String}    desc       描述
      * @p-config    {String}    title      分享的标题
      *
      * @param       {Object}    callbacks  相关回调方法
      * @p-config    {Boolean}   async                   ready方法是否需要异步执行,默认false
      * @p-config    {Function}  ready(argv, data)       就绪状态
      * @p-config    {Function}  dataLoaded(data)        数据加载完成后调用,async为true时有用,也可以为空
      * @p-config    {Function}  cancel(resp)    取消
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  confirm(resp)   成功
      * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.shareToTimeline = function (data, callbacks) {
         _share({
             menu: 'menu:share:timeline',
             action: 'shareTimeline'
         }, {
             "appid": data.appId ? data.appId : '',
             "img_url": data.imgUrl,
             "link": data.link,
             "desc": data.desc,
             "title": data.title,
             "img_width": "640",
             "img_height": "640"
         }, callbacks);
     };
 
     /**
      * 发送给微信上的好友
      * @param       {Object}    data       待分享的信息
      * @p-config    {String}    appId      公众平台的appId(服务号可用)
      * @p-config    {String}    imgUrl     图片地址
      * @p-config    {String}    link       链接地址
      * @p-config    {String}    desc       描述
      * @p-config    {String}    title      分享的标题
      *
      * @param       {Object}    callbacks  相关回调方法
      * @p-config    {Boolean}   async                   ready方法是否需要异步执行,默认false
      * @p-config    {Function}  ready(argv, data)       就绪状态
      * @p-config    {Function}  dataLoaded(data)        数据加载完成后调用,async为true时有用,也可以为空
      * @p-config    {Function}  cancel(resp)    取消
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  confirm(resp)   成功
      * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.shareToFriend = function (data, callbacks) {
         _share({
             menu: 'menu:share:appmessage',
             action: 'sendAppMessage'
         }, {
             "appid": data.appId ? data.appId : '',
             "img_url": data.imgUrl,
             "link": data.link,
             "desc": data.desc,
             "title": data.title,
             "img_width": "640",
             "img_height": "640"
         }, callbacks);
     };
 
 
     /**
      * 分享到腾讯微博
      * @param       {Object}    data       待分享的信息
      * @p-config    {String}    link       链接地址
      * @p-config    {String}    desc       描述
      *
      * @param       {Object}    callbacks  相关回调方法
      * @p-config    {Boolean}   async                   ready方法是否需要异步执行,默认false
      * @p-config    {Function}  ready(argv, data)       就绪状态
      * @p-config    {Function}  dataLoaded(data)        数据加载完成后调用,async为true时有用,也可以为空
      * @p-config    {Function}  cancel(resp)    取消
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  confirm(resp)   成功
      * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.shareToWeibo = function (data, callbacks) {
         _share({
             menu: 'menu:share:weibo',
             action: 'shareWeibo'
         }, {
             "content": data.desc,
             "url": data.link
         }, callbacks);
     };
 
     /**
      * 新的分享接口
      * @param       {Object}    data       待分享的信息
      * @p-config    {String}    appId      公众平台的appId(服务号可用)
      * @p-config    {String}    imgUrl     图片地址
      * @p-config    {String}    link       链接地址
      * @p-config    {String}    desc       描述
      * @p-config    {String}    title      分享的标题
      *
      * @param       {Object}    callbacks  相关回调方法
      * @p-config    {Boolean}   async                   ready方法是否需要异步执行,默认false
      * @p-config    {Function}  ready(argv, data)       就绪状态
      * @p-config    {Function}  dataLoaded(data)        数据加载完成后调用,async为true时有用,也可以为空
      * @p-config    {Function}  cancel(resp)    取消
     * @p-config    {Function}  fail(resp)      失败
     * @p-config    {Function}  confirm(resp)   成功
     * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.generalShare = function (data, callbacks) {
         _share({
             menu: 'general:share'
         }, {
             "appid": data.appId ? data.appId : '',
             "img_url": data.imgUrl,
             "link": data.link,
             "desc": data.desc,
             "title": data.title,
             "img_width": "640",
             "img_height": "640"
         }, callbacks);
     };
 
     /**
      * 设置页面禁止分享:包括朋友圈、好友、腾讯微博、qq
      * @param callback
      */
     WeixinApi.disabledShare = function (callback) {
         callback = callback || function () {
             alert('当前页面禁止分享!');
         };
         ['menu:share:timeline', 'menu:share:appmessage', 'menu:share:qq',
             'menu:share:weibo', 'general:share'].forEach(function (menu) {
                 WeixinJSBridge.on(menu, function () {
                     callback();
                     return false;
                 });
             });
     };
 
     /**
      * 加关注(此功能只是暂时先加上,不过因为权限限制问题,不能用,如果你的站点是部署在*.qq.com下,也许可行)
      * @param       {String}    appWeixinId     微信公众号ID
      * @param       {Object}    callbacks       回调方法
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  confirm(resp)   成功
      */
     WeixinApi.addContact = function (appWeixinId, callbacks) {
         callbacks = callbacks || {};
         WeixinJSBridge.invoke("addContact", {
             webtype: "1",
             username: appWeixinId
         }, function (resp) {
             var success = !resp.err_msg || "add_contact:ok" == resp.err_msg
                 || "add_contact:added" == resp.err_msg;
             if (success) {
                 callbacks.success && callbacks.success(resp);
             } else {
                 callbacks.fail && callbacks.fail(resp);
             }
         })
     };
 
     /**
      * 调起微信Native的图片播放组件。
      * 这里必须对参数进行强检测,如果参数不合法,直接会导致微信客户端crash
      *
      * @param {String} curSrc 当前播放的图片地址
      * @param {Array} srcList 图片地址列表
      */
     WeixinApi.imagePreview = function (curSrc, srcList) {
         if (!curSrc || !srcList || srcList.length == 0) {
             return;
         }
         WeixinJSBridge.invoke('imagePreview', {
             'current': curSrc,
             'urls': srcList
         });
     };
 
     /**
      * 显示网页右上角的按钮
      */
     WeixinApi.showOptionMenu = function () {
         WeixinJSBridge.call('showOptionMenu');
     };
 
 
     /**
      * 隐藏网页右上角的按钮
      */
     WeixinApi.hideOptionMenu = function () {
         WeixinJSBridge.call('hideOptionMenu');
     };
 
     /**
      * 显示底部工具栏
      */
     WeixinApi.showToolbar = function () {
         WeixinJSBridge.call('showToolbar');
     };
 
     /**
      * 隐藏底部工具栏
      */
     WeixinApi.hideToolbar = function () {
         WeixinJSBridge.call('hideToolbar');
     };
 
     /**
      * 返回如下几种类型:
      *
      * network_type:wifi     wifi网络
      * network_type:edge     非wifi,包含3G/2G
      * network_type:fail     网络断开连接
      * network_type:wwan     2g或者3g
      *
      * 使用方法:
      * WeixinApi.getNetworkType(function(networkType){
      *
      * });
      *
      * @param callback
      */
     WeixinApi.getNetworkType = function (callback) {
         if (callback && typeof callback == 'function') {
             WeixinJSBridge.invoke('getNetworkType', {}, function (e) {
                 /在这里拿到e.err_msg,这里面就包含了所有的网络类型
                 callback(e.err_msg);
             });
         }
     };
 
     /**
      * 关闭当前微信公众平台页面
      * @param       {Object}    callbacks       回调方法
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  success(resp)   成功
      */
     WeixinApi.closeWindow = function (callbacks) {
         callbacks = callbacks || {};
         WeixinJSBridge.invoke("closeWindow", {}, function (resp) {
             switch (resp.err_msg) {
                 /关闭成功
                 case 'close_window:ok':
                     callbacks.success && callbacks.success(resp);
                     break;
 
                 /关闭失败
                 default :
                     callbacks.fail && callbacks.fail(resp);
                    break;
             }
         });
     };
 
     /**
      * 当页面加载完毕后执行,使用方法:
      * WeixinApi.ready(function(Api){
      *     /从这里只用Api即是WeixinApi
    * });
      * @param readyCallback
      */
     WeixinApi.ready = function (readyCallback) {
 
         /**
          * 加一个钩子,同时解决AG亚游集团Android和iOS下的分享问题
          * @private
          */
         var _hook = function () {
             var _WeixinJSBridge = {};
            Object.keys(WeixinJSBridge).forEach(function (key) {
                 _WeixinJSBridge[key] = WeixinJSBridge[key];
             });
             Object.keys(WeixinJSBridge).forEach(function (key) {
                 if (typeof WeixinJSBridge[key] === 'function') {
                     WeixinJSBridge[key] = function () {
                         try {
                             var args = arguments.length > 0 ? arguments[0] : {},
                                 runOn3rd_apis = args.__params ? args.__params.__runOn3rd_apis || [] : [];
                             ['menu:share:timeline', 'menu:share:appmessage', 'menu:share:weibo',
                                 'menu:share:qq', 'general:share'].forEach(function (menu) {
                                     runOn3rd_apis.indexOf(menu) === -1 && runOn3rd_apis.push(menu);
                                 });
                         } catch (e) {
                         }
                         return _WeixinJSBridge[key].apply(WeixinJSBridge, arguments);
                     };
                 }
             });
         };
 
         if (readyCallback && typeof readyCallback == 'function') {
             var Api = this;
             var wxReadyFunc = function () {
                 _hook();
                 readyCallback(Api);
             };
             if (typeof window.WeixinJSBridge == "undefined") {
                 if (document.addEventListener) {
                     document.addEventListener('WeixinJSBridgeReady', wxReadyFunc, false);
                 } else if (document.attachEvent) {
                     document.attachEvent('WeixinJSBridgeReady', wxReadyFunc);
                     document.attachEvent('onWeixinJSBridgeReady', wxReadyFunc);
                 }
             } else {
                 wxReadyFunc();
             }
         }
     };
 
     /**
      * 判断当前网页是否在AG亚游集团微信内置浏览器中打开
      */
     WeixinApi.openInWeixin = function () {
         return /MicroMessenger/i.test(navigator.userAgent);
     };
 
     /*
      * 打开扫描二维码
      * @param       {Object}    callbacks       回调方法
      * @p-config    {Boolean}   needResult      是否直接获取分享后的内容
      * @p-config    {String}    desc            扫描二维码时的描述
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  success(resp)   成功
      */
     WeixinApi.scanQRCode = function (callbacks) {
         callbacks = callbacks || {};
         WeixinJSBridge.invoke("scanQRCode", {
             needResult: callbacks.needResult ? 1 : 0,
             desc: callbacks.desc || 'WeixinApi Desc'
         }, function (resp) {
             switch (resp.err_msg) {
                 /打开扫描器成功
                 case 'scanQRCode:ok':
                 case 'scan_qrcode:ok':
                     callbacks.success && callbacks.success(resp);
                     break;
 
                 /打开扫描器失败
                 default :
                     callbacks.fail && callbacks.fail(resp);
                     break;
             }
         });
     };
 
     /**
      * 检测应用程序是否已安装
      *         by mingcheng 2014-10-17
      *
      * @param       {Object}    data               应用程序的信息
      * @p-config    {String}    packageUrl      应用注册的自定义前缀,如 xxx:/就取 xxx
      * @p-config    {String}    packageName        应用的包名
      *
      * @param       {Object}    callbacks       相关回调方法
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  success(resp)   成功,如果有对应的版本信息,则写入到 resp.version 中
      * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.getInstallState = function (data, callbacks) {
         callbacks = callbacks || {};
 
         WeixinJSBridge.invoke("getInstallState", {
             "packageUrl": data.packageUrl || "",
             "packageName": data.packageName || ""
         }, function (resp) {
             var msg = resp.err_msg, match = msg.match(/state:yes_?(.*)$/);
             if (match) {
                 resp.version = match[1] || "";
                 callbacks.success && callbacks.success(resp);
             } else {
                 callbacks.fail && callbacks.fail(resp);
             }
 
             callbacks.all && callbacks.all(resp);
         });
     };
 
     /**
      * 发送邮件
      * @param       {Object}  data      邮件初始内容
      * @p-config    {String}  subject   邮件标题
      * @p-config    {String}  body      邮件正文
      *
      * @param       {Object}    callbacks       相关回调方法
      * @p-config    {Function}  fail(resp)      失败
      * @p-config    {Function}  success(resp)   成功
      * @p-config    {Function}  all(resp)       无论成功失败都会执行的回调
      */
     WeixinApi.sendEmail = function (data, callbacks) {
         callbacks = callbacks || {};
         WeixinJSBridge.invoke("sendEmail", {
             "title": data.subject,
             "content": data.body
         }, function (resp) {
             if (resp.err_msg === 'send_email:sent') {                
          callbacks.success && callbacks.uccess(resp);
          } else {
              callbacks.fail && callbacks.fail(resp);
             }
             callbacks.all && callbacks.all(resp);
         })
     };
      /**
      * 开启Api的debug模式,比如出了个什么错误,能alert告诉你,而不是一直很苦逼的在想哪儿出问题了
    * @param    {Function}  callback(error) 出错后的回调,默认是alert
      */
     WeixinApi.enableDebugMode = function (callback) {
         /**
          * @param {String}  errorMessage   错误信息
         * @param {String}  scriptURI      出错的文件
          * @param {Long}    lineNumber     出错代码的行号
          * @param {Long}    columnNumber   出错代码的列号
          */
        window.onerror = function (errorMessage, scriptURI, lineNumber, columnNumber) {
 
             /有callback的情况下,将错误信息传递到options.callback中
             if (typeof callback === 'function') {
                 callback({
                     message: errorMessage,
                    script: scriptURI,
                     line: lineNumber,
                     column: columnNumber
                 });
             } else {
                 /其他情况,都以alert方式直接提示错误信息
                 var msgs = [];
                 msgs.push("额,代码有错。。。");
                 msgs.push("\n错误信息:", errorMessage);
                 msgs.push("\n出错文件:", scriptURI);
                 msgs.push("\n出错位置:", lineNumber + '行,' + columnNumber + '列');
                 alert(msgs.join(''));
             }
         }
     };
 
 })(window);

最新文章

点击排行

自学PHP网专注网站建设学习,PHP程序学习,平面设计学习,以及操作系统学习

京ICP备14009008号@版权所有AG亚游集团

网站声明:本站所有视频,教程都由网友上传,站长收集和分享给大家学习使用,如由牵扯版权问题请联系站长邮箱904561283@qq.com

京媒:巴坎布证明自己与身价成正比 应得到更多机会 耀才证券陈伟聪:A股之表现将成关键 全国人民真实酒量揭秘:东三省输给江浙沪? 台军视若珍宝的这款战舰 却被美军当靶船击沉(图) 埃及北部两列火车相撞 事故造成近30人伤亡 俄罗斯和乌克兰交换被俘边防士兵 两国关系或有改进 候选人赛丁立人圈到重量级粉丝 首战阿罗尼扬 国际社会吁就巴以新冲突展开独立调查 遭以方拒绝 3年了!华夏在天河终于进球 连捅破两纪录太幸福 会长赵亮镐一家涉嫌非法雇人 大韩航空总部遭搜查 男子涉嫌殴打6岁女儿致其死亡 已被警方控制(图) 中国欧盟商会主席:中国近18个月改革步伐大大提速
跳水系列赛首日中国四冠 曹缘/谢思埸三米板封王 万达确认与新西兰区块链公司达成合作 不涉任何ICO 连胜终止!大热国安遭迎头冷水 要重蹈去年覆辙? 波音空客WTO互掐14年 结案后仍各执一词 切尔西王牌:1点要向布冯学习 我今年表现出色 收盘:美债收益率再创7年新高 美股收跌 鲁媒:小丁忘记了感恩 有如今价值鲁媒功不可没 雀巢上半年利润大涨,美国、中国市场有所好转 澳大利亚反对中国军舰进入印度洋 却反遭印媒批评 奥兰多夜店枪击案开审 枪手妻子被控知情不报 中超红黄牌统计:施蒂利克+赵宏略第三轮将停赛 施大爷斗法国安那位又被克 黄金中场难逃天罗地网
北京晚报:中国女排意外惨败与轻敌有关 产能过剩致液晶面板持续降价 友达光电关闭上海工厂 村干部转移受灾群众罹难 留下一句“我马上就到” 疑吸毒男子高速公路肇事 持刀袭警致两警察受伤 亚冠第三轮最佳阵容出炉:高拉特携奥斯卡入选 英国名模遭前任雇凶泼硫酸 终身监禁行凶者将获释 北京媒体:没有花钱的不是 视频裁判堵上某些人嘴 中国驻美大使回应美301调查:将坚决予以同等回击 百度周一盘中交易股价一度达278.75美元 创历史新高 2017做什么生意有前景 养一百只土鸡利润多少 如何创业白手起家 开什么店比较有市场 AG亚游集团