IM即时通讯

实现单聊消息发送

开发工具

以下以Qt Creator 4.0.3+, Qt 5.6.3+ 为例进行说明

集成SDK

  1. 访问 SDK下载中心 将 IM Windows SDK 下载到本地,解压后将 include 目录和 libs 目录复制到自已的项目目录下。

创建并初始化SDK

创建并初始化是整个SDK的使用基础,通常在登录的时候进行创建及初始化

	CRIMSDK::CRIMManager* imsdk = new CRIMSDK::CRIMManager();

    QVariantMap varMap;
    varMap["platformID"] = CRIM_WIN; //windows
	varMap["sdkServer"] = "http://192.168.0.25:2727";  //
    varMap["dataDir"] = "d:\\CRIMSDKTestDemo\\帐号id\\db\\";
    varMap["logFilePath"] = "d:\\CRIMSDKTestDemo\\帐号id\\log\\";
    varMap["logLevel"] = CRIM_DEBUGLEVEL;
	QByteArray byStr = QJsonDocument::fromVariant(variant).toJson(QJsonDocument::Compact);
	bool bSuccess = imsdk->initSDK(byStr.constData());
	if( !bSuccess )
	{
		//初始化失败
	}
	else
	{
		//初始化成功, 注册消息回调
		//CRIMCallbacker* pCallBack;
		imsdk->addCallBack(pCallBack);
	}

相关API请参考:

登录SDK

从自身业务服务器获取到userID、IM SDK APPID、IM SDK AppSecret, 然后进行登录:

//登录处理:
string appID = "";
string appSecret = "";
string userID = "";
imsdk->loginWithAppID(userID.c_str(), appID.c_str(), appSecret.c_str());
//登录成功回调
virtual void CRIMCallbacker::loginSuccess(const char *data, const char *cookie)
{
}
//登录失败回调
virtual void CRIMCallbacker::loginFailure(int errCode, const char *errMsg, const char *cookie)
{
}

相关API请参考:

实现单聊消息发送


//发送文本消息
CRIMString str = imsdk->createTextMsg("Text!");
string recvUserID = "xxx";
imsdk->sendMsg(str.constData(), recvUserID.c_str(), "", "");

//消息发送成功回调
void CRIMCallbacker::sendMsgSuccess(const char *data, const char *cookie)
{
}
//消息发送失败回调
void CRIMCallbacker::sendMsgFailure(int errCode, const char *errMsg, const char *cookie)
{
}

相关API请参考:

实现单聊消息接收


//收到新消息
void CRIMCallbacker::notifyRecvNewMsgs(const char *data)
{
}

//新的会话(如果会话已存在则无此回调,参见notifyConversationChanged)
void CRIMCallbacker::notifyNewConversation(const char *data)
{
}

//会话信息改变(如果新的会话则无此回调,参见notifyNewConversation)
void CRIMCallbacker::notifyConversationChanged(const char *data)
{
	//会话中有对应的未读计数等信息
}

//所有会话的未读记数改变
void CRIMCallbacker::notifyTotalUnreadMsgCountChanged(int num)
{
}

相关API请参考: