介绍
ShareSDKUtils是基于ShareSDK提供的API进行封装的工具类,方便于我们开发时分享的调用,支持使用默认的GUI,也支持自定义界面,点击事件中调用分享到某一个ShareSDK支持的第三方平台,使用ShareSDKUtils需要依赖ShareSDK提供的开发包。
使用的方式为:如ShareSDKUtils.getInstance(Context context).useDefaultGUI(需要传入的那些参数);
Mob相关文档介绍,提供参考
接下来介绍ShareSDKUtils封装的方法:
使用默认的GUI分享
App中分享按钮点击事件中,调用此方法可以弹出ShareSDK自带的默认分享的弹框,包括你选择的那些第三方平台,最后一个参数是平台分享后操作的回调,有分享成功、分享失败、取消分享三个操作的回调,如果不需要监听分享动作的回调,可以传null,默认对应的操作会弹出吐司"分享成功","分享失败","分享已取消"的提示。
/** * 使用默认的分享GUI * * @param title 标题 * @param content 内容 * @param imgUrl 图片的Url * @param siteUrl 网站的Url * @param shareListener 分享的回调 */private static void useDefaultGUI(String title, String content, String imgUrl, String siteUrl, PlatformActionListener shareListener) { ShareSDK.initSDK(mContext); OnekeyShare oks = new OnekeyShare(); //关闭sso授权 //oks.disableSSOWhenAuthorize(); // title标题,印象笔记、邮箱、信息、微信、人人网和QQ空间使用 oks.setTitle(title); // titleUrl是标题的网络链接,仅在人人网和QQ空间使用 oks.setTitleUrl(siteUrl); //分享网络图片,新浪微博分享网络图片需要通过审核后申请高级写入接口,否则请注释掉测试新浪微博 oks.setImageUrl(imgUrl); // url仅在微信(包括好友和朋友圈)中使用 oks.setUrl(siteUrl); // site是分享此内容的网站名称,仅在QQ空间使用 oks.setSite(""); // siteUrl是分享此内容的网站地址,仅在QQ空间使用 oks.setSiteUrl(siteUrl); // text是分享文本,所有平台都需要这个字段 oks.setText(content + "\n链接: " + siteUrl); //设置回调 oks.setCallback(shareListener); // 启动分享GUI oks.show(mContext); }
自定义GUI的分享
如果不使用ShareSDK自带的GUI,自定义分享的布局,则在对应的点击事件中,调用分享到某个平台的方法,下面介绍封装好的单独分享到微信、朋友圈、QQ好友、QQ空间、新浪微博的方法。
分享到微信好友或朋友圈
/** * 分享到微信好友或朋友圈,图片可以是ur或者是本地的,默认本地图片优先 * * @param wechatType 微信好友或朋友圈 Wechat.NAME 微信好友 WechatMoments.NAME 朋友圈 * @param shareType 分享的类型 Platform.SHARE_WEBPAGE 网页 Platform.SHARE_IMAGE 图片 * @param title 标题 * @param content 内容 * @param siteUrl 网站的url * @param imgUrl 网络图片的url * @param bm bitmap * @param imgPath 本地图片的绝对路径 * @param shareListener 分享的回调 */private static void shareToWechat(String wechatType, int shareType, String title, String content, String siteUrl, String imgUrl, Bitmap bm, String imgPath, PlatformActionListener shareListener) { ShareSDK.initSDK(mContext); Wechat.ShareParams shareParams = new Wechat.ShareParams(); shareParams.setShareType(shareType); shareParams.setTitle(title);//设置标题 shareParams.setText(content);//设置内容 shareParams.setUrl(siteUrl);//设置网站 if (!TextUtils.isEmpty(imgUrl)) { //如果有网络图片,则设置图片的url shareParams.setImageUrl(imgUrl); } if (bm != null) { //如果是bitmap类型,则设置bm shareParams.setImageData(bm); } if (!TextUtils.isEmpty(imgPath)) { //如果是本地图片路径,则设置图片路径 shareParams.setImagePath(imgPath); } Platform platform = ShareSDK.getPlatform(wechatType); platform.share(shareParams);//分享 if (shareListener != null) { platform.setPlatformActionListener(shareListener);//设置回调 } else { //如果为空,设置默认回调回调 platform.setPlatformActionListener(defaultShareListner); } }
其中,第一个参数是分享到微信的类型:
如果是分享给微信好友,则是传 Wechat.NAME;
如果是分享到朋友圈,则是传 WechatMoments.NAME;
如果分享的是图片,可以传入网络图片的链接、bitmap对象、本地图片的绝对路径,三者只需传入一个,其他两个设置为null即可,如果三个都设置了,则只会显示其中一个,按照以下优先级(从高到底),只把优先级最高的那个显示:
bitmap
imgPath
imgUrl
当最后一个参数传入的分享动作回调为null时,会使用默认的回调:
/** * 默认的分享回调 */public static PlatformActionListener defaultShareListner = new PlatformActionListener() { @Override public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) { mHandler.post(new Runnable() { @Override public void run() { Toast.makeText(mContext, "分享成功", Toast.LENGTH_SHORT).show(); } }); } @Override public void onError(Platform platform, int i, Throwable throwable) { mHandler.post(new Runnable() { @Override public void run() { Toast.makeText(mContext, "分享失败", Toast.LENGTH_SHORT).show(); } }); } @Override public void onCancel(Platform platform, int i) { mHandler.post(new Runnable() { @Override public void run() { Toast.makeText(mContext, "分享已取消", Toast.LENGTH_SHORT).show(); } }); } };
这里和使用默认的GUI方法不同,如果为platform.setPlatformActionListener()传入的回调为null,会报空指针异常,所以这里创建一个默认的回调,也是弹出对应的吐司提示而已。
分享到QQ,QQ空间
/** * 分享到QQ,QQ空间 * * @param title 标题 * @param content 内容 * @param siteUrl 网站的url * @param imgUrl 网络图片的url * @param bm bitmap * @param imgPath 本地图片的绝对路径 * @param shareListener 分享的回调 */private static void shareToQQ(String title, String content, String siteUrl, String imgUrl, Bitmap bm, String imgPath, PlatformActionListener shareListener) { ShareSDK.initSDK(mContext); QQ.ShareParams shareParams = new QQ.ShareParams(); shareParams.setShareType(Platform.SHARE_WEBPAGE); shareParams.setTitle(title);//标题 shareParams.setText(content);//内容 shareParams.setTitleUrl(siteUrl);//网址 if (!TextUtils.isEmpty(imgUrl)) { //如果有网络图片,则设置图片的url shareParams.setImageUrl(imgUrl); } if (bm != null) { //如果是bitmap类型,则设置bm shareParams.setImageData(bm); } if (!TextUtils.isEmpty(imgPath)) { //如果是本地图片路径,则设置图片路径 shareParams.setImagePath(imgPath); } Platform platform = ShareSDK.getPlatform(QQ.NAME); platform.share(shareParams);//分享 if (shareListener != null) { platform.setPlatformActionListener(shareListener);//设置回调 } else { //如果为空,设置默认回调回调 platform.setPlatformActionListener(defaultShareListner); } }
分享到新浪微博
/** * 分享到新浪微博 * * @param content 内容 * @param siteUrl 网站的url * @param imgUrl 网络图片的url * @param bm bitmap * @param imgPath 本地图片的绝对路径 * @param shareListener 分享的回调 */private static void shareToSina(String content, String siteUrl, String imgUrl, Bitmap bm, String imgPath, PlatformActionListener shareListener) { ShareSDK.initSDK(mContext); SinaWeibo.ShareParams shareParams = new SinaWeibo.ShareParams(); shareParams.setContentType(Platform.SHARE_WEBPAGE); shareParams.setText(content + "\n" + siteUrl);//设置内容 if (!TextUtils.isEmpty(imgUrl)) { //如果有网络图片,则设置图片的url shareParams.setImageUrl(imgUrl); } if (bm != null) { //如果是bitmap类型,则设置bm shareParams.setImageData(bm); } if (!TextUtils.isEmpty(imgPath)) { //如果是本地图片路径,则设置图片路径 shareParams.setImagePath(imgPath); } Platform platform = ShareSDK.getPlatform(SinaWeibo.NAME); platform.share(shareParams);//分享 if (shareListener != null) { platform.setPlatformActionListener(shareListener);//设置回调 } else { //如果为空,设置默认回调回调 platform.setPlatformActionListener(defaultShareListner); } }
ShareSDKUtils源码查看和下载: