一、文挡说明

1.1目的

本文档旨在说明android SDK 4.x 版本分析功能说明。

1.2阅读范围

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

1.3说明

本文档除非特殊说明外，默认表示对所有SDK 4.x 版本有效；

二、不同平台接入参数说明

2.1说明

掌趣SDK分享功能封装了各平台分享接口，但各平台分享接口差异不同，所以各平台需要参数也不尽相同。本节以列表形式展示各平台需要的参数和字段要求,以方便开发者接入. 必选参数不能null或者空字符串. 图片需要的地址皆为设备本地存储全路径。
 本文所有参数key，皆在Ourpalm_Share_Params 类
 列如：
 参数key： Share_Params_Flag_Key。
 代码中使用为：Ourpalm_Share_Params. Share_Params_Flag_Key。

2.2参数说明

2.2.1新浪微博参数说明

平台type: Share_Type_SinaWeiBo
 本平台需要的三个参数，可以根据需要自由选择，但是不可以都不选。

2.2.1.1新浪微博分享参数

参数	类型	说明	是否可选
Share_Params_Text_Key	String	想要分享的文本内容	可选
Share_Params_LinkUrl_Key	String	想要分享的链接	可选
Share_Params_ImagePath_Key	String	想要分享的图片	可选

 

2.2.2QQ好友分享参数说明

平台type: Share_Type_QQ
 本平台分为三种分享格式，

2.2.2.1 QQ好友纯图

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_TextImage	必选
Share_Params_ImagePath_Key	String	想要分享的图片	必选

2.2.2.2QQ好友图文，链接分享

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_Link	必选
Share_Params_ImagePath_Key	String	想要分享的图片	必选
Share_Params_LinkDescription_Key	String	图片描述	必选
Share_Params_LinkUrl_Key	String	点击以后跳转的链接	必选
Share_Params_LinkTitle_Key	String	链接标题	必选

2.2.3QQ空间分享参数说明

平台type: Share_Type_Qzone

2.2.3.1图文链接分享参数

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_Link	必选
Share_Params_ImagePath_Key	String	想要分享的图片	必选
Share_Params_LinkDescription_Key	String	图片描述	必选
Share_Params_LinkUrl_Key	String	点击以后跳转的链接	必选
Share_Params_LinkTitle_Key	String	链接标题	必选

2.2.4微信分享参数说明

微信平台分为微信好友和微信朋友圈分享，两种方式参数相同，但是type不同。
 微信好友平台type：Share_Type_WeChat
 微信好友平台type：Share_Type_WeChatLine

2.2.4.1文本分享参数

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_Text	必选
Share_Params_Text_Key	String	分享的文字	必选

2.2.4.2图文分享参数

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_TextImage	必选
Share_Params_Text_Key	String	分享的文字	可选
Share_Params_ImagePath_Key	String	本地图片地址	必选

2.2.4.3链接分享参数

参数	类型	说明	是否可选
Share_Params_Flag_Key	String	Share_Flag_Link	必选
Share_Params_ImagePath_Key	String	想要分享的图片	可选
Share_Params_LinkDescription_Key	String	图片描述	必选
Share_Params_LinkUrl_Key	String	点击以后跳转的链接	必选
Share_Params_LinkTitle_Key	String	链接标题	必选

 

三、接口使用说明

3.1功能说明

分享信息到第三方平台。

3.2接口定义

/**     * 第三方分享接口     *     * @param type     *            分享渠道type     * @param logValue     *            分享数据接口     * @param callback     *            分享接口回调     */    public void Ourpalm_SendShare(int type, Bundle logValue,            Ourpalm_Share_Callback callback)

3.3接口举例

以微信好友，分享网页链接为例

Bundle sharedata = new Bundle(); sharedata.putString(Ourpalm_Share_Params.Share_Params_Flag_Key, Ourpalm_Share_Params.Share_Flag_Link); sharedata.putString(Ourpalm_Share_Params.Share_Params_LinkUrl_Key, "http://www.ourpalm.com"); sharedata.putString(Ourpalm_Share_Params.Share_Params_LinkTitle_Key, "掌趣科技"); sharedata.putString(Ourpalm_Share_Params.Share_Params_LinkDescription_Key, "掌趣科技官网链接"); sharedata.putString(Ourpalm_Share_Params.Share_Params_ImagePath_Key, "本地图片链接"); Ourpalm_Entry.getInstance(MainActivity.mMainActivity).Ourpalm_SendShare( Ourpalm_Share_Params.Share_Type_WeChat, sharedata, new Ourpalm_Share_Callback() { @Override public void Ourpalm_Success() { // TODO Auto-generated method stub Toast.makeText(MainActivity.mMainActivity, "分享成功", Toast.LENGTH_SHORT).show(); } @Override public void Ourpalm_Fail(int code) { // TODO Auto-generated method stub Toast.makeText(MainActivity.mMainActivity, "分享失败", Toast.LENGTH_SHORT).show(); } });

3.4回调说明

/** * 分享成功 */ public void Ourpalm_Success(); /** * 分享失败 * @param code *          预留参数，暂时没用 */ public void Ourpalm_Fail (int code);