SDKsiOS

Retrieve specified group-member profiles

Retrieve group-member profiles for specified users with OpenIM iOS SDK.

Invoke getSpecifiedGroupMembersInfo:usersID:onSuccess:onFailure: to query profile snapshots for specified group members in a batch:

Parameters

Parameter	Type	Required	Description
`groupID`	`NSString *`	Yes	Target group ID.
`usersID`	`NSArray<NSString > `	Yes	List of member user IDs to retrieve.

Code example

[[OIMManager manager] getSpecifiedGroupMembersInfo:@"group_1001"
                                           usersID:@[@"user_001", @"user_002"]
                                         onSuccess:^(NSArray<OIMGroupMemberInfo *> *members) {
                                             [self mergeMembers:members];
                                         }
                                         onFailure:^(NSInteger code, NSString *message) {
                                             NSLog(@"getSpecifiedGroupMembersInfo failed: %ld %@", (long)code, message);
                                         }];

Return value

The onSuccess callback delivers an array of matched OIMGroupMemberInfo objects (NSArray<OIMGroupMemberInfo *> *). Any user IDs not currently in the group are excluded from the result list.

State changes after the call

Snapshot query: This method queries an instantaneous profile snapshot without triggering delegate callbacks.
Local cache merge: Merge member records using the composite key groupID:userID.
Event notification: Incremental changes to nicknames, roles, or muting arrive via listener callbacks. For listener setup, refer to Group member queries overview.

Was this page helpful?