浏览 SDKs · iOS
平台
SDKsiOS

更新好友资料

更新 iOS 好友备注、置顶状态或扩展字段。

复制

更新指定好友的备注、置顶状态或扩展字段:

参数说明

参数类型说明
reqOIMUpdateFriendsReq *包含目标好友 ID 列表及待更新属性的请求对象。
字段类型说明
friendUserIDsNSArray<NSString *> *目标好友用户 ID 列表,修改将同步应用至列表中的所有好友。
remarkNSString *好友备注名。
isPinnedBOOL是否置顶好友。
exNSString *业务扩展字段,整串覆盖。
OIMUpdateFriendsReq *req = [OIMUpdateFriendsReq new];
req.friendUserIDs = @[@"user_b"];
req.remark = @"Alex";
req.isPinned = YES;

[[OIMManager manager] updateFriends:req
                          onSuccess:^(NSString *data) {
    [friendStore updateRemark:req.remark forUserID:@"user_b"];
}
                          onFailure:^(NSInteger code, NSString *message) {
    NSLog(@"updateFriends failed: %ld %@", (long)code, message);
}];

状态以 userID 为合并标识。ex 字段按完整字符串覆盖,更新前建议保留已有业务命名空间。

返回结果

成功回调 onSuccess 表示服务端已接收更新请求。多端同步及其他客户端的状态同步通过好友资料变更事件通知,完整事件处理见分页获取好友列表。