分享组件
分享组件(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 | 缩略图大小超界 |
素材图片