介绍
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源码查看和下载: