Umeng Social Android SDK 开发手册 变更说明表 1 版本号 变更 备注 V3.3.6 1、增加设置显示平台接 口 2、增加是否开启图片缓 存接口 目 录 Umeng Social Android SDK 开发手册 1 前提说明 3 一、SDK功能接口 3 1.1、打开分享面板 （ openShare ） 3 1.2、授权接口 （ doOauthVerify ） 5 1.3、直接分享接口 ( directShare, 底层分享API ) 6 1.4、指定平台分享，内容可编辑 ( postShare ) 7 1.5、分享到多个已授权的平台 ( postShareMulti ) 8 1.6、用户登录 ( Login ) 9 1.7、使用自有账户登录 ( Login ) 10 1.8、分享到短信 ( shareSms ) 11 1.9、分享到邮件 ( shareEmail ) 11 1.10、获取用户个人信息 ( getUserInfo ) 12 1.11、获取平台相关信息 ( getPlatformInfo ) 13 1.12、打开用户中心 ( openUserCenter ) 14 1.13、发表评论 ( postComment ) 15 1.14、获取评论列表 ( getComments ) 16 1.15、打开评论列表页面 ( openComment ) 17 1.16、发布Like ( postLike ) 18 1.17、发表UnLike ( postUnLike ) 19 1.18、获取好友列表 ( getFriends ) 20 1.19、注册回调接口 ( registerListener ) 21 1.20、用户注销 ( loginout ) 22 1.21、删除授权 ( deleteOauth ) 23 1.22、设置要分享的文字内容 ( setShareContent ) 24 1.23、设置平台通用的多媒体分享内容 ( setShareMedia ) 24 1.24、设置平台独立的分享内容 ( setShareMedia ) 25 二、注册摇一摇相关功能 26 2.1、注册摇一摇截图分享 ( registerShakeListender ) 26 2.2、注册摇一摇打开分享面板 ( registerShakeToOpenShare ) 28 2.3、注册摇一摇截图 ( registerShakeToScrShot ) 28 2.4、直接截图 （不需要摇一摇） ( takeScrShot ) 29 三、SDK平台配置 ( SocializeConfig ) 30 3.1、设置SSO授权 ( setSsoHandler ) 30 3.2、添加对QQ平台 的支持 ( supportQQPlatform ) 30 3.3、添加对微信平台的支持 ( supportWXPlatform ) 31 3.4、添加微信朋友圈的支持 ( supportWXCirclePlatform ) 32 3.5、分享面板上的平台排序 ( setPlatformOrder ) 32 3.6、移除分享面板上的平台 ( removePlatform ) 33 3.7、获取用户选中的平台 ( getSelectedPlatform ) 33 3.8、关注某平台的官方微博 ( addFollow ) 34 3.9、设置需要显示的平台（setPlatforms） 35 3.10、开启图片缓存（setCacheValidStatus） 35 四、线上文档 35 前提说明 假设在你的Activity中声明了如下成员变量,文档中将使用该成员变量进行函数调用. 1、UMSocialService mController = UMServiceFactory.getUMSocialService(“com.umeng.share”, RequestType.SOCIAL); 2、文档中出现YourActivity.this或者mContext 的地方开发者替换成要调用函数时用户所在的Activity 即可 ； 3、文档中出现的mUmengSdkButton假设为你的布局文件中的某个按钮; 4、与摇一摇相关的功能请参考线上摇一摇集成文档。 一、SDK功能接口 1.1、打开分享面板 （ openShare ） 接口原型1 : public void openShare(final Activity activity, boolean forceLogin) ; 参数说明 : 参数 参数说明 activity 调用者activity。使用Social SDK时，打开的分 享平台选择面板为Dialog类型，依赖于开发者 的Activity. forceLogin 打开分享面板时是否强制用户登录，默认为 false. 调用打开分享面板接口的示例代码如下： public void onClick(View v) / 点击相关按钮，打开分享面板 if ( v = mUmengSdkButton ) mController.openShare(YourActivity.this, false); 接口原型2 : public void openShare(final Activity activity, boolean forceLogin, UMBaseAdapter adapter); 参数说明 : 参数 参数说明 activity 调用者activity。使用Social SDK时，打开的分 享平台选择面板为Dialog类型，依赖于开发者 的Activity. forceLogin 打开分享面板时是否强制用户登录，默认为 false. adapter 截图适配器 该接口为打开分享面板，并且将要分享的图片替换为当前屏幕的截图。调用打开分享面板接口的示 例代码如下： public void onClick(View v) / 点击相关按钮，打开分享面板 if ( v = mUmengSdkButton ) mController.openShare(YourActivity.this, false， new UMAppAdapter(YourActivity.this); 界面截图 : 1.2、授权接口 （ doOauthVerify ） 接口原型: public void doOauthVerify(final Context context, final SHARE_MEDIA platform, UMAuthListener listener) 参数说明 : 参数 参数说明 context 调用者 应用的上下文环境。 platform 用户要进行授权的目标平台 listener 授权监听接口,包括授权错误、授权完成、授权 取消、授权开始的回调函数 调用授权接口的示例代码如下： public void onClick(View v) / 点击相关按钮进行授权 if ( v = mUmengSdkButton ) mController.doOauthVerify(mContext, SHARE_MEDIA.SINA, new UMAuthListener() Override public void onError(SocializeException e, SHARE_MEDIA platform) Override public void onComplete(Bundle value, SHARE_MEDIA platform) String uid = value.getString(“uid“) ; / 判断是否成功 if (value != null else Toast.makeText(mContext, “授权失败“, Toast.LENGTH_SHORT).show(); Override public void onCancel(SHARE_MEDIA arg0) Override public void onStart(SHARE_MEDIA arg0) ); 1.3、直接分享接口 ( directShare, 底层分享API ) 接口原型 : public void directShare(final Context context, final SHARE_MEDIA platform, final SnsPostListener listener) 参数说明 : 参数 参数说明 context 调用者 应用的上下文环境。 platform 调用者要分享到的目标平台 listener 分享的监听接口，分享开始、完成的回调 如果用户还没有授权目标平台则需要先进行授权，授权完成后则直接分享，没有内容编辑页面。适 合开发者自定义UI，然后调用directShare接口进行分享。调用直接分享接口的示例代码如下： public void onClick(View v) / 点击相关按钮直接分享， 如果用户没有授权则需要先授权. if ( v = mUmengSdkButton ) mController.directShare(YourActivity.this, SHARE_MEDIA.SINA, new SnsPostListener() Override public void onStart() Override public void onComplete(SHARE_MEDIA platform, int eCode, SocializeEntity entity) Toast.makeText(YourActivity.this, “分享完成“, Toast.LENGTH_SHORT).show(); ); / end if 具体集成方案请参考在线文档，http:/dev.umeng.com/social/android/share/specific- integration 1.4、指定平台分享，内容可编辑 ( postShare ) 接口原型: public void postShare(Context context, SHARE_MEDIA platform, SnsPostListener listener) 参数说明 : 参数 参数说明 context 调用者 应用的上下文环境。 platform 用户要分享到的目标平台 listener 分享监听器 如果用户还没有授权目标平台则需要先进行授权，用户授权后会跳转到内容编辑页面，用户选择发 送后直接分享如果不想编辑分享的内容，则换用directShare即可。调用postShare接口的示例代码如 下： public void onClick(View v) / 点击相关按钮进行分享 if ( v = mUmengSdkButton ) mController.postShare(mContext, SHAER_MEDIA.QZONE, new SnsPostListener() Override public void onComplete(SHARE_MEDIA arg0, int arg1, SocializeEntity arg2)