This topic describes common error codes for the ApsaraVideo Real-time Communication software development kit (SDK) and provides their solutions.
Error codes
Hexadecimal | Decimal | Error description | Causes | Solution |
0x01010301 | 16843521 | already joined | The user has already joined the channel. | Check the API call logic. |
0x02010903 | 33622275 | failed to join channel due to invalid channel profile | The channel profiles do not match. For example, this error occurs if the first user joins in communication mode, and a subsequent user tries to join in interactive mode. | Check that the user's channel mode is consistent with the channel mode of other users in the channel. |
0x05040002 | 84148226 | channel is overdue |
| Check the following items:
|
0x02010702 | 33621762 | join channel failed due to same user repeat join, please check if another device still in the channel | The user failed to join the channel due to a repeated join attempt. For example, the same user tried to join the same channel from two different devices, or the user's previous session has not been completely terminated. | Check the API call logic. |
0x02010104 | 33620228 | session join | The client tried to join the channel using the same session ID after leaving it. | Try to join the channel again. |
0x02010204 | 33620484 | channel is not exist | Failed to join the channel because the channel does not exist. For example, the channel creator joined and then quickly left. When another user tried to join, the channel was already gone. | Try to join the channel again. |
0x02010201 | 33620481 | bad appid | The AppId does not exist. | Check if the AppId exists in the environment and the console. |
0x02010202 | 33620482 | invalid appid | The AppId is invalid. | Check the current status of the AppId in the console. |
0x02010203 | 33620483 | bad channel | The channel cannot be created or the creation failed. | Check the channel ID naming and retry. |
0x02010205 | 33620485 | bad token | The token calculated by the client does not match the token calculated by the ApsaraVideo Real-time Communication service. |
|
0x01030101 | 16974081 | bad param | An invalid parameter was used. |
|
0x05010011 | 83951633 | join channel failed due to invalid channel id | The channel ID in the Global Server Load Balancing (GSLB) request is invalid. For example, the channel ID cannot contain spaces. | Check the channel ID format. A channel ID must be 1 to 64 characters long and can contain uppercase letters, lowercase letters, digits, underscores (_), and hyphens (-). |
0x05010012 | 83951634 | join channel failed due to invalid user id | The user ID in the GSLB request is invalid. | Try to join the channel again. |
0x0501001a | 83951642 | join channel due to invalid channel id | The AppId is configured for large-scale channel mode, which requires SDK version 1.16.5 or later. Joining the channel will fail with an older version. | Check the SDK version. |
0x01020201 | 16908801 | signal request is timeout | A response to the GSLB request was not received, causing a timeout. | Check if the network connectivity is normal. |
0x01020204 | 16908804 | join timeout | A response to the join channel request was not received, causing a timeout. | Check if the network connectivity is normal. |
0x01030202 | 16974338 | join error | Error joining the channel. | Check if the authentication information is correct and the network environment is stable. |
0x01030201 | 16974337 | gslb error | The gslb field in the AuthInfo parameter is incorrect. | Check if the gslb field in AuthInfo is complete, or verify that AuthInfo can pass validation. |
0x01040404 | 17040388 | mic open fail | Capture device initialization failed. For example, the device is in use. | On macOS and Windows, check for an activity level indicator in System Settings. On iOS and Android, confirm if another application is using the device. If everything is normal, restart the device. |
0x01040405 | 17040389 | speaker open fail | Playback device initialization failed. | On macOS and Windows, check for an activity level indicator in System Settings. On iOS and Android, confirm if another application is using the device. If everything is normal, restart the device. |
0x01040406 | 17040390 | mic interrupt | The device is in use by another application. | This must be released by other applications. |
0x01040407 | 17040391 | speaker interrupt | The device is in use by another application. | The other application must release the device. |
0x01040408 | 17040392 | mic auth fail | Authorization for the audio capture device was not granted. | Prompt the user for authorization. |
0x01040409 | 17040393 | mic not available | No available audio capture device. | Check if the device exists in the system. Check if the device is disabled in the system. |
0x01040410 | 17040400 | speaker not available | No available audio playback device. | Check if the device exists in the system. Check if the device is disabled in the system. |
0x01040104 | 17039620 | camera open fail | Video capture device initialization failed. | Check if the application is using the camera. |
0x01040106 | 17039622 | camera interrupt | The video capture device was forcibly interrupted. | Check if the device is in use by another application. Check if the device is working correctly. |
0x01040201 | 17039873 | display open fail | Rendering device initialization failed. | For Windows devices, check the graphics card driver. For mobile devices, check if a device screen is present. |
0x01040202 | 17039874 | display interrupt | The rendering device was interrupted. | Check if the system driver is working correctly. If it is, restart the device. |
0x01030404 | 16974852 | subscribe invalid | Invalid subscription. | Check if the remote user has joined the channel. |
0x01010550 | 16844112 | subscribe not joinchannel | Subscription failed because the user has not joined the channel. | Call the joinchannel API first. |
0x01010551 | 16844113 | subscribe audio stream failed | The subscribed audio stream is invalid. | Check if the remote user has an audio stream to subscribe to. Check if this audio stream is present in the OnRemoteTrackAvailable callback received by the local client. |
0x01010552 | 16844114 | subscribe video stream failed | The subscribed video stream is invalid. | Check if the remote user has a video stream to subscribe to. Check if this video stream is present in the OnRemoteTrackAvailable callback received by the local client. |
0x01070101 | 17236225 | audio buffer full | This error code is returned when you call the custom audio capture API to send audio stream data to the SDK, and the SDK's internal buffer queue is full. | Reduce the external input frequency. Set a wait time of 20 ms and ensure that a single data push does not exceed 40 ms. |
0x01070102 | 17236226 | video buffer full | The SDK's internal buffer queue is full. This applies to the feature for externally providing raw data. | Reduce the external input frequency. Wait for the video keyframe interval before the next input. |