All Products
Search
Document Center

ApsaraVideo Live:Error codes

Last Updated:Feb 04, 2026

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

  • Your account has an overdue payment.

  • The token has expired. You can check this using the timestamp parameter.

  • The AppId and AppKey are incorrect or do not match. An AppId corresponds to a unique AppKey.

  • An authentication parameter is incorrect.

Check the following items:

  • Confirm that your account balance is sufficient.

  • Confirm whether the token has expired. You can check this using the timestamp parameter, converted to UTC+8. In some cases, the timestamp is the expiration time. In other cases, the expiration time is the timestamp plus 48 hours.

  • Make sure that the AppId and AppKey match. An AppId corresponds to a unique AppKey.

  • Confirm that the authentication parameters are correct.

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.

  • Run the sample code provided by Alibaba Cloud with the same parameters to compare and validate the results.

  • Check if the authentication parameters are consistent with the parameters passed to the SDK.

  • Check if the correct algorithm is used.

0x01030101

16974081

bad param

An invalid parameter was used.

  • Run the sample code provided by Alibaba Cloud with the same parameters to compare and validate the results.

  • Check if the parameters used for token calculation follow the naming conventions, such as string length and use of special characters.

  • Check if the correct algorithm is 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.