分享组件

2015年7月23日 (四) 09:51Renren讨论 | 贡献的版本

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至: 导航搜索

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”,如下图:

安卓分享组件1.jpg

使用说明

初始化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 缩略图大小超界

素材图片

ICON-48-ios.png ICON-96-ios.png

iOS分享组件

安装

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

Ios使用说明1.png

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


在你需要使用人人分享组件API时import RennShareComponent.h。 然后初始化人人分享组件: Ios使用说明4.png 示例: 分享一个图文消息 Ios使用说明5.png 至此,你已经能使用人人分享组件的分享功能了,更详细的示例请见下载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 缩略图大小超界

素材图片

ICON-57-ios.png ICON-114-ios.png ICON-120-ios.png