Android分享SDK接入说明

1 文挡说明

1.1 功能描述

本文档旨在说明龙图BaseSDK版本分享功能说明。
本文的所述接口需要在接入龙图BaseSDK，并且初始化以后才可以使用。

1.2 阅读范围

本文档适用于SDK 接入人员阅读

1.3 使用说明

SDK分享功能封装了各平台分享接口，以方便开发者接入. 必选参数不能null或者空字符串. 图片需要的地址皆为设备本地存储全路径。

2 接口使用说明

3.1 功能说明

分享信息到第三方平台。

3.2 LTShareParams 参数说明

LTShareParams 渠道类型说明

参数	类型	说明	参数值
Share_Type_Unkown	int	未知渠道，主要用于分享失败情况。由于参数或者没有打分享渠道包的时候产生
Share_Type_QQ	int	QQ分享	1
Share_Type_Qzone	int	QQ空间分享	2
Share_Type_WeChat	int	微信好友分享	3
Share_Type_WeChatLine	int	微信朋友圈分享	4
Share_Type_SinaWeiBo	int	新浪微博分享	5
Share_Type_Facebook	int	Facebook分享	6
Share_Type_Twitter	int	Twitter分享	7
Share_Type_System	int	系统分享	8

参数	类型	说明
shareFlag	String	分享类型 (1) Share_Flag_Text 文本分享（2） Share_Flag_TextImage 图片分享（3）Share_Flag_Link 连接分享
shareText	String	想要分享的文字内容
shareImagepath	String	需要分享出去的图片地址
shareThumbImage	String	需要分享出去的缩略图图片地址
shareUrl	String	需要分享出去的链接
shareTitle	String	需要分享出去的连接标题

3.3 接口定义

3.3.1 默认分享接口

使用分享墙，SDK制定了UI，提供用户选择分享渠道。

/**
     * 分享接口
     *
     * @param logValue 分享数据接口
     * @param callback 分享接口回调
     */
    public void LTBaseSDKSendShare(LTShareParams logValue,
                                   LTShareCallback callback);

3.3.2 自定义分享接口（可选）

研发自定义UI, 直接设置分享渠道。
type值请从参数 3.2 LTShareParams 参数说明

/**
     * 分享接口
     *
     * @param type     分享渠道 LTShareParams内的type值。 参数## 3.2 LTShareParams 参数说明
     * @param logValue 分享数据接口
     * @param callback 分享接口回调
     */
    public void LTBaseSDKSendShare(int type,LTShareParams logValue,
                                   LTShareCallback callback);

3.4 接口举例

3.4.1 文本内容分享

参数	类型	说明	是否必传
shareFlag	String	LTShareParams.Share_Flag_Text	必传
shareText	String	想要分享的文字内容	必传


LTShareParams sharedata = new LTShareParams();
sharedata.setShareFlag(LTShareParams.Share_Flag_Text);
sharedata.setShareText("龙图游戏分享测试");
LTBaseSDK.getInstance(mMainActivity).LTBaseSDKSendShare(sharedata,
                    new LTShareCallback() {
                        @Override
                        public void LTBaseShareSuccess(int type) {
                            // TODO Auto-generated method stub
                           // 分享成功
                        }
                        @Override
                        public void LTBaseShareFail(int type, int code) {
                            // TODO Auto-generated method stub
                           // 分享失败
                        }
                    });

3.4.2 图片内容分享

参数	类型	说明	是否必传
shareFlag	String	LTShareParams.Share_Flag_TextImage	必传
setShareImagepath	String	本地图片地址	必传

LTShareParams sharedata = new LTShareParams();
sharedata.setShareFlag(LTShareParams.Share_Flag_TextImage);
 sharedata.setShareTitle("龙图游戏");
 sharedata.setShareText("龙图游戏官网链接");
 sharedata.setShareImagepath(本地图片地址);
LTBaseSDK.getInstance(mMainActivity).LTBaseSDKSendShare(sharedata,
                    new LTShareCallback() {
                        @Override
                        public void LTBaseShareSuccess(int type) {
                            // TODO Auto-generated method stub
                           // 分享成功
                        }
                        @Override
                        public void LTBaseShareFail(int type, int code) {
                            // TODO Auto-generated method stub
                           // 分享失败
                        }
                    });

3.4.3 链接内容分享

参数	类型	说明	是否必传
shareFlag	String	LTShareParams.Share_Flag_Link	必传
setShareUrl	String	需要分享出去的url	必传
setShareTitle	String	分享标题，如果没有传将会使用游戏名称	可选
setShareText	String	页面描述	可选
setShareImagepath	String	本地图片地址	可选
setShareThumbImage	String	本地图片地址	可选


LTShareParams sharedata = new LTShareParams();
sharedata.setShareFlag(LTShareParams.Share_Flag_Link);
 sharedata.setShareUrl(需要分享的连链接);
 sharedata.setShareTitle("龙图游戏");
 sharedata.setShareText("龙图游戏官网");
 sharedata.setShareImagepath(本地图片地址);
 sharedata.setShareThumbImage(chachePath);
LTBaseSDK.getInstance(mMainActivity).LTBaseSDKSendShare(sharedata,
                    new LTShareCallback() {
                        @Override
                        public void LTBaseShareSuccess(int type) {
                            // TODO Auto-generated method stub
                           // 分享成功
                        }
                        @Override
                        public void LTBaseShareFail(int type, int code) {
                            // TODO Auto-generated method stub
                           // 分享失败
                        }
                    });

3.5 回调说明

/**
* 分享成功
* @param type 本次使用的分享渠道type
*/
public void LTBaseShareSuccess();
/**
* 分享失败
* @param type 本次使用的分享渠道type
*/
public void LTBaseShareFail (int type, int code);

4、参数规则限制介绍

综合3个渠道信息对比取最小值，分享链接的时候，描述信息不可以超过40个字符,title 标题不能超过 30个字符。
分享图片不能超过2M。

4.1、新浪微博

新浪微博支持分享：文字、本地图片、网络图片
参数说明： text：140字符以内、微博客户端分享图片不能大于2M，仅支持JPEG、GIF、PNG格式；注：微博分享链接是链接和内容拼接在一起的。

分享的文本内容http://ceshi.com;

如果imagePath和imageUrl同时存在，imageUrl将被忽略。

4.3、QQ空间

QQ空间支持分享链接参数说明 title：最多200个字符 text：最多600个字符

4.4、微信（好友、朋友圈、收藏）

参数说明： title：512Bytes以内、text：1KB以内、imageData：10M以内、 imagePath：10M以内(传递的imagePath路径不能超过10KB)、 imageUrl：10KB以内 musicUrl：10KB以内、 url：10KB以内

4.5、QQ分享

QQ分享支持图片和链接
参数说明： title：最多30个字符、 text：最多40个字符

4.6、Facebook分享

Facebook支持分享图片、链接，不支持分享文本，分享图片的时候不支持带文本内容
参数说明：图片小于4M

4.7、Twitter分享

Twitter支持分享图片、文本，没办法知道分享结果，跳转过去回来就算成功
参数说明：图片小于4M，文本内容小于140字符。

Table of Contents