西瓜分享(ShareSDK Android版)接入文档

文档概述

此文档为ShareSDK_Android客户端接入文档。 本文介绍如何在Android平台下,快速接入西瓜ShareSDK。 文档分成三大部分:
1.接入准备工作
2.接口说明
3.接口调试以及注意事项

文档结构

  1. 接入准备工作
  2. 接口说明
  3. 接口调试以及注意事项

1 接入准备工作

1.1 SDK下载包

渠道版SDK下载包包含: ShareSDK作为XGSDK的插件包,接口已经集成到了xgsdk-api中,在使用的时候,只需要在程序里面先调用ShareSDK的接口。

西瓜SDK的Jar包:xgsdk-api_2.2.0.jar api 下载

在AndroidManifest.xml添加如下代码:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />  
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

1.2 后台配置

需要在XG后台进入分享功能页面,具体如下图:

2 接口说明

2.1 分享相册图片

接口:

void xgPhotoShareActivity(final String uid,final String roleId,final Activity activity, final String title,final String description);

参数:
1.用户id,供数据上报使用
2.角色id,供数据上报使用 3.当前活动Activity
4.分享的标题
5.分享的描述

以上参数都不能为空,而且Url必要按照格式传入,否者无法拉起分享

XGSDK.getInstance().xgPhotoShareActivity("aaa","bbb",ShareActivity.this,"asdasd", "asdasd","http://www.baidu.com");

2.2 分享本地图片

接口:

void xgShareLocalImage(final String uid,final String roleId,final String shareChannle, final String imagename,final String title, final String description, final String targeturl);

参数:
1.用户id,供数据上报使用
2.角色id,供数据上报使用
3.分享的渠道类型(目前支持的传入类型为: 分享图片微信好友 = "weichatfriend"; 分享图片朋友圈 = "weichatzone"; 分享web链接微信好友 = "weichatfriendweb"; 分享web链接朋友圈 = "weichatzoneweb"; 分享图片QQ好友 = "qqimage"; 分享图文QQ好友 = "qqimagetext"; 分享图片QQ空间 = "qqzoneimage"; 分享图文QQ空间 = "qqzoneimagetext"; 分享图片新浪微博 = "weibo"; 分享web链接新浪微博 = "weiboweb") 4.分享的本地图片名字(传入分享图片的路劲)
5.分享的标题
6.分享的描述
7.点击分享跳转的Url(分享图文QQ好友和QQ空间,分享web链接微信好友,分享web链接朋友圈,分享web链接新浪微博必须传此url)

以上参数都不能为空,而且Url必要按照格式传入,否者无法拉起分享

XGShareController.getInstance().xgShareLocalImage("aaa","bbb","weichatfriend","/mnt/sdcard/imagename.png", "asdasd", "asdasd", "http://www.baidu.com");

3 接口调试已经注意事项

注意微信分享和新浪微博分享,分享时候的包名和APK签名必须要和微信,新浪后台填写的一致。并且需要手机提前安装好微信和新浪微博。新浪微博客户端必须为正式版。 微信开放平台:https://open.weixin.qq.com/ 腾讯社区开放平台:http://page.opensns.qq.com/ 新浪微博开放平台:http://open.weibo.com/