房间外点对点消息
功能介绍
实现点对点的透明消息发送功能, 根据发送内容可选择:发送命令数据, 发送内存数据, 发送文件三种类型。
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请参考:
- CRVideo_SendFile
- CRVideo_SendFileRslt
- CRVideo_SendProgress
- CRVideo_NotifyFileData
- CRVideo_CancelSend
4.取消发送
- 调用接口:
//取消发送,taskID 为要取消的任务ID
CRVideo_CancelSend(taskID, "");
- 回调通知:
CRVideo_CancelSendRslt.callback = function(taskID, sdkErr, cookie){
//取消成功或者失败处理
}
相关API请参考: