群消息管理

更新时间: 2024/03/14 18:45:32

网易云信 NIM SDK 支持群组中的消息收发,群组相关操作的通知消息的接收,以及群消息通知模式的设置。

群消息收发

群组中支持收发多种消息类型。

在创建/加入群组后,用户发送和接收消息的接口与单聊消息收发相同,区别在于会话类型(scene)的参数配置,选择 team 即可。

scene 参数说明

枚举常量 说明
p2p 单聊,点对点
superTeam 超大群
team 群聊

具体消息收发的流程,请参见消息收发

群组通知消息

NIM SDK 内置支持的会话消息类型中的通知消息(notification)主要用于群组和超大群的事件通知,由服务端下发,客户端无法发送事件通知消息。

群组通知消息对应的消息对象中的 attach 字段中通过 type 来标识群通知消息的类型,具体请参见群通知消息类型

设置群消息免打扰

SDK 支持对群消息通知提醒模式的配置。

通过调用 updateInfoInTeam 来修改指定群组的群消息提醒模式。

群消息提醒模式对应的参数如下:

  • muteTeam: 是否关闭此群组的消息提醒。true 表示关闭提醒;false 表示不关闭。SDK 仍会收到此群的消息, SDK 只是记录这个设置。

Web 端群消息提醒行为不会根据设置的群消息通知的值改变,具体开关群消息提醒的代码需要用户根据自己的使用场景和业务逻辑进行设计增加。

  • muteNotiType:群消息提醒策略。0:开启提醒;1:关闭消息提醒;2:只接受管理员的消息的提醒。

群消息的提醒模式不影响群消息的接收和未读数的变化。若将提醒模式设置为全部不提醒,仍然能接收到群消息接收,未读数仍会变化。

示例代码:

nim.updateInfoInTeam({
    teamId: '123',
    // 此参数为可选参数
    // nickInTeam: '群昵称',
    // 静音群, 此参数为可选参数
    // muteTeam: true,
    // 第三方扩展字段
    // custom: '{}'
    done: updateInfoInTeamDone
});
function updateInfoInTeamDone(error, obj) {
    console.log('免打扰' + (!error?'成功':'失败'), error, obj);
}

群消息已读回执

群聊消息已读回执相关内容请参考群消息已读回执

API 参考

API
说明
updateInfoInTeam 设置指定群组的群消息提醒模式
sendTeamMsgReceipt (群消息接收方)标记群组消息已读
getTeamMsgReads 查询群组消息已读、未读数量
getTeamMsgReadAccounts 查询群组消息未读账号列表
此文档是否对你有帮助?
有帮助
去反馈
  • 群消息收发
  • 群组通知消息
  • 设置群消息免打扰
  • 群消息已读回执
  • API 参考