This topic describes common Harmony ARTC SDK error codes and provides their solutions.
For some error codes, you can find detailed causes and solutions in the Error code list using their decimal or hexadecimal values.
Meeting join error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_JOIN_BAD_APPID | 33620481 | 0x02010201 | The AppId does not exist. Create an application in the console. |
ERR_JOIN_INVALID_APPID | 33620482 | 0x02010202 | The AppId is invalid. Re-enable the application in the console. |
ERR_JOIN_BAD_CHANNEL | 33620484 | 0x02010204 | The channel does not exist. Try to join the channel again. For example, if the meeting initiator joins and then quickly leaves the channel, a second user who tries to join later will find that the meeting no longer exists. |
ERR_JOIN_INVALID_CHANNEL | 33620483 | 0x02010203 | The channel is invalid (channels are valid for 48 hours). Regenerate a channel authentication token. |
ERR_JOIN_BAD_TOKEN | 33620485 | 0x02010205 | The token is invalid. Regenerate a channel authentication token. |
ERR_JOIN_TIMEOUT | 17301508 | 0x01020204 | Timed out when joining the channel. Check if the network connectivity is normal. |
ERR_JOIN_ERR_JOIN_BAD_PARAMBAD_CHANNEL | 17314049 | 0x01030101 | A parameter is incorrect. A field in AliRtcEngineAuthInfo is empty or the timestamp is less than or equal to 0. Check if the fields are complete. |
ERR_JOIN_CHANNEL_FAILED | 17317890 | 0x01030202 | Failed to join the channel. |
Log module error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_LOG_ALREADY_INIT | 17314053 | 0x01030105 | The log module is already initialized. |
ERR_LOG_ROOT_PATH_ERROR | 17314054 | 0x01030106 | The root path of the log module is incorrect. Check if the path exists or if write permissions are granted for the path. |
Audio device error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_MIC_OPEN_FAIL | 17321988 | 0x01040404 | The capture device failed to initialize, the media service for the capture device is abnormal, or the audio device is occupied. |
ERR_SPEAKER_OPEN_FAIL | 17321989 | 0x01040405 | The playback device failed to initialize, the media service for the playback device is abnormal, or the audio device is occupied. |
ERR_MIC_INTERRUPT | 17321990 | 0x01040406 | System performance is insufficient, the media service for the capture device is abnormal, or the audio device is occupied. Restart the application or the device. |
ERR_SPEAKER_INTERRUPT | 17321991 | 0x01040407 | System performance is insufficient, the media service for the playback device is abnormal, or the audio device is occupied. Restart the application or the device. |
ERR_MIC_AUTH_FAIL | 17321992 | 0x01040408 | The microphone is not authorized. Go to System Settings, grant the microphone permission, and join the channel again. |
ERR_MIC_NOT_AVAILABLE | 17321993 | 0x01040409 | No audio capture device is available. Check if a microphone is connected and if the device is disabled in System Settings. |
ERR_SPEAKER_NO_AVAILABLE | 17321994 | 0x01040410 | No audio playback device is available. Check if a speaker or headset is connected and if the device is disabled in System Settings. |
Video device error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_CAMERA_OPEN_FAIL | 17321220 | 0x01040104 | The capture device failed to initialize. Check if the system camera is available and if it is occupied by another mobile app. |
ERR_CAMERA_INTERRUPT | 17321222 | 0x01040106 | An exception occurred during capture and the device was forcibly interrupted. Join the channel again or restart the app. |
ERR_VIDEO_DISPLAY_OPEN_FAIL | 17321473 | 0x01040201 | The rendering device failed to initialize. |
ERR_VIDEO_DISPLAY_INTERRUPT | 17321216 | 0x0104020 | An exception occurred during rendering. A system error caused the rendering engine to report an error. Join the channel again or restart the app. |
Network error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_ICE_CONNECTION_CONNECT_FAIL | 17328641 | 0x01050201 | Failed to establish the media channel. Check if the network connectivity is normal. |
ERR_ICE_CONNECTION_RECONNECT_FAI | 17328642 | 0x01050202 | Failed to reconnect to the media channel. Check if the network connectivity is normal. |
ERR_ICE_CONNECTION_MOBILITY_FAIL | 17328643 | 0x01050203 | Media channel mobility failed. The application layer needs to repeat the channel joining process. |
ERR_ICE_CONNECTION_HEARTBEAT_TIMEOUT | 17313292 | 0x0102020C | Signaling heartbeat timed out. Check if the network connectivity is normal. |
Performance-related error codes
Field name | Decimal value | Hexadecimal value | Description |
ON_PERFORMANCE_LOW | 17322241 | 0x01060101 | The current device has insufficient performance. |
ON_PERMORMANCE_RECOVERY | 17322242 | 0x01060102 | The performance of the current device has recovered. |
Low-latency interactive streaming mode error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_LATENCY_LIVE_COMMUNICATION_FAILED | 17338371 | 0x01070003 | Low-latency interactive stream signaling failed. |
ERR_LATENCY_LIVE_MEIDASETTING_FAILED | 17338372 | 0x01070004 | Incorrect media settings for the low-latency interactive stream. |
ERR_LATENCY_LIVE_NONE_BROADCASTER | 17338373 | 0x01070005 | No streamer is ingesting a stream to the current channel for the low-latency interactive stream. |
ERR_LATENCY_LIVE_NEED_RESTART | 17338374 | 0x01070006 | A low-latency interactive stream error occurred. The application layer needs to create a new SDK instance. |
ERR_LATENCY_LIVE_NEED_RESTART_AGAIN_LATER | 17338375 | 0x01070007 | A low-latency interactive stream error occurred. The application layer needs to wait for a custom interval and then create a new SDK instance. |
ERR_LATENCY_LIVE_SERVICE_UNAVAILABLE | 17338376 | 0x01070008 | The low-latency interactive stream service is unavailable or degraded. The client should pull the stream for the large-scale meeting in another way instead of from the CDN SFU. |
ERR_LATENCY_LIVE_MEDIACONNECTION_INTERRUPTION | 17338377 | 0x01070009 | A network interruption occurred for the low-latency interactive stream. Destroy the current SDK instance, create a new one, and then repeat the subscription process. |
Stream ingest error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_SDK_PUBLISH_INVAILD | 17317637 | 0x01030305 | Stream ingest is invalid. |
ERR_SDK_PUBLISH_NOT_JOIN_CHANNEL | 17317894 | 0x01010406 | Failed to ingest the stream because you have not joined the channel. |
ERR_SDK_PUBLISH_AUDIO_STRAM_FAILED | 17317968 | 0x01010450 | Failed to push the audio stream. |
ERR_SDK_PUBLISH_VIDEO_STRAM_FAILED | 17317969 | 0x01010451 | Failed to push the video stream. |
ERR_SDK_PUBLISH_DUAL_STRAM_FAILED | 17317970 | 0x01010452 | Failed to push the substream. |
ERR_SDK_PUBLISH_SCEEN_SHARE_FAILED | 17317971 | 0x01010453 | Failed to push the screen sharing stream. |
ERR_SDK_PUBLISH_SCREEN_SHARE_CONFIG_ERROR | 17317972 | 0x01010454 | Incorrect screen sharing configuration. |
Subscription error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_SDK_SUBSCRIBE_INVAILD | 17317892 | 0x01030404 | Subscription is invalid. |
ERR_SDK_SUBSCRIBE_NOT_JOIN_CHANNEL | 17318224 | 0x01010550 | Subscription error because you have not joined the channel. |
ERR_SDK_SUBSCRIBE_AUDIO_STRAM_FAILED | 17318225 | 0x01010551 | Failed to subscribe to the audio stream. |
ERR_SDK_SUBSCRIBE_VIDEO_STRAM_FAILE | 17318226 | 0x01010552 | Failed to subscribe to the video stream. |
ERR_SDK_SUBSCRIBE_DUAL_STRAM_FAILE | 17318227 | 0x01010553 | Failed to subscribe to the substream. |
ERR_SDK_SUBSCRIBE_SCREEN_SHARE_FAILE | 17318228 | 0x01010554 | Failed to subscribe to the screen sharing stream. |
Other error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_SDK_INVALID_STATE | 17317892 | 0x01030204 | The SDK is in an invalid state. Destroy the SDK and create a new instance. |
ERR_INVALID_ARGUMENTS | 17314051 | 0x01030103 | The parameters do not match. |
ERR_SESSION_REMOVED | 33619205 | 0x02010105 | The session has been removed. Destroy the instance, create a new one, and join the channel. |
ERR_SDK_AUDIO_INPUT_BUFFER_FULL | 17338625 | 0x01070101 | The buffer queue for pushing the audio stream is full. This is used for the external raw data input feature. Reduce the frequency of external input. |
ERR_SDK_VIDEO_INPUT_BUFFER_FULL | 17338626 | 0x01070102 | The buffer queue for pushing the video stream is full. This is used for the external raw data input feature. Reduce the frequency of external input. |
ERR_SDK_UPDATE_ROLE_CHANNEL | 17313281 | 0x01020201 | Failed to set the role in interactive mode. |
ERR_INNER | -1 | -1 | Internal SDK error. |
Bypass live streaming error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_SDK_MPU_TASK_PUBLISH_OK | 0 | 0 | The MPU task was published successfully. |
ERR_SDK_MPU_TASK_STREAM_NOT_FOUND | 17338369 | 0x01100001 | The MPU task stream was not found. |
ERR_SDK_MPU_TASK_STREAM_ALREADY_EXIST | 17338370 | 0x01100002 | The MPU task stream already exists. |
ERR_SDK_MPU_TASK_INVALID_PARAM | 17338371 | 0x01100003 | An invalid parameter was specified for the MPU task. |
ERR_SDK_MPU_TASK_INTERNAL_ERROR | 17338372 | 0x01100004 | An internal error occurred in the MPU task. |
ERR_SDK_MPU_TASK_RTMP_SERVER_ERROR | 17338373 | 0x01100005 | An RTMP service error occurred for the MPU task. |
ERR_SDK_MPU_TASK_RTMP_STREAM_URL_ERROR | 17338374 | 0x01100006 | The RTMP stream URL for the MPU task is invalid. |
ERR_SDK_MPU_TASK_PUBLISH_TIMEOUT | 17338375 | 0x01100007 | Publishing the MPU task timed out. |
ERR_SDK_MPU_TASK_NOT_AUTHORIZED | 17338376 | 0x01100008 | The MPU task is not authorized. |
Cross-channel stream relay error codes
Field name | Decimal value | Hexadecimal value | Description |
ERR_SDK_CHANNEL_RELAY_STATE_ERROR | 18874369 | 0x01200001 | An incorrect local state was detected. You have not joined a channel, the role is incorrect, or the channel mode is incorrect. |
ERR_SDK_CHANNEL_RELAY_SRC_NOT_ALLOW | 18874370 | 0x01200002 | The server returned error 436. The source channel mode does not match. |
ERR_SDK_CHANNEL_RELAY_JOIN_DEST_FAILED | 18874371 | 0x01200003 | The server returned error 437. The destination channel does not exist or its mode does not match. |
ERR_SDK_CHANNEL_RELAY_TOKEN_INVALID | 18874372 | 0x01200004 | The server returned error 438. The token is invalid. |
ERR_SDK_CHANNEL_RELAY_ROLE_ERROR | 18874373 | 0x01200005 | The server returned error 651. The session user is not a streamer. |
ERR_SDK_CHANNEL_RELAY_INVALID_PARAM | 18874374 | 0x01200006 | The server returned error 400. The parameters are incorrect. |
ERR_SDK_CHANNEL_RELAY_TO_SELF_ERROR | 18874375 | 0x01200007 | The server returned error 440. You cannot relay a stream to the same channel. |