SDKsuni-app / uni-app x

查询指定好友资料

按用户 ID 批量查询指定好友的关系资料。

查询指定好友资料接口只查询已经建立好友关系的用户。userIDList 是要查询的用户 ID 数组；filterBlack 决定是否从结果中过滤已被当前账号加入黑名单的用户。

参数说明

参数	类型	是否必填	说明
`userIDList`	`string[]`	是	要查询的好友用户 ID 数组。
`filterBlack`	`boolean`	否	是否在查询结果中过滤已被加入黑名单的用户。

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

const result = await getSpecifiedFriendsInfo({
  userIDList: ['user_a', 'user_b'],
  filterBlack: true,
})
const friends = result?.friends ?? []

Promise 成功后返回 OpenIMFriendListResult | null，好友数组位于 friends。返回项不保证与输入 ID 按位置一一对应，应使用 userID 将资料对应到请求用户；完整字段见分页获取好友列表。

查询陌生人的公开账号资料时，应使用获取用户资料。该方法只返回调用时的数据，不会触发好友事件。

这个页面有帮助吗？