getSpecifiedFriendsInfo

功能介绍

说明

获取指定好友的昵称、头像、备注，此函数从 APP 本地获取，建议一次最大10000个。

iOS

函数原型

    Future<List<FullUserInfo>> getFriendsInfo({
        required List<String> userIDList,
        String? operationID,
    })

输入参数

参数名称	参数类型	是否必填	描述
userIDList	List<String>	是	用户 ID 列表

返回结果

参数名称	参数类型	描述
~	List< FullUserInfo >	成功返回

代码示例

     List<FullUserInfo> list = await OpenIM.iMManager.friendshipManager.getFriendsInfo(userIDList: []);
     // todo

Android

函数原型

- (void)getSpecifiedFriendsInfo:(NSArray <NSString *> *)usersID
                       onSuccess:(nullable OIMFullUsersInfoCallback)onSuccess
                       onFailure:(nullable OIMFailureCallback)onFailure;

输入参数

参数名称	参数类型	是否必填	描述
usersID	NSArray <NSString *>	是	用户 ID 列表

返回结果

参数名称	参数类型	描述
onSuccess	NSArray< OIMFullUserInfo * >	成功返回
onFailure	OIMFailureCallback	失败返回

代码示例

[OIMManager.manager getSpecifiedFriendsInfo:@[]
                                  onSuccess:^(NSArray<OIMFullUserInfo *> * _Nullable userInfos) {
} onFailure:^(NSInteger code, NSString * _Nullable msg) {
}];

Flutter

函数原型

    public void getFriendsInfo(OnBase<List<UserInfo>> base, List<String> uidList)

输入参数

参数名称	参数类型	是否必填	描述
callBack	OnBase<List<UserInfo>>	是	回调接口
uidList	List<String>	是	用户 ID 集合

代码示例

    OpenIMClient.getInstance().friendshipManager.getFriendsInfo(new OnBase<List<UserInfo>>() {
              @Override
              public void onError(int code, String error) {

              }

              @Override
              public void onSuccess(List<UserInfo> data) {

              }
          },uidList);

uni-app

函数原型

IMSDK.getDesignatedFriendsInfo(userIDList: string[], operationID?: string): Promise<WsResponse<FullUserItem[]>>

输入参数

参数名称	参数类型	是否必填	描述
userIDList	string[]	是	用户 ID 列表

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<WsResponse<FullUserItem[]>>	好友信息列表
Promise.catch()	Promise<WsResponse>	调用失败回调

代码示例

import { getSDK } from 'open-im-sdk-wasm';
const IMSDK = getSDK();

// use in electron with ffi
// import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';
// const { instance: IMSDK } = getWithRenderProcess();

// use in mini program
// import { OpenIMSDK } from 'open-im-sdk';
// const IMSDK = new OpenIMSDK();

const userIDList = ['userID1', 'userID2'];
IMSDK.getDesignatedFriendsInfo(userIDList)
  .then(({ data }) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi('getDesignatedFriendsInfo', operationID: string, userIDList: string[]): Promise<FullUserItem[]>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
userIDList	string[]	是	用户 ID 列表

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<FullUserItem[]>	好友信息列表
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import IMSDK from 'openim-uniapp-polyfill';

const userIDList = ['userID1', 'userID2'];
IMSDK.asyncApi('getDesignatedFriendsInfo', IMSDK.uuid(), userIDList)
  .then((data) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

React-Native

函数原型

OpenIMSDKRN.getSpecifiedFriendsInfo(userIDList: string[], operationID: string): Promise<FriendUserItem[]>

输入参数

参数名称	参数类型	是否必填	描述
userIDList	string[]	是	用户 ID 列表
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<FriendUserItem[]>	好友信息列表
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import OpenIMSDKRN from "open-im-sdk-rn";

const userIDList = ['userID1', 'userID2'];
OpenIMSDKRN.getSpecifiedFriendsInfo(userIDList, 'operationID')
  .then((data) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Unity

函数原型

public static void GetSpecifiedFriendsInfo(OnFullUserInfoList cb, string[] userIDList)

输入参数

参数名称	参数类型	是否必填	描述
cb	OnFullUserInfoList	是	回调接口
userIDList	string[]	是	用户 ID 集合

代码示例

IMSDK.GetSpecifiedFriendsInfo((list,errCode,errMsg)=>{

},{"userid"});