分享转发 - 橙讯开放平台基线

方法名：SendMessage
作用：转发数据到橙讯

请求参数说明：

参数	类型	是否必填	含义	备注
message	CXMediaMessage	是	媒体对象	分享或转发对应的数据格式
enterpriseId	String	是	组织id

开发者在 App 中在集成橙讯 SDK 后，可调用接口实现，以下依次是文字、图片、音乐、视频、网页、小程序类型分享的示例。

如果分享的消息中涉及文件路径（如图片，Office文档类型消息），建议开发者针对 Android 7.0 版本及以上设备，判断橙讯版本支持的情况下，更新为 FileProvider 的方式进行分享。

CXMediaMessage （橙讯媒体消息内容）说明

字段说明

参数	类型	是否必填	含义	备注
typeStayOn	int	否	发送完成后是否返回应用	TYPE_STAY_ON_DEFAULT = 0, 弹出对话框用户选择 TYPE_STAY_ON_APP = 1, 留在App页面 TYPE_STAY_ON_CHENXUN = 2，返回到橙讯页面
sdkVer	int	否	sdk 版本号
input	boolean	否	是否有输入框	可选，如果不传值，橙讯自行处理
thumbData	byte[]	否	缩略图的二进制数据	限制内容大小不超过32KB
recipientId	long	否	接受者id	不为空时，伴随会话id一起传递过来；为0时，会话Id应为空
title	String	是	消息标题	限制长度不超过 512Bytes
description	String	否	消息描述	限制长度不超过 1KB
chatId	String	否	会话Id	不为空时，将会直接发送到此会话中；为空时，将会弹出选择最近联系人页面
logoUrl	String	否	三方app的icon	这里可由橙讯自身处理，如果三方传递将会使用三方提供的icon
appName	String	否	三方app的应用名称	这里可由橙讯自身处理，如果三方传递将会使用三方提供的名称
mediaObject	WXMediaMessage.IMediaObject	是	消息对象	用于描述一个媒体对象的接口，媒体对象包括:`CXTextObject`、`CXImageObject`、`CXMusicObject`、`CXVideoObject`、`CXWebpageObject`、 `CXFileObject`、`CXJumpAppObject`等

!> 注：目前仅支持 CXWebpageObject、CXImageObject、CXJumpAppObject 、CXFileObject。

CXJumpAppObject 类型

参数	类型	是否必填	含义	备注
packageName	String	否	包名	应用的唯一标识。注：外部应用必填
appData	String	是	数据链接	自定义数据，不限格式；当用户点击后将此数据返回给应用自行处理

CXImageObject 类型

参数	类型	是否必填	含义	备注
imagePath	String	否	本地图片的Uri	本地图片文件；理论上不限制图片类型

CXWebpageObject 类型

参数	类型	是否必填	含义	备注
webpageUrl	String	是	网页链接	web url 用来分享网页链接

CXFileObject 类型

参数	类型	是否必填	含义	备注
filePath	Uri	是	本地文件Uri	本地文件的Uri

示例代码

CXJumpAppObject jumpAppObject = new CXJumpAppObject();
jumpAppObject.packageName = getPackageName(); //if it is aar, input the package by yourself.
jumpAppObject.appData = "user-define app data";
CXMediaMessage msg = new CXMediaMessage(jumpAppObject);
msg.title = "test title";
msg.description = "test description";
msg.thumbData = null; //byte[];
msg.logoUrl = "http://cxhuiyi.cheng-xun.cn/assets/img/chengxun/share.png";  //optional, if not set, chengxun will set it by default
msg.appName = "app name";//optional
msg.typeStayOn = CXMediaMessage.TYPE_STAY_ON_APP; //stay on current page
SendMessage.Req req = new SendMessage.Req();
req.message = msg;
req.enterpriseId = "current enterprise ID";
api.sendReq(req);

// 分享网页链接
CXWebpageObject webpageObject = new CXWebpageObject();
webpageObject.webpageUrl = "web page";
CXMediaMessage msg = new CXMediaMessage(webpageObject);
msg.title = "title";
msg.description = "description";
msg.thumbData = null; //byte[];
SendMessage.Req req = new SendMessage.Req();
req.message = msg;
req.enterpriseId = "current enterprise ID";
api.sendReq(req);

//分享本地文件
CXFileObject cxFileObject = new CXFileObject();
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    cxFileObject.filePath = FileProvider.getUriForFile(this, getPackageName()+".fileProvider", file);
} else {
    cxFileObject.filePath = Uri.fromFile(file);
}
 
CXMediaMessage msg = new CXMediaMessage(cxFileObject);
msg.title = "文件分享";
msg.description = "文件描述";
msg.thumbData = Bitmap2Bytes(resource2Bitmap(R.drawable.ic_launcher)); //byte[] 缩略图;
SendMessage.Req req = new SendMessage.Req();
req.message = msg;
req.enterpriseId = enterpriseId;
api.sendReq(req);