友盟+搜索

{{errorMsg}}

产品概述

友盟社会化组件,可以让移动应用快速具备社会化分享、登录、评论、喜欢等功能,并提供实时、全面的社会化数据统计分析服务。

指南将会手把手教你使用社会化组件SDK,用5分钟为APP增加新浪微博、腾讯微博、人人网分享功能。

注意:本文示例代码均针对最新版SDK,如果你所用SDK的类名或方法名与此文不符合,请使用你所用SDK的随包文档、或者下载使用最新版SDK。

获取友盟Appkey

如果你之前已经在友盟注册了应用,并获取到了Appkey,可以继续使用它.

如果你尚未在友盟注册开发者账号,需要先注册,注册之后登录你的账号,点击**添加新应用**,填写完应用基本信息后,将进入"下载SDK并添加代码"页面,此页面即可得到Appkey

下载并安装SDK

下载SDK最新版

添加相关Phonegap插件

在终端或命令行运行以下命令:

      cordova plugin add org.apache.cordova.device
      cordova plugin add org.apache.cordova.device-motion
      cordova plugin add org.apache.cordova.file
      cordova plugin add org.apache.cordova.file-transfer
      cordova plugin add org.apache.cordova.geolocation
      cordova plugin add org.apache.cordova.inappbrowser
      cordova plugin add org.apache.cordova.network-information

添加代码和资源引用

将SDK(包括Js,CSS和图片文件)复制进入你的Phonegap项目(www目录),在html代码中引入Js和CSS文件。

<!--将此代码放入html<head>标签中-->
<link rel="stylesheet" type="text/css" href="css/social.umeng.css" />

<!--将此代码放入html<body>标签结尾-->
 <script type="text/javascript" src="js/jquery.js"></script>
 <script type="text/javascript" src="js/html2canvas.js"></script>
 <script type="text/javascript" src="js/social.umeng.js"></script>

设置APPKEY

在Js代码最前面请设置友盟APPKEY(从STEP2处获得)。


window.umappkey = '528dc5aa56240bb52f02343c';


快速分享

调用分享平台选择面板

作用

调用分享平台选择面板,选择平台后进行分享(假如未登录,会先进行登录操作)

使用

var opt = {
       'data' : {
              'content' : {
                     'text' : '', //要分享的文字
              }
       } 
}
$("#btn").umshare(opt);

参数

var opt = {
       'data' : {
              'content' : {
                     'text' : '', //要分享的文字
                     'furl' : '', //在线图片URL
                     'img' : '' //本地图片地址 furl和img同时存在时,优先取furl
              },
       },    
       'topic': {  //主题,用于数据统计,非必须
             'dc': 'default',  //主题描述
             'name':'default', //主题名称   
             'ni':1            //是否为新主题(1:是,0:否)
       }   
}

分享到某个平台

作用

不调用分享平台选择面板,直接分享到指定平台(假如未登录,会先进行登录操作)

使用

var opt = {
    'data' : {
       'content' : {
              'text' : '', //要分享的文字
       }
    }
}
$.fn.umshare.share(plat,opt);

参数

var plat;    //平台名
var opt = {
    'data':{
       'content' : {
              'text' : '', //要分享的文字
              'furl' : '', //在线图片URL
              'img' : '' //本地图片地址
       }
    },
   'topic': {  //主题,用于数据统计,非必须
         'dc': 'default',  //主题描述
         'name':'default', //主题名称   
         'ni':1            //是否为新主题(1:是,0:否)
   }   
}

直接分享(无界面)

作用

直接分享到指定平台,无内容编辑界面(假如未登录,会先进行登录操作)

使用

  var opt = {
         'data' : {
                'content' : {
                       'text' : '', //要分享的文字
                }
         } 
  }
  $.fn.umshare.shareSubmit('sina',opt);


参数

var plat;    //平台名
var opt = {
    'data':{
       'content' : {
              'text' : '', //要分享的文字
              'furl' : '', //在线图片URL
              'img' : '' //本地图片地址
       }
    },
   'topic': {  //主题,用于数据统计,非必须
         'dc': 'default',  //主题描述
         'name':'default', //主题名称   
         'ni':1            //是否为新主题(1:是,0:否)
   }   
}

截屏并分享

作用

使用html2canvas进行截屏并转换成图片保存到本地,然后分享

使用

$.fn.umshare.screenshot();//截屏并保存


/**
 * 截屏并分享实例
 **/
$("#screenshotBtn").click(function(){
    $.fn.umshare.screenshot(function(url){
          var opt = {
              'data' : {
                'content' : {
                       'text' : '友盟分享组件帮您接入和升级微博、微信等社交平台,快速武装您的应用!',
                       'img' : url
                }
              }
          }
         $.fn.umshare.share('sina',opt);
    });
  }); 


参数

  callback : 回调.function(url){}  //url为图片保存在本地的地址

登录

login

作用

调用login接口可以直接授权登录各平台.

使用

    $.fn.umshare.login(plat,callback);

参数

plat  平台名.('sina','tencent','qzone','renren','douban')
callback  回调.(function(e){};e为用户信息,{'token':'平台返回的token','uid':'平台返回的uid'})

示例

//登录新浪
$("#loginBtn").click(function(){
         $("#loginInfo").html('');
     $.fn.umshare.login('sina',function(user){
         $.fn.umshare.tip('登录成功,token:' + user.token + ', uid:' + user.uid);
         $("#loginInfo").html('登录成功,token:' + user.token + ', uid:' + user.uid);
     });
 });

getToken

作用

获取某个平台的登录信息.

使用

$.fn.umshare.getToken(plat);

参数

plat  平台名.('sina','tencent','qzone','renren','douban')

返回结果

{'token':'平台返回的token','uid':'平台返回的uid'}

示例 获取新浪的登录信息

$("#getTokenBtn").click(function(){ var info = $.fn.umshare.getToken("sina"); $("#getTokenInfo").html( info ? 'token:' + info.token + ', uid:' + info.uid : 'false'); });

checkToken

作用

检查某个平台的登录信息.如果未登录,则进行登录(等价于先使用getoken进行检测,若返回false,则调用login)

使用

$.fn.umshare.checkToken(plat,callback);

参数

plat  平台名.('sina','tencent','qzone','renren','douban')
callback  回调.(function(e){};e为用户信息,{'token':'平台返回的token','uid':'平台返回的uid'})

示例

//登录新浪
 $("#checkTokenBtn").click(function(){
     $("#checkTokenInfo").html('');
     $.fn.umshare.checkToken('sina',function(user){
         $.fn.umshare.tip('登录成功,token:' + user.token + ', uid:' + user.uid);
         $("#checkTokenInfo").html('登录成功,token:' + user.token + ', uid:' + user.uid);
     });
 });

delToken

作用

清除某个平台的登录信息.

使用

$.fn.umshare.delToken(plat);

参数

plat  平台名.('sina','tencent','qzone','renren','douban')

返回结果


示例

//退出新浪
        $("#delTokenBtn").click(function(){
               var info = $.fn.umshare.delToken("sina");
               $("#delTokenInfo").html('退出成功');
        });