浏览 SDKs · iOS
平台
SDKsiOS

取消用户状态订阅

使用 iOS SDK 取消用户在线状态订阅。

复制

当用户离开可见区域、页面退出或切换账号时,调用取消在线状态订阅接口:

参数说明

参数类型说明
userIDsNSArray<NSString *> *待取消订阅的用户 ID 列表。
[[OIMManager manager] unsubscribeUsersStatus:userIDs
                                   onSuccess:^(NSString *data) {
    [presenceStore removeUserIDs:userIDs];
}
                                   onFailure:^(NSInteger code, NSString *message) {
    NSLog(@"unsubscribeUsersStatus failed: %ld %@", (long)code, message);
}];

状态以 userID 为合并标识。注意取消特定用户的状态订阅与注销整个状态 Delegate 监听是两个不同维度的操作。

返回结果

成功回调 onSuccess 表示服务端已移除指定用户的在线状态订阅,后续不再向当前客户端下发这些用户的在线状态变化通知。重新订阅可参阅订阅用户在线状态。