|
7 | 7 |
|
8 | 8 | ## 单聊消息类型
|
9 | 9 |
|
10 |
| -| 类型<div style="width: 120px;"></div> | 描述 | |
11 |
| -| :------------- | :----------------------------------------------------------- | |
| 10 | +| 类型<div style="width: 120px;"></div> | 描述 | |
| 11 | +| :------------- | :----------- | |
12 | 12 | | 文本消息 | 文本消息的内容是文本,包含超链接和表情符号等。表情消息基于文本消息实现。<br/> 文本消息大小限制为 5 KB。 |
|
13 | 13 | | 位置消息 | 位置消息需要第三方的地图服务提供经纬度信息。接收方接收到位置消息,通过经纬度信息可以在第三方的地图服务中显示位置。 |
|
14 | 14 | | 透传消息 | 透传消息可视为命令消息。通过发送这条命令给对方,通知对方要执行的操作,对方收到消息后系统可以自定义处理。透传消息不会在 UI 上展示。<br/>消息大小限制为 5 KB。<br> 你可以使用透传消息更新头像和昵称以及进行状态同步等。<br/> 透传消息不会存入本地数据库。 |
|
|
18 | 18 | | 文件消息 | 文件消息是附件消息,需要先将文件上传至消息服务器。<br/> 附件大小不能超过 10 MB,文件消息大小限制为 5 KB。 |
|
19 | 19 | | 自定义消息 | 开发者自定义的消息类型。自定义消息支持设置类型名称,开发者可以添加多种自定义消息。<br/>自定义消息大小限制为 5 KB。<br/>自定义消息的使用场景:红包消息、模板消息等。 |
|
20 | 20 |
|
| 21 | + |
21 | 22 | :::tip
|
22 |
| -1. 默认情况下,消息附件,例如图片、音频、视频和其他文件不能超过 10 MB,可存储 7 天。若要提升其中一个上限,请联系商务。 |
23 |
| -2. 当基础的消息类型不满足需求时,可以使用消息自定义扩展增强基础消息类型,典型的用例是发送引用较早文本或图像消息的消息。使用扩展后,消息大小不能超过原类型消息的大小。 |
| 23 | +<br/> - 默认情况下,消息附件,例如图片、音频、视频和其他文件不能超过 10 MB,可存储 7 天。若要提升其中一个上限,请联系商务。<br/> - 当基础的消息类型不满足需求时,可以使用消息自定义扩展增强基础消息类型,典型的用例是发送引用较早文本或图像消息的消息。使用扩展后,消息大小不能超过原类型消息的大小。 |
24 | 24 | :::
|
25 | 25 |
|
26 | 26 | ## 单聊消息发送控制
|
27 | 27 |
|
28 | 28 | | 单聊消息发送控制 | 描述 |
|
29 | 29 | | :--------- | :----- |
|
30 |
| -| 陌生人之间发送消息 | App 内任意两个用户之间均可发送单聊消息。该场景下,在环信即时通讯控制台的**即时通讯 > 服务概览**页面的**设置**区域下关闭了**好友关系检查**功能。 | |
| 30 | +| 陌生人之间发送消息 | App 内任意两个用户之间均可发送单聊消息。该场景下,在环信即时通讯控制台的 **即时通讯 > 服务概览** 页面的 **设置** 区域下关闭了 **好友关系检查** 功能。 | |
31 | 31 | | App 管理员发送单聊消息 | App 管理员模拟其他用户向 app 内任意用户发送消息。 |
|
32 |
| -| 只给好友发送消息 | 只能给好友发送消息,即在环信即时通讯控制台的**即时通讯 > 服务概览**页面的**设置**区域下打开**好友关系检查**功能。 | |
| 32 | +| 只给好友发送消息 | 只能给好友发送消息,即在环信即时通讯控制台的 **即时通讯 > 服务概览** 页面的 **设置** 区域下打开 **好友关系检查** 功能。 | |
33 | 33 | | 拒绝来自某用户的消息 | 可通过以下两种方法拒绝来自某个用户的消息:<br/> - **将用户添加到黑名单**,拒绝来自该用户的消息。<br/> - **将该用户从联系人列表移除。** 这种情况适用于 app 仅支持好友之间发送消息的情况。如果 app 支持陌生人之间发送消息,例如,用户 A 从用户 B 的联系人列表移除,用户 A 仍然可以向用户 B 发送消息吧。<br/> - **全局禁言 (RESTful API)**:可通过对单个用户进行单聊全局禁言,使指定用户无法向 app 内的任何用户发送单聊消息。|
|
34 | 34 | |对消息放行或拦截|- **发送前回调**:环信 IM 服务器会在发送消息之前,向你的应用服务器发送请求,你可以根据业务需求配置规则决定下发或拦截消息。<br/> - **内容审核**:基于内容审核结果对消息进行处理,包括拦截、替换敏感信息和放行消息。该服务只对文本、图片、音频和视频消息有效。 |
|
35 | 35 |
|
36 | 36 | ## 单聊消息发送频率限制
|
37 | 37 |
|
38 |
| -- REST API |
| 38 | +### REST API |
39 | 39 |
|
40 |
| - 对于单个 app,发送单聊消息 REST API 默认存在以下限制(你可以联系环信商务上调限制): |
| 40 | +对于单个 app,发送单聊消息 REST API 默认存在以下限制(你可以联系环信商务上调限制): |
41 | 41 |
|
42 |
| - <table> |
| 42 | +<table> |
43 | 43 | <tbody>
|
44 | 44 | <tr>
|
45 | 45 | <td width="110">
|
|
100 | 100 | </tbody>
|
101 | 101 | </table>
|
102 | 102 |
|
103 |
| -- SDK |
| 103 | +### SDK |
104 | 104 |
|
105 |
| - 默认情况下,SDK 对单个用户发送消息的频率未做限制。如果你联系了环信商务设置了该限制,一旦在单聊中单个用户的消息发送频率超过设定的上限,SDK 会上报错误,例如 Android 端的错误码为 509 `MESSAGE_CURRENT_LIMITING`。 |
| 105 | +默认情况下,SDK 对单个用户发送消息的频率未做限制。如果你联系了环信商务设置了该限制,一旦在单聊中单个用户的消息发送频率超过设定的上限,SDK 会上报错误,例如 Android 端的错误码为 509 `MESSAGE_CURRENT_LIMITING`。 |
106 | 106 |
|
107 | 107 | ## 单聊消息扩展能力
|
108 | 108 |
|
109 | 109 | | 单聊消息扩展能力 | 功能描述 | 应用场景 |
|
110 |
| -| :--------- | :----- |:----- | |
| 110 | +| :--------- | :----- | :------- | |
111 | 111 | | 获取聊天记录 | 可通过 SDK 或 REST API 获取历史消息 | <br/> - 获取实时聊天记录 <br/> - 定期下载消息记录 |
|
112 | 112 | | 多终端同步 | 支持单聊消息多终端同步 | 用户多终端消息同步 |
|
113 | 113 | | 单聊消息离线推送 | 支持苹果、华为、荣耀、OPPO、vivo、小米、和魅族等品牌设备的离线推送 | 消息离线推送 |
|
|
0 commit comments