AddRecvNewMsgCallback

功能介绍

注册收到新消息回调

如果用户是登陆状态,ImSDK收到新消息会通过此接口设置的回调抛出,另外需要注意,抛出的消息不一定是未读的消息

只是本地曾经没有过的消息(例如在另外一个终端已读,拉取最近联系人消息时可以获取会话最后一条消息,如果本地没有,会通过此方法抛出

接收方调用 AddRecvNewMsgCallback 添加消息监听器。一般建议在比较靠前的时间点调用,例如例如聊天消息界面初始化后,确保能及时收到消息。

在用户登陆之后,ImSDK会拉取离线消息,为了不漏掉消息通知,需要在登陆之前注册新消息通知

接收方使用消息监听器接收消息,需要以下几步:

调用 AddRecvNewMsgCallback 设置事件监听器。

监听 RecvNewMsgCallback 回调,在其中接收文本消息。

希望停止接收消息,调用 RemoveRecvNewMsgCallback 移除监听。该步骤不是必须的,客户可以按照业务需求调用。

参数详解

参数名称 参数类型 是否必填 描述
callback RecvNewMsgCallback 回调 RecvNewMsgCallback
stringCallback RecvNewMsgStringCallback 回调 RecvNewMsgStringCallback

返回模板

TIMResult

调用成功后回调函数参数:
code:int
desc:string
json_param:'' // json_params为空字符串""
user_data:string

返回值详解

名称 数值类型 描述
TIMResult TIMResult 调用接口的返回值
code int 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码
desc string 错误描述字符串
json_param string Json字符串,不同的接口,Json字符串不一样
user_data string ImSDK负责透传的用户自定义数据,未做任何处理

results matching ""

    No results matching ""