Enumeration EngineError

成功

SDK 没有初始化，请先调用 init 接口

被对方加入黑名单，发送消息失败

对方开启了只接收白名单的信息，但己方不在白名单中，发送消息失败

在单聊中已被禁言

系统会话不支持发送该消息

发送消息频率过高，1 秒钟最多只允许发送 5 条消息

请求超出了调用频率限制，请稍后再试

发送的消息中包含敏感词（发送方发送失败，接收方不会收到消息）

消息中敏感词已经被替换（接收方可以收到被替换之后的消息）

不在该群组中

在群组中已被禁言

在该聊天室中已被禁言

已被踢出聊天室

聊天室不存在

聊天室成员超限，开发者可以提交工单申请聊天室人数限制变更。

不在该聊天室中

获取用户失败

聊天室接口参数无效。请确保参数不为 NULL 且有效。

查询聊天室历史消息异常。

聊天室云存储业务未开通。

聊天室的 kv 属性个数超限，单个聊天室默认上限为 100 个 Android, iOS, Web

没有权限修改聊天室中已存在的属性值 Android, iOS, Web

超过聊天室中状态设置频率，1 个聊天室 1 秒钟最多设置和删除状态 100 次 Android, iOS, Web

聊天室属性自定义设置，您可以在开发者后台免费基础功能页面中开启该功能。 Android, iOS, Web

聊天室属性不存在 Android, iOS, Web

聊天室批量设置或删除 kv 部分不成功 Android, iOS, Web

聊天室 kv 设置/删除个数超限，批量操作个数最多 10 个 Android, iOS, Web

聊天室设置 kv 失败，出现在两人或者多端同时操作一个 kv。如果出现该错误，为避免和其他端同时操作，请延时一定时间再试 Android, iOS, Web

撤回消息参数无效，请确认撤回消息参数是否正确的填写。

IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息，IM 服务有开关，控制只可以撤回自己发送的消息，当服务该开关打开时，撤回别人的消息会报这个错误

远程推送设置参数无效，请确认是否正确的填写了远程推送参数

本地会话状态的版本号低于服务端值，需要等待会话状态同步完成

消息 uid 为空串或 NULL

请求上传 token 时文件大小错误

无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)

未连接或连接已关闭

Publish & Query 请求响应超时 SOCKET_SIGNAL_TIMEOUT

导航请求失败

导航请求超时

消息大小超限，消息体（序列化成 json 格式之后的内容）

cmp 信令发送超时

导航请求携带 Token 错误

License 不匹配（私有云 - 鸿蒙平台）

信令版本错误

来源：ConnectAckCode = 1 | DisconnectAckCode = 8

客户端 info 字段格式错误，正确格式：{平台类型}-{设备信息}-{sdk 版本}。

来源：ConnectAckCode = 2

不支持的平台类型，一般小程序或 PC 未开通

来源：ConnectAckCode = 3

无法连接，Token 无法解析，或 Token 已过期，请更换 Token 重新连接

Note

经常发生在切换开发环境的时候，例如 app 用开发环境的 Token，服务端用生产环境的 appKey，或者相反的场景

Discussion

当发生该错误的时候检查一下 APP 使用的 appKey 和 APP Server 使用的 appKey 是否相同

来源：ConnectAckCode = 4

App 校验未通过（开通了 App 校验功能，但是校验未通过）

来源：ConnectAckCode = 5

连接重定向，需要清空导航缓存

来源：ConnectAckCode = 6 | DisconnectAckCode = 6

包名与后台注册信息不匹配，仅移动端使用

来源：ConnectAckCode = 7

该 AppKey 已经封禁或删除

来源：ConnectAckCode = 8

无法连接，该用户 ID 已经被封禁

Note

请自行检查融云管理后台该用户 ID 的状态

来源：ConnectAckCode = 9

cmp 异常断开错误错误 cmp 服务连接成功后，通知 SDK 用户被同账号其他端踢下线 给用户提示，告知已被提掉线

cmp 服务连接成功后，通知 SDK 用户被封禁 给用户提示，告知已被封禁

cmp 服务连接成功后，通知 SDK 用户主动退出

Socket 连接异常

Socket 关闭输出流失败

连接取消

通知 SDK Token 过期，APP 重新请求 Token

来源：ConnectAckCode = 10 | DisconnectAckCode = 7

Token 中携带 deviceId 时，检测 Token 中 deviceId 与链接设备 deviceId 不一致

来源：ConnectAckCode = 11

链路加密认证失败 (移动端链路加密认证失败需要清空导航缓存)

来源：ConnectAckCode = 12

开启 禁止把已在线客户端踢下线 开关后，该错误码标识已有同类型端在线，禁止链接

来源：ConnectAckCode = 13

连接总数量超过服务设定的并发限定值（私有云专属）

来源：ConnectAckCode = 14

客户端连错环境，引发连接拒绝；如使用开发环境 app_key 连接到生产环境

来源：ConnectAckCode = 15

开启 AppServer 联合鉴权功能后，到 AppServer 认证失败

来源：ConnectAckCode = 16

一次性 token 已经被使用过，需要重新请求 Token

来源：ConnectAckCode = 17

Token 绑定的平台与登录平台不符

来源：ConnectAckCode = 18

用户账号已销户，不再进行连接，给用户提示，告知账号已注销

来源：ConnectAckCode = 19 | DisconnectAckCode = 9

导航请求证书过期

可能原因如下：
1. 私有云服务的证书过期，联系融云私有云
2. 私有云服务不支持鸿蒙平台，请联系融云私有云
Copy

