常见错误码分类说明与解决方案-视频直播-阿里云

文档备案控制台

输入文档关键字查找

通过阅读本文，您可以了解Harmony ARTC SDK常见的错误码及对应解决方案。

说明

部分错误码可以根据十进制值或十六进制值，在错误码列表找到详细的原因及解决方案。

入会错误码

字段名	十进制值	十六进制值	说明
ERR_JOIN_BAD_APPID	33620481	0x02010201	AppId不存在，请在控制台创建应用。
ERR_JOIN_INVALID_APPID	33620482	0x02010202	AppId已失效，请在控制台重新启用应用。
ERR_JOIN_BAD_CHANNEL	33620484	0x02010204	频道不存在，请尝试重新加入频道。如会议发起者入会后又很快离会，第二个人随后入会，发现会议已经不存在了。
ERR_JOIN_INVALID_CHANNEL	33620483	0x02010203	频道已经失效（目前频道有效期为48小时），请重新生成频道鉴权令牌（Token）。
ERR_JOIN_BAD_TOKEN	33620485	0x02010205	Token无效。请重新生成频道鉴权令牌（Token）。
ERR_JOIN_TIMEOUT	17301508	0x01020204	加入频道超时，请检查网络连接是否正常
ERR_JOIN_ERR_JOIN_BAD_PARAMBAD_CHANNEL	17314049	0x01030101	参数错误，AliRtcEngineAuthInfo 中的字段为空或者timestamp<=0，请检查字段是否完整。
ERR_JOIN_CHANNEL_FAILED	17317890	0x01030202	加入频道失败。

日志模块错误码

字段名	十进制值	十六进制值	说明
ERR_LOG_ALREADY_INIT	17314053	0x01030105	日志模块已经初始化。
ERR_LOG_ROOT_PATH_ERROR	17314054	0x01030106	日志模块根路径错误，请检查路径是否存在或路径是否具有写入权限。

音频设备错误码

字段名	十进制值	十六进制值	说明
ERR_MIC_OPEN_FAIL	17321988	0x01040404	采集设备初始化失败、采集设备媒体服务异常、或音频设备被占用。
ERR_SPEAKER_OPEN_FAIL	17321989	0x01040405	播放设备初始化失败、播放设备媒体服务异常、或音频设备被占用。
ERR_MIC_INTERRUPT	17321990	0x01040406	系统性能不足、采集设备媒体服务异常、音频设备被占用。建议重启应用或重启设备。
ERR_SPEAKER_INTERRUPT	17321991	0x01040407	系统性能不足，播放设备媒体服务异常，音频设备被占用。建议重启应用或重启设备。
ERR_MIC_AUTH_FAIL	17321992	0x01040408	麦克风设备未授权，建议去系统设置中，打开麦克风授权，并且重新加入频道。
ERR_MIC_NOT_AVAILABLE	17321993	0x01040409	无可用的音频采集设备，检查是否接入了可用的麦克风，并检查系统设置中，该设备是否被禁用。
ERR_SPEAKER_NO_AVAILABLE	17321994	0x01040410	无可用的音频播放设备，检查是否接入了可用的扬声器或耳机，并检查系统设置中，该设备是否被禁用。

视频设备错误码

字段名	十进制值	十六进制值	说明
ERR_CAMERA_OPEN_FAIL	17321220	0x01040104	采集设备初始化失败，检查系统相机是否可用，移动端App是否占用了相机。
ERR_CAMERA_INTERRUPT	17321222	0x01040106	采集过程中出现异常，设备被强制中断。建议重新加入频道或者重启App。
ERR_VIDEO_DISPLAY_OPEN_FAIL	17321473	0x01040201	渲染设备初始化失败。
ERR_VIDEO_DISPLAY_INTERRUPT	17321216	0x0104020	渲染过程中出现异常，系统异常错误导致渲染引擎报错，重新加入频道或者重启App。

网络错误码

字段名	十进制值	十六进制值	说明
ERR_ICE_CONNECTION_CONNECT_FAIL	17328641	0x01050201	媒体通道建立失败，检查网络连接是否正常。
ERR_ICE_CONNECTION_RECONNECT_FAI	17328642	0x01050202	媒体通道重连失败，检查网络连接是否正常。
ERR_ICE_CONNECTION_MOBILITY_FAIL	17328643	0x01050203	媒体通道mobility失败，应用层需要重走入会流程。
ERR_ICE_CONNECTION_HEARTBEAT_TIMEOUT	17313292	0x0102020C	信令心跳超时，检查网络连接是否正常。

性能相关错误码

字段名	十进制值	十六进制值	说明
ON_PERFORMANCE_LOW	17322241	0x01060101	当前设备性能不足。
ON_PERMORMANCE_RECOVERY	17322242	0x01060102	当前设备性能恢复。

低延时互动直播模式相关错误码

字段名	十进制值	十六进制值	说明
ERR_LATENCY_LIVE_COMMUNICATION_FAILED	17338371	0x01070003	低延时互动直播信令失败。
ERR_LATENCY_LIVE_MEIDASETTING_FAILED	17338372	0x01070004	低延时互动直播媒体设置错误。
ERR_LATENCY_LIVE_NONE_BROADCASTER	17338373	0x01070005	低延时互动直播当前房间没有主播推流。
ERR_LATENCY_LIVE_NEED_RESTART	17338374	0x01070006	低延时互动直播错误，应用层需要重新创建新的SDK实例。
ERR_LATENCY_LIVE_NEED_RESTART_AGAIN_LATER	17338375	0x01070007	低延时互动直播错误，应用层需要稍等一定时间（自定义间隔）重新创建新的SDK实例。
ERR_LATENCY_LIVE_SERVICE_UNAVAILABLE	17338376	0x01070008	低延迟互动直播服务不可用或者服务降级，客户端应该选择其它方式拉超大方会流，即不从CDN SFU拉流。
ERR_LATENCY_LIVE_MEDIACONNECTION_INTERRUPTION	17338377	0x01070009	低延迟互动直播网络中断错误，销毁当前SDK实例重新创建SDK后重新走订阅流程。

