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负责透传的用户自定义数据,未做任何处理 |