Android分享SDK接入说明

1 文挡说明

1.1 功能描述

本文档旨在说明android SDK 4.x版本分析功能说明。
本文档除非特殊说明外，默认表示对所有SDK4.x版本有效；
本文的所述接口需要在接入掌趣SDK，并且初始化以后才可以使用。

1.2 阅读范围

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

1.3 参数说明

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

2 参数说明

2.1 新浪微博参数说明

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

2.1.1 新浪微博分享参数

2.2 QQ好友分享参数说明

平台type: Share_Type_QQ
本平台分为两种分享格式.

2.2.1 QQ好友纯图

2.2.2 QQ好友图文，链接分享

2.3 QQ空间分享参数说明

平台type: Share_Type_Qzone

2.3.1 图文链接分享参数

2.4 微信分享参数说明

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

2.4.1 文本分享参数

2.4.2 图文分享参数

2.4.3 链接分享参数

3 接口使用说明

3.1 功能说明

分享信息到第三方平台。

3.2 接口定义

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

3.2 接口举例

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

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.3 回调说明

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

4、参数规则限制介绍

4.1、新浪微博

新浪微博支持分享：文字、本地图片、网络图片
参数说明： text：140字符以内、微博客户端分享图片不能大于2M，仅支持JPEG、GIF、PNG格式 ；注：微博分享链接是将链接写到setText内：setText(“分享文本 http://ceshi.com”);

如果imagePath和imageUrl同时存在，imageUrl将被忽略。
注意：分享本地视频必须用新浪微博客户端分享；
分享本地视频 setFilePath(“/sdcard/video.MP4”)

4.2、腾讯微博

腾讯微博支持分享文字、本地图片、网络图片和经纬度信息
参数说明： text：最多140个字字符、image：图片最大4M

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个字符