IM即时通讯

收发消息

接收消息

接收消息需要先设置消息回调,开发者可通过添加回调对象来接收消息。

  • 调用接口:
// 接收消息前设置消息监听对象
//CRIMCallbacker* pCallBack;
imsdk->addCallBack(pCallBack);
  • 回调接口:
// 收到新消息
void CRIMCallbacker::notifyRecvNewMsgs(const char *data)
{
}

相关API请参考:

发送消息

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

发送文本消息

  • 调用接口:
//创建文本消息
CRIMString str = imsdk->createTextMsg(“Text!”);
//发送消息
string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

相关API请参考:

创建多媒体消息

多媒体消息支持的媒体类型包括图片、视频、语音、文件。

我们提供了两种方式发送多媒体消息: 一种是SDK上传文件,一种是发送方自行上传。

下面我们以图片消息为例分别说明:

SDK上传文件

发送方调用发送消息接口后,SDK内部会负责把文件上传到IM系统OSS存放,接收方收到消息后自行下载。

  • 调用接口:
//创建图片消息
CRIMString str = imsdk->createImageMsgFromFullPath("d:\\test\\test.jpg");

//发送消息
string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

发送方自行上传

发送方可以调用uploadFile接口把文件上传到IM系统OSS,也可以自己把文件上传到第三方存储,创建消息时把文件的下载URL传给SDK,接收方收到消息后用URL自行下载。

  • 调用接口:

QVariantMap picInfo;
picInfo["type"] = "jpg";

picInfo["size"] = 96200; //Byte
picInfo["width"] = 1280;
picInfo["height"] = 720;
picInfo["url"] = "https://xxxxxxxxxxxx";
QByteArray sourcePicInfo = QJsonDocument::fromVariant(picInfo).toJson(QJsonDocument::Compact);

picInfo["size"] = 2996; //Byte
picInfo["width"] = 160;
picInfo["height"] = 90;
picInfo["url"] = "https://yyyyyyyyyyyy";
QByteArray snapshotPicInfo = QJsonDocument::fromVariant(picInfo).toJson(QJsonDocument::Compact);

//创建图片消息
CRIMString str = imsdk->createImageMsgByURL("", sourcePicInfo.c_str(), "", snapshotPicInfo.c_str());

//发送消息
string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

相关API请参考:

创建位置消息

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

  • 调用接口:
//创建消息
CRIMString str = imsdk->createLocationMsg("位置描述", latitude, longitude);

//发送消息
string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

相关API请参考:

创建自定义消息

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

  • 调用接口:
std::string strDat = "{\"meetingID\":123456, \"Owner\":\"michael\"}";
std::string strDesc = "michael的会议";
CRIMString str = imsdk->createCustomMsg(strDat.c_str(), "", strDesc.c_str());

string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

相关API请参考: