浏览 SDKs · uni-app / uni-app x
SDKsuni-app

取消用户在线状态订阅

停止接收指定用户的在线状态变化。

复制

页面或业务不再关注一组用户时,调用 unsubscribeUsersStatus() 释放服务端状态订阅。

import { unsubscribeUsersStatus } from '@/uni_modules/unix-openim-sdk'

await unsubscribeUsersStatus(['user_a', 'user_b'])

该调用只取消传入用户,不会清空其他订阅,也不会自动释放本地 onUserStatusChanged 事件句柄。页面应同时维护两层生命周期:

  1. 用本 API取消不再需要的用户状态订阅。
  2. 在事件 owner 作用域结束时,通过 off(subscription) 清理本地事件处理器。

重复取消应按幂等业务处理;失败时保留本地订阅记录并根据网络状态决定是否重试,不要高频循环调用。