IM即时通讯

收发消息

接收消息

接收消息需要先设置消息回调监听对象,开发者可通过添加消息监听对象来接收消息,所有的IM消息都通过该通知接收,这里我们只举例接收新消息接口onRecvNewMsg,更多通知函数请参考OnAdvanceMsgListener

  • 调用接口:
// 接收消息前设置消息监听对象

CRIMClient.getInstance().messageManager.setAdvancedMsgListener(new OnAdvanceMsgListener() {
	@Override
	public void onRecvNewMsg(Message msg) {
		
	}

	@Override
	public void onRecv1v1ReadReceipt(List<ReadReceiptInfo> list) {

	}

	@Override
	public void onRecvGrpReadReceipt(List<ReadReceiptInfo> list) {

	}

	@Override
	public void onRecvMsgRevokedV2(RevokedInfo info) {

	}

	@Override
	public void onRecvMsgExtensionsChanged(String msgID, List<KeyValue> list) {

	}

	@Override
	public void onRecvMsgExtensionsDeleted(String msgID, List<String> list) {

	}

	@Override
	public void onRecvMsgExtensionsAdded(String msgID, List<KeyValue> list) {

	}

	@Override
	public void onMsgDeleted(Message message) {

	}

	@Override
	public void onRecvOfflineNewMessage(List<Message> msg) {

	}
});
  • 回调接口:
// 收到新消息
- void onRecvNewMessage(Message msg);

相关API请参考:

发送消息

创建文本消息

  • 调用接口:
CRIMClient.getInstance().messageManager.createTextMsg(“text”)

相关API请参考:

发送消息需要先构造消息实例,支持构造的消息类型有普通文本、图片、视频、文件、音频、地理位置、引用、转发、@xxx等消息,构造完消息后调用SDK的发送接口即可完成消息的发送

创建多媒体消息

多媒体消息支持的媒体类型包括图片、视频、语音、文件。
我们提供了两种方式发送多媒体消息,一种是SDK上传文件,一种是发送方自行上传,这里我们以图片消息为例分别说明。

SDK上传文件

发送方调用发送消息接口后,SDK内部会负责把文件上传到IM系统OSS存放,接收方收到消息后自行下载。
  • 调用接口:
CRIMClient.getInstance().messageManager.createImageMsgFromFullPath("xxx/imagePath/xxx")

发送方自行上传

发送方可以调用uploadFile接口把文件上传到IM系统OSS,也可以自己把文件上传到第三方存储,创建消息时把文件的下载URL传给SDK,接收方收到消息后用URL自行下载。
  • 调用接口:
PictureInfo sourcePicture = new PictureInfo();
sourcePicture.size = 512;
sourcePicture.width = 320;
sourcePicture.height = 320;
sourcePicture.url = "https://xxxxxxxxxxxx";

PictureInfo bigPicture = new PictureInfo();
bigPicture.size = 512;
bigPicture.width = 320;
bigPicture.height = 320;
bigPicture.url = "https://xxxxxxxxxxxx";

PictureInfo snapshotPicture = new PictureInfo();
snapshotPicture.size = 512;
snapshotPicture.width = 320;
snapshotPicture.height = 320;
snapshotPicture.url = "https://xxxxxxxxxxxx";

CRIMClient.getInstance().messageManager.createImageMsgByURL(sourcePicture, bigPicture, snapshotPicture) 

相关API请参考:

创建位置消息

创建位置消息需要开发者采集到经纬度参数

  • 调用接口:
CRIMClient.getInstance().messageManager.createLocationMsg(longitude, latitude, description)

相关API请参考:

创建自定义消息

创建自定义消息的消息内容需要使用json字符串

  • 调用接口:
CRIMClient.getInstance().messageManager.Message createCustomMsg("data" , "extension") 

相关API请参考:

发送消息

用于所有IM消息的发送

  • 调用接口:
Message message = CRIMClient.getInstance().messageManager.createCardMsg(cardElem);
        OfflinePushInfo offlinePushInfo = new OfflinePushInfo(); // 离线推送的消息备注;不为null
        CRIMClient.getInstance().messageManager.sendMsg(new OnMsgSendCallback() {
            @Override
            public void onError(int code, String error) {
                toast(error + code);
            }

            @Override
            public void onProgress(long progress) {
            }

            @Override
            public void onSuccess(Message message) {
            }
        }, message, getUserID(), null, offlinePushInfo,isOnlineOnly);

相关API请参考: