容易混淆的概念

通知类消息

属于会话中的一种消息,其对应的数据结构为 IMMessage,消息类型为 MsgTypeEnum.notification,有在线、离线、漫游。继承 NotificationAttachment,目前用于(已操作完成的)群通知事件,不计入消息未读数。包含 MemberChangeAttachment , UpdateTeamAttachment , LeaveTeamAttachment 和 DismissAttachment 。没有通知栏提醒(如有需要,第三方自行实现)。

一般位于聊天界面的中间。例如,群名称更新,某某某退出了群聊等。

自定义消息

属于会话中的一种消息,其对应的数据结构为 IMMessage,消息类型为 MsgTypeEnum.custom,主要提供给第三方开发者定制消息使用,有在线、离线、漫游、通知栏提醒(文案需要自行定制)。主要是通过 IMMessage的 setAttachment 来实现。

一般与普通文本,语音消息相同,位于聊天界面的左右两侧。例如,猜拳、贴图、阅后即焚均可以采用自定义消息来实现。

Tip消息

属于会话中的一种消息,其对应的数据结构为 IMMessage,消息类型为 MsgTypeEnum.tip,是自定义消息的简化,有在线、离线、漫游、通知栏提醒(文案需要自行定制),但是区别于自定义消息,Tip 消息不支持 setAttachment。

一般用于自定义的通知提醒,位于聊天界面的中间,例如进入会话时出现的欢迎消息,或是会话过程中命中敏感词后的提示消息等场景,当然也可以用自定义消息实现,只是相对复杂一些。

系统通知

属于网易云通信内建的系统通知,其对应的数据结构为 SystemMessage, 由网易云通信服务器推送给用户的通知类消息,用于网易云通信系统类的事件通知。现在主要包括群变动的相关通知,例如入群申请,入群邀请等,如果第三方应用还托管了好友关系,好友的添加、删除也是这个类型的通知。系统通知由 SDK 负责接收和存储,并提供较简单的未读数管理。只有在线和离线,没有漫游。没有通知栏提醒(如有需要,第三方自行实现)。

通常在验证消息列表中展现。

自定义通知

提供给第三方自定义的全局的通知类型,其对应的数据结构为 CustomNotification。只有在线和离线,没有漫游,没有通知栏提醒(第三方自行实现)。

自定义通知和自定义消息的不同之处在于,自定义消息归属于会话中的消息体系内,由 SDK 存储在消息数据库中,与网易云通信的其他内建消息类型一同展现给用户。而自定义通知主要用于第三方的一些事件状态通知,网易云通信不存储,也不解析这些通知,网易云通信仅仅负责替第三方传递和通知这些事件,起到透传的作用。

聊天双方处于P2P聊天界面时,显示的“正在输入通知”。