Android人人分享组件使用说明

跳转至: 导航搜索

English version for Android SharingSDK

目录

简介

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

安装

将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