收发消息
接收消息
接收消息需要先设置消息回调,开发者可通过添加回调对象来接收消息。
- 调用接口:
// 接收消息前设置消息监听对象
//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请参考: