跳到主要内容

修改用户信息

融云服务端不提供用户信息托管维护服务。如果应用程序需要修改在 IMKit SDK UI 显示的用户及群组的头像、昵称等信息，必须主动调用 IMKit 提供的方法更新信息。

本文详细描述了如何修改 IMKit SDK 设置的用户、群组的头像、昵称等信息。

更新当前登录用户昵称和头像​

updateUserProfile 用于更新用户的昵称、头像。支持异步返回用户信息对象。

const info = {
  id: '当前用户 id', // 可在 connect 连接成功后获取
  name: '用户名称',
  portraitUri: '用户头像 URL'
}
imkit.updateUserProfile(info)

info 参数说明

参数类型必填说明
idstring是用户 UserId
namestring是用户昵称
portraitUristring否用户头像 URI

更新当前页面会话的信息​

提示

仅支持修改当前页面上会话的信息。修改当前页面不存在或未加载的会话则更新无效。当前没有选中会话则仅修改内存态对应会话信息。

updateConversationProfile 用于修改当前页面中会话的昵称、头像、群成员数量，适用于单聊会话、群聊会话。注意，群成员数量（memberCount）仅在群组会话时生效。

const conversation = {
  // 会话类型，单聊为:PRIVATE，群聊为:GROUP，可从 conversation 中获取
  conversationType: ConversationType.PRIVATE,
  // 群聊为群组 Id，单聊为 userId，可从 conversation 中获取
  targetId: '目标 Id'
}

const info = {
  conversationType: 1,
  targetId: '目标 Id', // 群组为群组 Id,单聊为 userId
  name: '用户名称',
  portraitUri: '用户头像 URL'
}
imkit.updateConversationProfile(conversation, info)

conversation 属性说明

名称参数必传说明
conversationTypestring是会话类型
targetIdstring是目标 Id

info 参数说明

参数类型必填说明
conversationTypeConversationType是会话类型，可在参数 conversation 中获取。
targetIdstring是目标 ID，可在参数 conversation 中获取。
namestring否会话昵称
portraitUristring否会话头像 URI
memberCountnumber否群成员数量，此属性仅对群组有效。

修改全部群成员信息​

updateGroupMembers 用于修改群聊会话的全部群组成员的昵称、头像。仅支持全量修改群组信息。

  • 如果已选中待修改的群聊会话，修改当前选中的群聊会话的成员信息，SDK 会刷新页面，显示修改后的数据。
  • 如果修改时没有任何群聊会话被选中，则修改群聊会话成员信息不会触发页面刷新。修改后的数据会保存在内存中，只要内存数据未丢失，后续切换到该会话时不需要再次修改，页面直接展示最新数据。

updateGroupMembers 仅支持全量修改群组成员信息，调用必须传递全部群成员信息。如果仅需修改部分数据，调用时也必须传递全部群成员信息。假设群组中有 groupMemberUserId1 和 groupMemberUserId2 两位用户：

import { ConversationType } from '@rongcloud/imlib-next'
const conversation = {
  // 会话类型，群聊为:GROUP，可从 conversation 中获取
  conversationType: ConversationType.GROUP,
  // 群聊为群组 Id，单聊为 userId，可从 conversation 中获取
  targetId: '目标 Id'
}

const info = [{
    id: 'groupMemberUserId1',
    name: '成员昵称',
    portraitUri: '成员头像',
  },
   {
    id: 'groupMemberUserId2',
    name: '成员昵称',
    portraitUri: '成员头像',
   }
]
imkit.updateGroupMembers(conversation, info)

参数说明

参数类型必填说明
conversationObject是会话信息
infoArray是全量群成员信息

  • info 属性说明

    参数类型必填说明
    idstring是群成员 UserId
    namestring否群成员昵称
    portraitUristring否群成员头像 URI

  • conversation 属性说明

    名称参数必传说明
    conversationTypestring是会话类型
    targetIdstring是目标 ID
最后于 更新