点对点消息
功能介绍
实现点对点的透明消息发送功能, 根据发送内容可选择:发送命令数据, 发送内存数据二种类型。
1.发送命令数据
此接口发送的数据不能被cancelSend,一次性发送,也不会有进度通知。
- 调用接口:
//发送小块数据,taskId为分配的任务ID
const taskId = sdk_engine.sendCmd(targetUserId, data);
- 回调通知:
//发送数据的结果通知
sdk_engine.on("sendCmdRslt", (taskId, sdkErr, cookie) => {
if(sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
console.log("发送失败,错误码:"+ sdkErr);
}
})
//收到远端命令数据
sdk_engine.on("notifyCmdData", (sourceUserId, data) => {
//sourceUserId发送者
//data数据内容
})
相关API请参考:
相关结构定义请参考:
2.发送内存数据
分块发送,进度通知事件notifySendProgress, 调用cancelSend取消发送。
- 调用接口:
//发送内存数据,taskId为分配的任务ID
const taskId = sdk_engine.sendBuffer(targetUserId, data);
- 回调通知:
//发送数据的结果通知
sdk_engine.on("sendBufferRslt", (taskId, sdkErr, cookie) => {
if(sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
console.log("发送失败,错误码:"+ sdkErr);
}
})
//收到远端数据
sdk_engine.on("notifyBufferData", (sourceUserId, data) => {
//sourceUserId发送者
//data数据内容
})
相关API请参考:
3.发送文件
分块发送,进度通知事件notifySendProgress, 调用cancelSend取消发送。
- 调用接口:
const taskId = sdk_engine.sendFile(targetUserId, locPathFileName);
- 回调通知:
//发送文件的结果通知
sdk_engine.on("sendFileRslt", (taskId, fileName, sdkErr, cookie) => {
if(sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
//发送失败,错误码:sdkErr;
} else {
//成功
}
})
//收到远端的文件通知
sdk_engine.on("notifyFileData", (sourceUserId, tmpFile, orgFileName) => {
//sourceUserId发送者
//tmpFile本地临时文件
//orgFileName原文件名(不带路径)
})
相关API请参考:
4.取消发送
- 调用接口:
//取消发送数据,taskId为要取消的任务ID
sdk_engine.cancelSend(taskId)
- 回调通知:
sdk_engine.on("cancelSendRslt", (taskId, sdkErr, cookie) => {
if(sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR){
//发送失败,错误码:sdkErr;
} else {
//取消成功
}
})
相关API请参考: