音视频通话

房间外点对点消息

功能介绍

实现点对点的透明消息发送功能, 根据发送内容可选择:发送命令数据, 发送内存数据, 发送文件三种类型。

1.发送命令数据

此接口发送的数据不能被cancelSend,一次性发送,也不会有进度通知。

  • 调用接口:
CRString msg = R"({ "CmdType":"IM", "IMMsg":"xxx"})";
CRString sendId = g_sdkMain->sendCmd(targetUserId, msg, "");
  • 回调通知:
//发送命令数据的结果通知
virtual void sendCmdRlst(const char* sendId, CRVSDK_ERR_DEF sdkErr, const char* cookie)
{
	if(sdkErr != CRVSDKERR_NOERR)
	{
		//发送失败,错误码:sdkErr;
	}
	else
	{
		//成功
	}
}

//收到远端命令数据
virtual void notifyCmdData(const char* sourceUserId, const CRBase::CRString& data)
{
	//sourceUserId发送者
	//data数据内容
}

相关API请参考:

2.发送内存数据

分块发送,进度通知事件notifySendProgress, 完成前可调用cancelSend取消发送。

  • 调用接口:
CRByteArray dat = xxx;
CRString sendId = g_sdkMain->sendBuffer(targetUserId, dat);
  • 回调通知:

//发送结果
virtual void sendBufferRlst(const char* sendId, CRVSDK_ERR_DEF sdkErr, const char* cookie)
{
	if(sdkErr != CRVSDKERR_NOERR)
	{
		//发送失败,错误码:sdkErr;
	}
	else
	{
		//成功
	}
}

//收到远端数据
virtual void notifyBufferData(const char* sourceUserId, const CRBase::CRByteArray& data)
{
	//sourceUserId发送者
	//data数据内容
}

相关API请参考:

3.发送文件

分块发送,进度通知事件notifySendProgress, 完成前可调用cancelSend取消发送。

  • 调用接口:
CRString sendId = g_sdkMain->sendFile(targetUserId, locPathFileName);
  • 回调通知:
//发送文件的结果通知
virtual void sendFileRlst(const char* sendId, const char* fileName, CRVSDK_ERR_DEF sdkErr, const char* cookie)
{
	if(sdkErr != CRVSDKERR_NOERR)
	{
		//发送失败,错误码:sdkErr;
	}
	else
	{
		//成功
	}
}

//收到远端的文件通知
virtual void notifyFileData(const char* sourceUserId, const char* tmpFile, const char* orgFileName)
{
	//sourceUserId发送者
	//tmpFile本地临时文件
	//orgFileName原文件名(不带路径)
}

相关API请参考:

4.取消发送

  • 调用接口:
//取消发送,sendId为要取消的任务ID
cancelSend(sendId);
  • 回调通知:
virtual void cancelSendRlst(const char* sendId, CRVSDK_ERR_DEF sdkErr, const char* cookie)
{
	//取消成功或者失败处理
}

相关API请参考: