ErrorCode

  • HarmonyOS

更新时间不可用

错误代码。

详情

错误代码意味着 SDK 遇到不可恢复的错误,需要应用程序干预。例如:打开摄像头失败时会返回错误,App 需要提示用户不能使用摄像头。

枚举值

参数名描述
ERR_OK

0:没有错误。

ERR_FAILED

1:一般性的错误(没有明确归类的错误原因)。请重新调用方法。

ERR_INVALID_ARGUMENT

2:方法中设置了无效的参数。例如指定的频道名中含有非法字符。请重新设置参数。

ERR_NOT_READY

3:SDK 尚未准备好。可能的原因有:

  • RtcEngine 初始化失败。请重新初始化 RtcEngine。
  • 调用方法时用户尚未加入频道。请检查方法的调用逻辑。
  • 音频模块未开启。
  • 程序集不完整。
ERR_NOT_SUPPORTED

4:RtcEngine 当前状态不支持该操作。可能的原因有:

  • 使用内置加密时,设置的加密模式不正确,或加载外部加密库失败。请检查加密的枚举值是否正确,或重新加载外部加密库。
ERR_REFUSED

5:方法调用被拒绝。可能的原因有:

  • RtcEngine 初始化失败。请重新初始化 RtcEngine。
  • 在加入频道时,将频道名设为空字符 ""。请重新设置频道名。
  • 多频道场景下,在调用 joinChannelEx 方法加入频道时,设置的频道名已存在。请重新设置频道名。
ERR_BUFFER_TOO_SMALL

6:缓冲区大小不足以存放返回的数据。

ERR_NOT_INITIALIZED

7:RtcEngine 尚未初始化就调用方法。请确认在调用该方法前已创建 RtcEngine 对象并完成初始化。

ERR_NO_PERMISSION

9:没有操作权限。请检查用户是否授予了 App 音视频设备的使用权限。

ERR_TIMEDOUT

10: 方法调用超时。有些方法调用需要 SDK 返回结果,如果 SDK 处理事件过长,超过 10 秒没有返回,会出现此错误。

ERR_JOIN_CHANNEL_REJECTED

17:加入频道被拒绝。可能的原因有:

  • 用户已经在频道中。建议通过 onConnectionStateChanged 回调判断用户是否在频道中。除收到 DISCONNECTED(1) 状态外,不要再次调用该方法加入频道。
ERR_LEAVE_CHANNEL_REJECTED

18:离开频道失败。可能的原因有:

  • 调用 leaveChannel 前,用户已离开频道。停止调用该方法即可。
  • 用户尚未加入频道,就调用 leaveChannel 退出频道。这种情况下无需额外操作。
ERR_ALREADY_IN_USE

19:资源已被占用,不能重复使用。

ERR_ABORTED

20:SDK 放弃请求,可能由于请求的次数太多。

ERR_INIT_NET_ENGINE

21:Windows 下特定的防火墙设置导致 RtcEngine 初始化失败然后崩溃。

ERR_RESOURCE_LIMITED

22:SDK 分配资源失败,可能由于 App 占用资源过多或系统资源耗尽。

ERR_INVALID_APP_ID

101:不是有效的 App ID。请更换有效的 App ID 重新加入频道。

ERR_INVALID_CHANNEL_NAME

102:不是有效的频道名。可能的原因是设置的参数数据类型不正确。请更换有效的频道名重新加入频道。

ERR_TOKEN_EXPIRED

109:当前使用的 Token 过期,不再有效。请在服务端申请生成新的 Token,并调用 renewToken 更新 Token。

弃用:

该枚举已废弃。请改用 onConnectionStateChanged 回调中的 TOKEN_EXPIRED(9)。

ERR_INVALID_TOKEN

110:Token 无效。一般有以下原因:

  • 在控制台中启用了 App 证书,但未使用 App ID + Token 鉴权。当项目启用了 App 证书,就必须使用 Token 鉴权。
  • 生成 Token 时填入的 uid 字段,和用户加入频道时填入的 uid 不匹配。

弃用:

该枚举已废弃。请改用 onConnectionStateChanged 回调中的 INVALID_TOKEN(8)。

ERR_CONNECTION_INTERRUPTED

111:网络连接中断。SDK 在和服务器建立连接后,失去网络连接超过 4 秒。

ERR_CONNECTION_LOST

112:网络连接丢失。网络连接中断,且 SDK 无法在 10 秒内连接服务器。

ERR_NOT_IN_CHANNEL

113:调用 sendStreamMessage 方法时用户不在频道内。

ERR_SIZE_TOO_LARGE

114:在调用 sendStreamMessage 时,发送的数据长度大于 1 KB。

ERR_BITRATE_LIMIT

115:在调用 sendStreamMessage 时,发送数据的频率超过限制(6 KB/s)。

ERR_TOO_MANY_DATA_STREAMS

116:在调用 createDataStream 时,创建的数据流超过限制(5 个)。

ERR_DECRYPTION_FAILED

120:媒体流解密失败。可能是用户加入频道时使用了错误的密钥。请检查用户加入频道时填入的密钥,或引导用户尝试重新加入频道。

ERR_DATASTREAM_DECRYPTION_FAILED

122:数据流解密失败。可能是用户加入频道时使用了错误的密钥。请检查用户加入频道时填入的密钥,或引导用户尝试重新加入频道。

ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH

130:SDK 不支持将加密过的流推到 CDN 上。

ERR_INVALID_USER_ACCOUNT

134:无效的 user account,可能是因为设置了无效的参数。

ERR_LOAD_MEDIA_ENGINE

1001:加载媒体引擎失败。

ERR_ADM_GENERAL_ERROR

1005:音频设备出现错误(未指明何种错误)。请检查音频设备是否被其他应用占用,或者尝试重新进入频道。

ERR_ADM_INIT_PLAYOUT

1008:初始化播放设备出错。请检查播放设备是否被其他应用占用,或者尝试重新进入频道。

ERR_ADM_START_PLAYOUT

1009:启动播放设备出错。请检查播放设备是否正常。

ERR_ADM_STOP_PLAYOUT

1010:停止播放设备出错。

ERR_ADM_INIT_RECORDING

1011:初始化录音设备出错。请检查录音设备是否正常,或者尝试重新进入频道。

ERR_ADM_START_RECORDING

1012:启动录音设备出错。请检查录音设备是否正常。

ERR_ADM_STOP_RECORDING

1013:停止录音设备出错。

ERR_VDM_CAMERA_NOT_AUTHORIZED

1501:没有摄像头使用权限。请检查是否已经打开摄像头权限。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?