音视频通话

房间外点对点消息

功能介绍

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

1.发送命令数据

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

  • 调用接口:
var msg = '{"CmdType":"IM", "IMMsg":"xxx"}';
var taskId = CRVideo_SendCmd(targetUserId, msg, "");
  • 回调通知:
//发送命令数据的结果通知
CRVideo_SendCmdRslt.callback = function(taskID, sdkErr, cookie){
	if(sdkErr != 0){
		//发送失败,错误码:sdkErr;
	}
	else{
		//成功
	}
}

//收到远端命令数据
CRVideo_NotifyCmdData.callback = function(sourceUserId, data){
	//sourceUserId 发送者
	//data 数据内容
}

相关API请参考:

2.发送内存数据

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

  • 调用接口:
var data = xxx;
var taskId = CRVideo_SendBuffer(targetUserId, data, "");
  • 回调通知:
//发送结果
CRVideo_SendBufferRslt.callback = function(taskID, sdkErr, cookie){
	if(sdkErr != 0){
		//发送失败,错误码:sdkErr;
	}
	else{
		//成功
	}
}

//收到远端数据
CRVideo_NotifyBufferData.callback = function(sourceUserId, data){
	//sourceUserId 发送者
	//data 数据内容
}

相关API请参考:

3.发送文件

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

  • 调用接口:
var taskId = CRVideo_SendFile(targetUserId, file, "");
  • 回调通知:
//发送文件的结果通知
CRVideo_SendFileRslt.callback = function(taskID, sdkErr, cookie){
	if(sdkErr != 0){
		//发送失败,错误码:sdkErr;
	}
	else{
		//成功
	}
}

//收到远端的文件通知
CRVideo_NotifyFileData.callback = function(sourceUserId, fileBuffer, fileName){
	//sourceUserId 发送者
	//fileBuffer 收到的文件数据(ArrayBuffer)
	//fileName 原文件名
}

相关API请参考:

4.取消发送

  • 调用接口:
//取消发送,taskID 为要取消的任务ID
CRVideo_CancelSend(taskID, "");
  • 回调通知:
CRVideo_CancelSendRslt.callback = function(taskID, sdkErr, cookie){
	//取消成功或者失败处理
}

相关API请参考: