圈组主要功能

更新时间: 2022/12/06 06:19:39

本文主要介绍圈组的主要功能,包括圈组消息、圈组系统通知、订阅制、圈组推送、成员管理以及下行消息量。

成员管理

成员管理方式 说明
邀请他人加入服务器 创建服务器后用户可以选择邀请他人成为服务器成员。
申请加入服务器 用户申请成为某个服务器的成员。
踢除他人 拥有踢除他人权限的用户可以将其他成员踢出服务器。
主动离开服务器 用户加入服务器后如不想继续待在该服务器,可选择主动离开。离开后用户将不会收到该服务器下的消息和通知。
修改成员信息 如有相应权限,用户可修改自己或者他人的服务器成员信息。

圈组消息

  • 圈组支持的消息类型说明见下表。

    消息类型 说明
    文本消息 消息内容为普通文本
    图片消息 消息内容为图片 URL 地址、尺寸、图片大小等信息
    语音消息 消息内容为语音文件的 URL 地址、时长、大小、格式等信息
    视频消息 消息内容为视频文件的 URL 地址、时长、大小、格式等信息
    文件消息 消息内容为文件的 URL 地址、大小、格式等信息,格式不限
    地理位置消息 消息内容为地理位置标题、经度、纬度信息
    自定义消息 开发者自定义的消息类型,例如红包消息、石头剪子布等形式的消息
  • 圈组消息支持的操作及对应的可操作人员说明见下表。

    消息操作 可操作人员
    撤回 具有撤回消息权限的身份组的成员
    删除 具体删除消息权限的身份组成员
    变更 仅消息发送者可变更消息
  • 圈组消息只能在频道内发送。发送消息前要先在圈组服务器下创建频道。
  • 圈组消息默认存离线且支持查询。
  • 圈组服务器会维护每个用户在每个频道上的消息未读数(默认最大 99+)和@消息未读数(默认最大 99+)。
  • @消息未读数量的有效期默认为7天。
  • 下行消息量(云信服务器发送至客户端的消息)为计费特征, 下行消息包含客户端主动拉取的历史消息和在线期间收到的消息。

圈组系统通知

系统通知既可以在频道内发送,也可以在圈组服务器下发送。

圈组系统通知分类.png

圈组系统通知分类

系统通知可分为内置系统通知和自定义系统通知。

系统通知类型 说明 离线系统通知限制
内置系统通知 圈组内置的系统通知,具体类型见 每月 1,000 条离线通知
自定义系统通知 开发者自定义系统通知, 如“正在输入” 每月 1,000 条离线通知

内置系统通知类型

圈组内置系统通知,按大类可分为服务器成员管理相关通知、服务器相关事件通知和频道相关事件通知。

  • 服务器成员管理相关

    类型触发条件通知接收者接收条件
    邀请服务器成员 服务器成员邀请其他用户加入该服务器时 被邀请人
    拒绝邀请 被邀请人拒绝加入服务器时 邀请人
    申请加入服务器 用户申请加入某个圈组服务器时服务器创建者
    拒绝申请 服务器创建者拒绝申请人加入其服务器时申请人
  • 服务器相关事件通知

    类型触发条件通知接收者接收条件
    创建服务器 用户创建服务器时服务器创建者接收者在线
    删除服务器服务器创建者删除服务器时服务器全体成员
    • 创建者:在线
    • 其他成员:在线且订阅该服务器
    修改服务器信息 拥有服务器管理权限的成员修改服务器消息时 服务器全体成员
    • 创建者:在线
    • 其他成员:在线且订阅该服务器
    已邀请服务器成员
    接受邀请 服务器创建者接受申请人加入服务器的申请时邀请人和其他服务器成员接收者在线且订阅该服务器
    已申请加入服务器
    接受申请 服务器创建者接受申请人加入服务器时 申请人、服务器创建者和其他服务器成员
    • 创建者:在线
    • 申请人:在线
    • 其他成员:在线且订阅该服务器
    踢除服务器成员 拥有踢除成员权限的服务器成员踢除某个成员时 踢人者、被踢者和其他服务器成员
    • 踢人者:在线
    • 被踢者:在线
    • 其他成员:在线且订阅该服务器
    主动离开服务器 服务器成员主动离开服务器时 主动离开者和其他服务器成员
    • 离开者:在线
    • 创建者:在线
    • 其他成员:在线且订阅该服务器
    修改服务器成员信息 服务器成员修改自己或他人成员信息时 修改人、被修改人和其他成员
    • 修改人:在线
    • 被修改人:在线
    • 其他成员:在线且订阅该服务器
  • 频道相关事件通知

    类型触发条件通知接收者接收条件
    创建频道 服务器创建人创建频道时 创建者 创建者:在线
    删除频道 服务器创建人删除频道时 创建者和其他频道成员
    • 创建者:在线
    • 其他频道成员:在线且订阅该服务器
    修改频道信息 频道信息被修改时 修改人和其他频道成员
    • 修改人:在线
    • 其他频道成员:在线且订阅该服务器
    频道修改黑白名单身份组 频道黑白名单身份组被修改时 修改人、涉及的黑白名单身份组成员和其他频道成员
    • 修改人:在线
    • 涉及的黑白名单身份组成员:在线
    • 其他频道成员:在线且订阅该服务器
    频道修改黑白名单成员 频道黑白名单成员被修改时 修改人、涉及的黑白名成员和其他频道成员
    • 修改人:在线
    • 涉及的黑白名单成员:在线
    • 其他频道成员:在线且订阅该服务器
    更新快捷评论表情 快捷评论表情更新时 更新人和其他频道成员
    • 更新人:在线
    • 其他评论参与者:在线且订阅该服务器

圈组系统通知相关功能

功能 说明
面向服务器/频道内所有成员自定义系统通知 仅支持发送给在线账号。
面向服务器/频道内某些成员的自定义系统通知 支持系统通知存离线,最多一个月内 1000 条。如果系统通知是针对某些账号发送的(即多用户系统通知),支持保存离线系统通知,使不在线的用户在登录时获取离线系统通知。如果系统通知已存离线,接收者可更新通知状态和内容或状态,从而可以下次登录或者换设备登录时获取更新的离线通知。典型终端用户场景:将系统通知(如邀请加入圈组服务器的通知)置为待办。

订阅机制

功能限制

圈组收发消息/系统通知使用订阅机制。一般情况下,当用户登录到圈组服务器后,需要先订阅相关频道或者圈组服务器,才能收到相关频道和圈组服务器的消息和系统通知。

  • 对于成员小于小于 2,000 (可联系商务经理调整该阈值)的频道或圈组服务器,即使不订阅,成员也能收到这些圈组服务器/频道的消息和系统通知。
  • 被@的账号(非@所有人),即使没有订阅也会收到消息。
  • 针对某些成员发送的系统通知(区别于发送给频道内所有人或者服务器内所有人),即使没有订阅这些成员也会收到通知。

订阅类型

订阅类型 说明 消息接收差异
类型 1 订阅某个频道的消息和系统通知,默认最多100个频道。 客户端接收频道内每条消息的实时通知
类型 2 订阅某个频道的消息未读数和系统通知,默认最多500个频道。 客户端接收频道内每条消息的摘要(如消息id、消息发送时间点),用于更新本地的未读计数,且在未读计数达到上限后(默认 99)不再下发摘要
类型 3 订阅某个频道的消息未读状态和系统通知,默认最多1000个频道。 客户端接收频道内每条消息的摘要(如消息id、消息发送时间点),用于更新本地的未读计数,且未读数大于 0 就不再下发摘要
类型 4 订阅某个服务器的系统通知,默认最多2000个服务器。 N/A

用户在使用消息订阅系统时,可以选择自己关注的服务器/频道进行订阅,最优方案是订阅当前页面所在服务器/频道(订阅类型1),其他服务器/频道选择订阅类型2或者3,当用户切换页面到其他服务器和频道后,将新的服务器/频道设置为订阅类型1,并获取一次最近历史消息。

此文档是否对你有帮助?
有帮助
去反馈
  • 成员管理
  • 圈组消息
  • 圈组系统通知
  • 圈组系统通知分类
  • 内置系统通知类型
  • 圈组系统通知相关功能
  • 订阅机制
  • 功能限制
  • 订阅类型