SubscribeUserStatus
功能介绍
订阅用户状态
当成功订阅用户状态后,当对方的状态(包含在线状态、自定义状态)发生变更后,您可以监听 UserStatusChangedCallback 回调来感知
如果您需要订阅好友列表的状态,您只需要在控制台上打开开关即可,无需调用该接口
该接口不支持订阅自己,您可以通过监听 UserStatusChangedCallback 回调来感知自身的自定义状态的变更
订阅列表有个数限制,超过限制后,会自动淘汰最先订阅的用户
该功能为 IM 旗舰版功能,购买旗舰版套餐包后可使用,详见价格说明。
参数详解
重载1
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
json_identifier_array | List< string > | 是 | 待订阅的用户 ID |
callback | NullValueCallback | 是 | 异步回调 |
重载2
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
json_identifier_array | List< string > | 是 | 待订阅的用户 ID |
callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
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负责透传的用户自定义数据,未做任何处理 |