分享组件

English version for ShareSDK

分享组件（ShareSDK）是为iOS、Android、WP8 的APP提供社会化功能的一个组件，开发者仅需10分钟即可集成到自己的APP中，它不仅可以帮助开发者轻松实现在人人网中的社会化分享、登录、关注、获得用户资料、获取好友列表等主流的社会化功能，还有强大的社会化统计分析管理后台，可以实时了解用户、信息流、回流率、传播效率等数据，有效地指导移动APP的日常运营与推广，同时为APP引入更多的社会化流量。 聊天将是人人网下一阶段在移动端主要的产品战略，开放平台将对移动端应用提供分享到聊天的组件，以便可以把第三方APP的内容分享到人人网的客户端中，在用户聊天和群组聊天的界面中展示。

分享组件使用说明

1、下载并导入人人网SDK2.0。

Android平台：下载sdk及demo

iOS平台：下载sdk及demo

2、参照iOS人人分享组件使用说明和Android人人分享组件使用说明,并完成第三方应用中的一些开发工作。

注明：第三方也可根据自身需要，对SDK进行二次开发。

安卓分享组件

简介

人人分享组件是对人人分享功能的一个简单封装，主要包括“分享到聊天”(概念版***版以上支持)与“分享到人人”(概念版***版以上支持)两部分。

安装

将SDK导入到项目里面: 将jar包(RennShareComponent_Android.jar)拷贝到工程的libs目录(如果没有可以创建)，右键点击jar文件， 选择“Build path”----->”Add to Build Path”，如下图：

使用说明

初始化RennShareComponent:

shareComponent = RennShareComponent.getInstance(this); //获取实例

shareComponent.init(APP_ID, API_KEY, SECRET_KEY); //设置应用信息

通过为RennShareComponent设置监听来处理消息发送结果：

shareComponent.setSendMessageListener(new SendMessageListener() {

@Override

public void onSendMessageSuccess(String messageKey, Bundle bundle){ // TODO Auto-generated method stub } @Override public void onSendMessageFailed(String messageKey, ShareMessageError e) { // TODO Auto-generated method stub } @Override public void onSendMessageCanceled(String messageKey) { // TODO Auto-generated method stub } });

分享消息，以分享一条图文混排消息为例：

RennImgTextMessage message = new RennImgTextMessage();

Bitmap m = null;

m=BitmapFactory.decodeResource(getResources(),R.drawable.test);

message.setThumbData(m); //设置缩略图信息

message.setUrl(“http://fmn.rrfmn.com/fmn060/20131027/1505/large_IY1N_4dd300008b03118c.jpg”); //设置跳转链接

message.setDescription(“测试图描述”); //设置消息描述

message.setTitle(“测试图标题”); //设置消息标题

message.setMessageKey(“123456”); //设置消息的唯一标示

shareComponent.setSendMessageListener(new SendMessageListener() { @Override

public void onSendMessageSuccess(String messageKey, Bundle bundle){ // TODO Auto-generated method stub } @Override

public void onSendMessageFailed(String messageKey, ShareMessageError e) { // TODO Auto-generated method stub } @Override

public void onSendMessageCanceled(String messageKey) { // TODO Auto-generated method stub } });

shareComponent.sendMessage(message, MessageTarget.TO_TALK); //消息发送 m.recycle();

分享信息列表

RennTextMessage纯文本分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
title	String	false	文本标题
text	String	true	文本内容
url	String	false	跳转链接

RennImageMessage纯图片分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
title	String	false	文本标题
imageUrl	String	false	网络图链接
localPath	String	false	本地图路径
thumbData	Bitmap	true	缩略图数据

注：imageUrl与localPath为缩略图点击放大后图片信息，该两个字段不能同时为空，两个字段同时存在时默认取localPath进行处理。

RennImgTextMessage纯图片分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
url	String	true	跳转链接
title	String	false	文本标题
description	String	false	描述内容
thumbData	Bitmap	false	缩略图数据

注：title、description与thumbData三个字段不能同时为空。

分享消息错误码

ShareMessageError分享消息出错:

code(int型)	Message(String型)
1000	人人客户端不存在或现有版本不支持，请下载最新的人人客户端
1001	rennShareComponent实例没有初始化appId,apiKey,secretKey
1002	人人客户端处发送消息失败
1010	纯文本信息text字段不能空
1020	纯图片信息thumbBmp字段不能为空
1021	纯图片信息localPath字段与imageUrl字段不能全为空
1022	纯图片信息localPath字段的文件不存在
1030	图文混排信息thumbBmp,text,title字段不能全为空
1031	图文混排信息url字段不能为空
1032	缩略图大小超界

素材图片

iOS分享组件

安装

在XCode中建立你的工程。 将SDK文件夹中包含的libShareComponent.a，RennShareComponent.h两个文件添加到你所建的工程中，如下图所示：

在你的工程文件中选择Build Setting，在Search Paths中添加 libShareComponent.a，RennShareComponent.h g两个文件所在位置（如下图所示）。 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏的“URL type“添加“URL scheme”为你所注册的应用程序id（如下图所示） URL Schemes值应该为renrenshare[AppId][bundleId]，[AppId]为你在人人开发平台注册的AppId，[bundleId]为当前应用的bundleId。

在你需要使用人人分享组件API时import RennShareComponent.h。 然后初始化人人分享组件： 示例： 分享一个图文消息 至此，你已经能使用人人分享组件的分享功能了，更详细的示例请见下载sdk及demo。

分享信息列表

RennTextMessage纯文本分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
title	String	false	文本标题
text	String	true	文本内容
url	String	false	跳转链接

RennImageMessage纯图片分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
title	String	false	文本标题
imageUrl	String	false	网络图链接
localPath	String	false	本地图路径
thumbData	Bitmap	true	缩略图数据

注：imageUrl与localPath为缩略图点击放大后图片信息，该两个字段不能同时为空，两个字段同时存在时默认取localPath进行处理。

RennImgTextMessage纯图片分享信息参数:

名称	类型	必选	描述
messageKey	String	false	不同消息的唯一识别
url	String	true	跳转链接
title	String	false	文本标题
description	String	false	描述内容
thumbData	Bitmap	false	缩略图数据

注：title、description与thumbData三个字段不能同时为空。

分享消息错误码

ShareMessageError分享消息出错:

code(int型)	Message(String型)
1000	人人客户端不存在或现有版本不支持，请下载最新的人人客户端
1001	rennShareComponent实例没有初始化appId,apiKey,secretKey
1002	人人客户端处发送消息失败
1010	纯文本信息text字段不能空
1020	纯图片信息thumbBmp字段不能为空
1021	纯图片信息localPath字段与imageUrl字段不能全为空
1022	纯图片信息localPath字段的文件不存在
1030	图文混排信息thumbBmp,text,title字段不能全为空
1031	图文混排信息url字段不能为空
1032	缩略图大小超界

素材图片