来源：ConnectAckCode = 20

Kv 存储器未打开

Kv 存储器打开失败

Kv 存储器读写错误

Kv 存储器序列化错误

Json 解析错误

图片转换错误

请求文件上传 Token 时错误

获取文件上传 Token 时错误

连接被拒绝，需要清空导航缓存

将消息存储到本地数据时失败。发送或插入消息时，消息需要存储到本地数据库，当存库失败时，会回调此错误码

连接进行中

历史消息云存储业务未开通

连接已存在

无法连接，连接超时，需要调用 connect 接口重新进行连接，一般是设备的网络原因

Note

connect 接口传入的超时时间，在这个时间范围内没有连接成功才会报该错误

消息不能被扩展，只支持单群聊

消息扩展字段超限

上传媒体消息失败

未注册的消息类型

不支持超级群会话

构建 EngineBuilderParamC 时传入的 app_key 为 NULL 仅 C_FFI 层使用

开发者接口调用时传入的时间戳非法

开发者接口调用时传入 MessageContent 非法

参数 Message 列表非法

开发者接口调用时传入的 ConversationType 非法

开发者接口调用时传入的 targetId 非法

开发者接口调用时传入的 MessageExpansion 非法

开发者调用频道相关接口时传入的 channelId 非法

开发者 sendMediaMessage 传入的 Message.content 不是多媒体消息

开发者接口调用时传入的时间字符串不合法，格式为 "HH:MM:SS"

开发者接口调用时传入的枚举值超出定义范围 注：因 C 枚举类型入参超范围时，会因 Undefined Behavior 无法预知结果，不能准确判断。 因此根据 https://github.com/rust-lang/rust-memory-model/issues/41 建议，改由平台层确保传入的枚举值在合法范围内。 仅 C_FFI 层使用（暂未使用）

免打扰级别非法

messageIds 参数为 NULL 或者数组长度为 0

开发者接口调用时传入的 count 非法

开发者调用接口传入的 local path 地址不存在

开发者调用接口传入的 mediaUrl 地址为空

开发者调用接口传入的 message 参数为空 仅 C_FFI 层使用

聊天室设置 kv 失败，参数 key 非法

聊天室设置 kv 失败，参数 key 数组非法

聊天室设置 kv 失败，参数 value 非法

聊天室设置 kv 失败，参数 key 和 value 数组非法

参数 MessageDirection 为空

开发者接口调用时传入的 objectName 非法 仅 C_FFI 层使用

参数 limit 非法

参数 MessageDirection 非法（发送消息时没有使用 Send）

设置免打扰的 span minutes 非法，支持范围 [1, 1439]

开发者接口调用时传入的 ConversationTypeVec 列表非法

调用 rcim_engine_builder_set_navi_server 时，传入的 url 为 NULL 仅 C_FFI 层使用

开发者接口调用时传入的 ConversationIdentifierVec 列表非法

当前会话类型不支持定向消息

数据库未打开

数据库打开错误

数据库读写错误

数据库序没有查到数据

网络数据转换失败

调用接口的同时，引擎已释放

接口传入的 RcimEngineSync* 为 NULL 时返回 仅 C_FFI 层使用

接口传入的 RcimEngineBuilder* 为 NULL 时返回 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 device_id 为 NULL 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 package_name 为 NULL 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 sdk_version 或 sdk_version_vec 为 NULL，或 sdk_version_vec_len = 0 仅 C_FFI 层使用

调用 rcim_engine_builder_set_store_path 或 rcim_engine_builder_set_file_path 时，传入的 path 为 NULL

调用 rcim_engine_connect 时传入的 token 为 NULL 或长度超范围

开发者调用接口传入的 messageId 参数非法

调用 rcim_engine_register_message_types 时传入的 type_vec 为 NULL 或 type_vec_len 为 0 仅 C_FFI 层使用

rust 新增，无法解析成 MediaMessage

用户 ID 为空

发送语音消息时，传入的语音长度非法

日志插入时参数无效

接口传入的 RcimEngineBuilderParamC* 为 null 时返回 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 device_model 为 NULL 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 device_manufacturer 为 NULL 仅 C_FFI 层使用

接口传入的 push_token_vec 为 null 或 push_token_vec_len 为 0 时返回 仅 C_FFI 层使用

接口传入的 push_type 为 null 时返回 仅 C_FFI 层使用

接口传入的 push_token 为 null 时返回 仅 C_FFI 层使用

开发者接口调用时传入的 SenderId 非法 All: 34421

免打扰级别数组非法

调用 rcim_engine_get_connection_status 时传入的 out_status 为 NULL 仅 C_FFI 层使用

调用 rcim_engine_get_version 时传入的 version 为 NULL 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 os_version 为 NULL 仅 C_FFI 层使用

构建 EngineBuilderParamC 时，传入的 app_version 为 NULL 仅 C_FFI 层使用

构建 rcim_engine_builder_set_statistic_server 时，传入的 url 为 NULL 仅 C_FFI 层使用

构建 rcim_engine_save_text_message_draft 时，掺入的 draft 为 NULL 仅 C_FFI 层使用

构建 rcim_engine_search_local_conversations 时，插入的 keyword 为 NULL 仅 C_FFI 层使用

开发者接口调用时传入的 offset 非法

开发者接口调用时传入的 object_name_vec 非法

开发者接口调用时传入的 time_interval 非法 仅 C_FFI 层使用

开发者接口调用时传入的 timeout_sec 非法 仅 C_FFI 层使用

加入聊天室 Id 为 NULL 仅 C_FFI 层使用