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

申请加入群组

向指定群发送加入申请。

复制

joinGroup() 提交入群申请。

参数说明

参数类型是否必填说明
groupIDstring要申请加入的群 ID。
reqMsgstring申请说明,可能向群主或管理员展示。
joinSourcenumber入群来源值,使用产品与服务端约定。
exstringnull申请扩展字符串,只按已确认协议填写。
import { joinGroup } from '@/uni_modules/unix-openim-sdk'

await joinGroup({
  groupID,
  reqMsg: '申请加入项目群',
  joinSource: 2,
  ex: '',
})

申请文案和 ex 可能进入申请记录,不包含 Token、内部风控信息或不必要的个人数据。提交前确认群存在,且当前用户尚未加入。

Promise 成功不等于已入群:免验证群可能直接加入,需要验证时等待管理员处理。通过申请事件、onJoinedGroupAdded 或重新查询群列表判断最终结果,不在本地先行创建群成员状态。