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