推流相关错误码

字段名	十进制值	十六进制值	说明
ERR_SDK_PUBLISH_INVAILD	17317637	0x01030305	推流无效。
ERR_SDK_PUBLISH_NOT_JOIN_CHANNEL	17317894	0x01010406	未进入频道推流失败。
ERR_SDK_PUBLISH_AUDIO_STRAM_FAILED	17317968	0x01010450	推送音频流失败。
ERR_SDK_PUBLISH_VIDEO_STRAM_FAILED	17317969	0x01010451	推送视频流失败。
ERR_SDK_PUBLISH_DUAL_STRAM_FAILED	17317970	0x01010452	推送小流失败。
ERR_SDK_PUBLISH_SCEEN_SHARE_FAILED	17317971	0x01010453	推送屏幕共享失败。
ERR_SDK_PUBLISH_SCREEN_SHARE_CONFIG_ERROR	17317972	0x01010454	屏幕共享配置错误。

订阅相关错误码

字段名	十进制值	十六进制值	说明
ERR_SDK_SUBSCRIBE_INVAILD	17317892	0x01030404	订阅无效。
ERR_SDK_SUBSCRIBE_NOT_JOIN_CHANNEL	17318224	0x01010550	未进入频道订阅错误。
ERR_SDK_SUBSCRIBE_AUDIO_STRAM_FAILED	17318225	0x01010551	订阅音频流失败。
ERR_SDK_SUBSCRIBE_VIDEO_STRAM_FAILE	17318226	0x01010552	订阅视频流失败。
ERR_SDK_SUBSCRIBE_DUAL_STRAM_FAILE	17318227	0x01010553	订阅小流失败。
ERR_SDK_SUBSCRIBE_SCREEN_SHARE_FAILE	17318228	0x01010554	订阅屏幕共享失败。

其他错误码

字段名	十进制值	十六进制值	说明
ERR_SDK_INVALID_STATE	17317892	0x01030204	SDK状态错误，建议销毁SDK重新创建实例。
ERR_INVALID_ARGUMENTS	17314051	0x01030103	参数不匹配。
ERR_SESSION_REMOVED	33619205	0x02010105	Session已经被移除，建议销毁实例之后重新创建实例并加入频道。
ERR_SDK_AUDIO_INPUT_BUFFER_FULL	17338625	0x01070101	推送音频流buffer队列饱和，用于外部输送裸数据功能，建议降低外部输入频次。
ERR_SDK_VIDEO_INPUT_BUFFER_FULL	17338626	0x01070102	推送视频流buffer队列饱和，用于外部输送裸数据功能，建议降低外部输入频次。
ERR_SDK_UPDATE_ROLE_CHANNEL	17313281	0x01020201	互动模式下设置角色错误。
ERR_INNER	-1	-1	SDK内部错误。

旁路直播错误码

字段名	十进制值	十六进制值	说明
ERR_SDK_MPU_TASK_PUBLISH_OK	0	0	MPU任务发布成功。
ERR_SDK_MPU_TASK_STREAM_NOT_FOUND	17338369	0x01100001	MPU任务流未找到。
ERR_SDK_MPU_TASK_STREAM_ALREADY_EXIST	17338370	0x01100002	MPU任务流已存在。
ERR_SDK_MPU_TASK_INVALID_PARAM	17338371	0x01100003	MPU任务无效参数。
ERR_SDK_MPU_TASK_INTERNAL_ERROR	17338372	0x01100004	MPU任务内部错误。
ERR_SDK_MPU_TASK_RTMP_SERVER_ERROR	17338373	0x01100005	MPU任务RTMP服务错误。
ERR_SDK_MPU_TASK_RTMP_STREAM_URL_ERROR	17338374	0x01100006	MPU任务RTMP流地址错误。
ERR_SDK_MPU_TASK_PUBLISH_TIMEOUT	17338375	0x01100007	MPU任务发布超时。
ERR_SDK_MPU_TASK_NOT_AUTHORIZED	17338376	0x01100008	MPU任务发布成功。

跨频道转推错误码

字段名	十进制值	十六进制值	说明
ERR_SDK_CHANNEL_RELAY_STATE_ERROR	18874369	0x01200001	检测到本地状态不对，没入会，角色错误，频道模式错误。
ERR_SDK_CHANNEL_RELAY_SRC_NOT_ALLOW	18874370	0x01200002	服务端返回436，源通道模式不匹配。
ERR_SDK_CHANNEL_RELAY_JOIN_DEST_FAILED	18874371	0x01200003	服务端返回437，目标通道不存在或者模式不匹配。
ERR_SDK_CHANNEL_RELAY_TOKEN_INVALID	18874372	0x01200004	服务端返回438，Token无效。
ERR_SDK_CHANNEL_RELAY_ROLE_ERROR	18874373	0x01200005	服务端返回651，session不是主播。
ERR_SDK_CHANNEL_RELAY_INVALID_PARAM	18874374	0x01200006	服务端400，参数错误。
ERR_SDK_CHANNEL_RELAY_TO_SELF_ERROR	18874375	0x01200007	服务端返回440，不能转推到本频道。

上一篇：AliRtcEngine接口下一篇：Mac SDK

该文章对您有帮助吗？