设置群消息强制提醒

开发者中心

IM 即时通讯

集成开发

设置群消息强制提醒

更新时间： 2024/03/07 13:22:34

云信 NIM SDK 支持对于群消息的强制提醒功能。

当发送方设置了该群消息的强制提醒，群消息接收者即使屏蔽了当前会话（如设置免打扰），仍能接收到该条消息提醒。

通过消息体的指定成员选项字段 memberPushOption 来实现。

NIMMemberPushOption 接口说明：

参数	类型	说明
isForcePush	Boolean	是否强制提醒（仅针对 `forcePushList` 中的账户），true 为强制提醒（默认），false 为不强制提醒
forcePushList	List	需要强制提醒的成员列表如果填 null，表示强制提醒给该会话的所有成员，不为 null 时，最多可传入 100 个用户账号
forcePushContent	String	强制提醒的文案，最大长度 500 字符，如果设置为 nil，则使用消息本身的推送文案（`pushContent`）

对于 forcePushList 中的用户，提醒文案使用 NIMMessage#forcePushContent.pushContent；对于不在 forcePushList 中的用户，使用推送文案NIMMessage#pushContent。
forcePushList 中的账户的提醒文案又分两种情况：
- 当 isForcePush 为 YES 时，提醒文案中不会包含发送者前缀（nick），直接为 forcePushContent。
- 当 isForcePush 为 NO 时，提醒文案中目前包含了发送者的前缀（nick），即为 fromNick：forcePushContent。

示例代码如下：

void sendForcePushMessage() async {
    NIMMessage message = (await MessageBuilder.createTextMessage(
      sessionId: 'your teamId',
      sessionType: NIMSessionType.team,
      text: '指定推送消息',
    )).data!;
    final memberPushOption = NIMMemberPushOption(
        isForcePush: true,
        forcePushContent: message.content,
        forcePushList: ['account1', 'account2']
    );
    message.memberPushOption = memberPushOption;
    NimCore.instance.messageService.sendMessage(
        message: message
    );
  }

此文档是否对你有帮助？

有帮助

去反馈