TIMSetKickedOfflineCallback
功能介绍
设置被踢下线通知回调
用户如果在其他终端登录,会被踢下线,这时会收到用户被踢下线的通知,出现这种情况常规的做法是提示用户进行操作(退出,或者再次把对方踢下线)。
用户如果在离线状态下被踢,下次登录将会失败,可以给用户一个非常强的提醒(登录错误码ERR_IMSDK_KICKED_BY_OTHERS:6208),开发者也可以选择忽略这次错误,再次登录即可。
用户在线情况下的互踢情况:
用户在设备1登录,保持在线状态下,该用户又在设备2登录,这时用户会在设备1上强制下线,收到 TIMKickedOfflineCallback 回调。
用户在设备1上收到回调后,提示用户,可继续调用login上线,强制设备2下线。这里是在线情况下互踢过程。
用户离线状态互踢:
用户在设备1登录,没有进行logout情况下进程退出。该用户在设备2登录,此时由于用户不在线,无法感知此事件,
为了显式提醒用户,避免无感知的互踢,用户在设备1重新登录时,会返回(ERR_IMSDK_KICKED_BY_OTHERS:6208)错误码,表明之前被踢,是否需要把对方踢下线。
如果需要,则再次调用login强制上线,设备2的登录的实例将会收到 TIMKickedOfflineCallback 回调。
参数详解
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
params | TIMSetKickedOfflineCallbackParam | 是 | 设置被踢下线通知回调的参数 |
返回模板
void
返回值详解
此函数无返回值
代码示例
import TimRender from "im_electron_sdk/dist/renderer";
const timRenderInstance = new TimRender();
import { TIMSetKickedOfflineCallbackParam } from "im_electron_sdk/dist/interfaces";
let param:TIMSetKickedOfflineCallbackParam={
userData: "", //必填
callback: (data) => {} //必填
};
timRenderInstance.TIMSetKickedOfflineCallback(param)