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

更新群资料

通过 setGroupInfo 更新群名、公告、介绍、头像和策略字段。

复制

群名称、群简介和群头像都属于面向成员展示的基础资料,可以由同一个资料编辑表单提交。setGroupInfo() 只更新本次提供的可选字段。

参数说明

参数类型是否必填说明
groupIDstring要更新的群组 ID。
groupNamestringnull新群名称。
introductionstringnull新群简介。
faceURLstringnull新群头像地址。

groupID 外,至少传入一个实际要修改的资料字段。未传字段保持原值。

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

await setGroupInfo({
  groupID,
  groupName: groupName.trim(),
  introduction: introduction.trim(),
  faceURL,
})

不要把公告、入群验证或成员权限字段混入普通资料保存操作,否则用户编辑群名称时可能意外覆盖其他设置。群主和管理员权限由服务端校验。

Promise 成功表示 OpenIMServer 已完成请求。群资料变化通过 onGroupInfoChangedgroupID 合并;完整监听见群组概览。需要立即校准时调用 getSpecifiedGroupsInfo(),不要直接覆盖未提交字段。

displayIsRead 商业版 是字段级扩展;公共服务端不支持时不要发送。