浏览 SDKs · uni-app / uni-app x
SDKsuni-app

获取当前用户资料

查询当前已登录用户的 OpenIM 资料快照。

复制

完成初始化、登录并确认连接可用后,调用 getSelfUserInfo() 查询当前账号资料:

import {
  getSelfUserInfo,
  type OpenIMUserInfo,
} from '@/uni_modules/unix-openim-sdk'

const currentUser : OpenIMUserInfo | null = await getSelfUserInfo()
if (currentUser != null) {
  renderProfile(currentUser.nickname, currentUser.faceURL)
}

返回结果

Promise 成功后直接返回 OpenIMUserInfo | null,没有 { data } 包装。非空对象字段如下:

字段类型说明
userIDstring当前登录用户的 OpenIMSDK 用户 ID,也是资料快照的稳定标识。
nicknamestring账号级昵称。
faceURLstring账号级头像地址。
createTimenumbernull(可选)用户记录创建时间。
globalRecvMsgOpt 商业版numbernull(可选)当前账号的全局消息接收方式;常量和语义见设置全局消息接收方式
attachedInfo 商业版stringnull(可选)SDK 附加信息;只按已确认的业务约定解析。
exstring由业务约定的账号级扩展字符串。

以返回的 userID 校验应用账号与 SDK 当前账号是否一致。null 不应被伪造成空用户对象;应结合登录状态和错误日志判断当前是否没有可用快照。

该查询只建立当前资料快照,不触发资料事件。切换账号时必须清理旧快照;资料更新后的 onSelfInfoUpdated 合并和重新查询方式见更新当前用户资料