Welcome to the GME SDK. This document describes error codes that may be reported during GME development.
| Error Code Name | Error Code Value | Cause and Suggested Solution |
|---|---|---|
| AV_ERR_3DVOICE_ERR_NOT_INITED | 7003 | The InitSpatializer API needs to be called first. |
| AV_ERR_NET_REQUEST_FALLED | 7004 | Network request failed. This is generally caused by unstable network. Please see Voice Chat Room Issues for troubleshooting. |
| AV_ERR_CHARGE_OVERDUE | 7005 | Operation failed due to account arrears. You need to check whether your account is in arrears in the Tencent Cloud Console. |
| AV_ERR_AUTH_FIALD | 7006 | Authentication failed. Possible causes: 1. The AppID does not exist or is incorrect; 2. An error occurred while authenticating the authbuff; 3. Authentication expired. |
| AV_ERR_IN_OTHER_ROOM | 7007 | Already in another room. |
| AV_ERR_NO_PERMISSION | 7009 | No permission to perform the operation. |
| AV_ERR_FILE_CANNOT_ACCESS | 7010 | Unable to access the file. |
| AV_ERR_FILE_DAMAGED | 7011 | File is corrupted. |
| AV_ERR_SERVICE_NOT_OPENED | 7012 | Please enable this feature in the console before using it |
| AV_ERR_USER_CANCELED | 7013 | The user actively cancels this operation, such as exit a room without successfully entering the room |
| AV_ERR_LOAD_LIB_FAILED | 7014 | The library file is not loaded properly, please check if it is missing |
| AV_ERR_SDK_NOT_FULL_UPDATE | 7015 | When upgrading the SDK, not all files were upgraded, which caused some module mismatches. Please fully upgrade the SDK |
| AV_ERR_3DVOICE_ERR_FILE_DAMAGED | 7002 | 3D sound effect file is not loaded successfully |
| Error Code Name | Error Code Value | Description | Cause | Suggested Solution |
|---|---|---|---|---|
| AV_ERR_REPEATED_OPERATION | 1001 | Repeated operation | An operation is performed when the same operation is in progress. Operation types include AVContext, room, device, and member. AVContext operations: StartContext/StopContext. Room operations: EnterRoom/ExitRoom. Device operations: enabling/disabling a device. |
Perform the next operation after the ongoing operation is completed. |
| AV_ERR_EXCLUSIVE_OPERATION | 1002 | Exclusive operation | An operation is performed when another operation of the same type is in progress. | Perform the next operation after the ongoing operation is completed. |
| AV_ERR_HAS_IN_THE_STATE | 1003 | Repeated operation | An operation is performed to make an object enter a state when the object is already in this state; for example, when the client is already in a room, it performs an operation to enter the room again. | Regard the current operation as successful since the object is already in the desired state. |
| AV_ERR_INVALID_ARGUMENT | 1004 | Invalid parameter | One or more incorrect parameters are passed in when an SDK API is called; for example, when the client is trying to enter a room, the input room type is not AVRoom::ROOM_TYPE_PAIR or AVRoom::ROOM_TYPE_MULTI. |
Read the relevant API document carefully to get the valid value range for each parameter of each API, and take preventive measures to ensure the correctness of input parameters. |
| AV_ERR_TIMEOUT | 1005 | Timeout | The result of an operation was not returned within the specified time. This error occurs mostly when a signal is transmitted but the network is exceptional; for example, after the client performs an operation to enter a room, the result of the operation is not returned within 30 seconds. | Check whether the network is normal and whether the internet can be accessed, and then try again. |
| AV_ERR_NOT_IMPLEMENTED | 1006 | Not implemented | The relevant feature has not been implemented when an SDK API is called. | Find other alternative methods. |
| AV_ERR_NOT_IN_MAIN_THREAD | 1007 | Not in the main thread | SDK APIs must be called in the main thread, but the client did not call the SDK API in the main thread. | Modify the business logic to ensure that SDK APIs are called in the main thread. |
| AV_ERR_RESOURCE_IS_OCCUPIED | 1008 | Occupied resource | A required resource, such as the camera or screen, is being used. | Identify the specific resource to be used and confirm the reason why it is being used to ensure that SDK features are used at the right time without resource conflict. |
| AV_ERR_CONTEXT_NOT_EXIST | 1101 | Invalid AVContext status |
When an AVContext object is not in the CONTEXT_STATE_STARTED status, the client calls an API that can be called only when the AVContext object is in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_CONTEXT_NOT_STOPPED | 1102 | Invalid AVContext status |
When an AVContext object is not in the CONTEXT_STATE_STOPPED status, the client calls an API that can be called only when the AVContext object is in this status; for example, the client calls AVContext::DestroyContext when the AVContext object is not in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_ROOM_NOT_EXIST | 1201 | Invalid AVRoom status |
When an AVRoom object is not in the ROOM_STATE_ENTERED status, the client calls an API that can be called only when the AVRoom object is in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_ROOM_NOT_EXITED | 1202 | Invalid AVRoom status |
When an AVRoom object is not in the ROOM_STATE_EXITED status, the client calls an API that can be called only when the AVRoom object is in this status; for example, the client calls AVContext::StopContext when the AVRoom object is not in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_DEVICE_NOT_EXIST | 1301 | The device does not exist | The client uses a device that does not exist or has not been initialized. | Verify that the device exists, make sure that the device ID is entered correctly, and use the device only after it is successfully initialized. |
| AV_ERR_ENDPOINT_NOT_EXIST | 1401 | The AVEndpoint object does not exist |
Before a member sent an audio or video file, the client tried to get the AVEndpoint object of the member. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_ENDPOINT_HAS_NOT_VIDEO | 1402 | A member does not initiate a video chat | Before a member initiated a video chat, the client tried to perform an operation that can be completed only after a video chat is initiated; for example, before the member initiates a video chat, the client requests the video image of the member. | Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_TINYID_TO_OPENID_FAILED | 1501 | Failed to convert a tinyid into an identifier. |
After receiving the signal indicating a member's information update, the client needs to convert the relevant tinyid into an identifier; however, the conversion failed because the relevant logic of the IMSDK library or the network was exceptional. |
Check whether the network is normal and check logs to confirm whether the relevant logic of the IMSDK library is normal. |
| AV_ERR_OPENID_TO_TINYID_FAILED | 1502 | Failed to convert an identifier into a tinyid. |
When calling the StartContext API, the client needs to convert the relevant identifier into a tinyid; however, the conversion failed because the relevant logic of the IMSDK library or the network was exceptional, or the client has not logged in. |
Check whether the network is normal, check logs to confirm whether the relevant logic of the IMSDK library is normal, and verify that the IMSDK login API has been successfully called. |
| AV_ERR_DEVICE_TEST_NOT_EXIST | 1601 | Invalid AVDeviceTest status |
When an AVDeviceTest object is not in the DEVICE_TEST_STATE_STARTED status, the client calls an API that can be called only when the AVDeviceTest object is in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_DEVICE_TEST_NOT_STOPPED | 1602 | Invalid AVDeviceTest status |
When an AVDeviceTest object is not in the DEVICE_TEST_STATE_STOPPED status, the client calls an API that can be called only when the AVDeviceTest object is in this status; for example, the client calls AVContext::StopContext when the AVDeviceTest object is not in this status. |
Modify the business logic to ensure that SDK APIs are called at the right time. |
| AV_ERR_INVITE_FAILED | 1801 | Failed to send an invitation | A failure occurred while sending an invitation. | The invitation module is used only for demonstration, and the invitation feature is not supported externally; therefore, this error code can be ignored. |
| AV_ERR_ACCEPT_FAILED | 1802 | Failed to accept an invitation | A failure occurred while accepting an invitation. | The invitation module is used only for demonstration, and the invitation feature is not supported externally; therefore, this error code can be ignored. |
| AV_ERR_REFUSE_FAILED | 1803 | Failed to decline an invitation | A failure occurred while declining an invitation. | The invitation module is used only for demonstration, and the invitation feature is not supported externally; therefore, this error code can be ignored. |
| QAV_ERR_NOT_TRY_NEW_ROOM | 2001 | The client failed to enter a new room and stayed in the original room. | The client failed to switch to a new room and stayed in the current room. | Stay in the current room for normal use. |
| QAV_ERR_TRY_NEW_ROOM_FAILED | 2002 | The client tried to enter a new room but failed and then exited the original room. | The client failed to switch to a new room and then exited the original room. | Enter the room again. |
| Error Code Name | Error Code Value | Description | Cause | Suggested Solution |
|---|---|---|---|---|
| AV_ERR_SERVER_FAILED | 10001 | General error | Locate the specific cause based on the actual error code (in logs) returned from the backend to the client. | View and confirm the validity of the parameters in the room entering API, such as AppID, UIN, and AuthBuffer (please see the documentation). Check whether the relevant parameters in the console match the local ones, whether your account is in arrears, and whether the network environment of your testing devices is in the private network or public network. |
| AV_ERR_SERVER_INVALID_ARGUMENT | 10002 | Invalid parameter | One or more incorrect parameters are passed in when an SDK API is called or an internal SDK signal is sent to the backend. | Ensure the correctness of parameters passed in to SDK API calls. Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| AV_ERR_SERVER_NO_PERMISSION | 10003 | No permission | The client had no permission to use a feature; for example, the client carries an incorrect or expired signature when it tries to enter a room. | Be sure to use a feature after the permission parameters are correctly set. Check whether the AppID and permission key are correct. |
| AV_ERR_SERVER_TIMEOUT | 10004 | Timeout | The result of an operation was not returned within the specified time. | Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| AV_ERR_SERVER_ALLOC_RESOURCE_FAILED | 10005 | Network error | A network error occurred when the client was performing an operation. | View and confirm the validity of the parameters in the room entering API, such as AppID, UIN, and AuthBuffer (please see the documentation). If they are valid, check whether the network environment of your testing devices is in the private network or public network. If it is in the private network, check whether the following URL can be accessed: openmsf.3g.qq.com:15000, and if yes, check whether the following URL can be accessed: cloud.tim.qq.com:15000. |
| AV_ERR_SERVER_ID_NOT_IN_ROOM | 10006 | Not in a room | The client performs an operation when it is not in a room. | Ensure that SDK features are used at the right time. |
| AV_ERR_SERVER_NOT_IMPLEMENT | 10007 | Not implemented | The relevant feature has not been implemented when an SDK API is called. | Find other alternative methods. |
| AV_ERR_SERVER_REPEATED_OPERATION | 10008 | Repeated operation | An operation is performed when another operation of the same type is in progress. | Perform the next operation after the ongoing operation is completed. |
| AV_ERR_SERVER_ID_NOT_IN_ROOM | 10009 | The room does not exist | The client performs an operation when the room does not exist. | Ensure that SDK features are used at the right time. |
| AV_ERR_SERVER_ENDPOINT_NOT_EXIST | 10010 | The member does not exist | An operation related to a nonexistent member is performed. | Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| AV_ERR_SERVER_INVALID_ABILITY | 10011 | Invalid capability | Locate the specific cause based on the actual error code (in logs) returned from the backend to the client. | Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| Error Code Name | Error Code Value | Description | Cause | Suggested Solution |
|---|---|---|---|---|
| QAVPTTERROR_RECORDER_PARAM_NULL | 4097 | Recording error | Empty parameter. | Check whether the API parameters in the code are correct. |
| QAVPTTERROR_RECORDER_INIT_ERROR | 4098 | Recording error | Initialization error. | Check whether the device is occupied, whether the permissions are normal, and whether the initialization is normal. |
| QAVPTTERROR_RECORDER_RECORDING_ERR | 4099 | Recording error | Recording is in progress. | Ensure that the SDK recording feature is used at the right time. |
| QAVPTTERROR_RECORDER_NODATA_ERR | 4100 | Recording error | Audio data is not captured. | Check whether the mic is working properly. |
| QAVPTTERROR_RECORDER_OPENFILE_ERR | 4101 | Recording error | An error occurred while accessing the file during recording. | Ensure the existence of the file and the validity of the file path. |
| QAVPTTERROR_RECORDER_PERMISSION_MIC_ERR | 4102 | Recording error | The mic is not authorized. | Mic permission is required for using the SDK. To add the permission, please see the SDK project configuration document for the corresponding engine or platform. |
| QAVPTTERROR_RECORDER_AUDIO_TOO_SHORT | 4103 | Recording error | The recording duration is too short. | The recording duration should be in ms and longer than 1,000 ms. |
| QAVPTTERROR_RECORDER_RECORD_NOT_START | 4104 | Recording error | No recording operation is started. | Check whether the recording starting API has been called. |
| QAVPTTERROR_UPLOAD_FILE_ACCESSERROR | 8193 | Upload error | An error occurred while accessing the file during upload. | Ensure the existence of the file and the validity of the file path. |
| QAVPTTERROR_UPLOAD_SIGN_CHECK_FAIL | 8194 | Upload error | Signature verification failed. | Check whether the authentication key is correct and whether the voice messaging and speech-to-text feature is initialized. |
| QAVPTTERROR_UPLOAD_COS_INTERNAL_FAIL | 8195 | Upload error | A network error occurred. | Check whether the device can access the internet. |
| QAVPTTERROR_UPLOAD_GET_TOKEN_NETWORK_FAIL | 8196 | Upload error | The network failed while getting the upload parameters. | Check whether the authentication is correct and whether the device can access the internet. |
| QAVPTTERROR_UPLOAD_SYSTEM_INNER_ERROR | 8197 | Upload error | The packet returned during the process of getting the upload parameters is empty. | Check whether the authentication is correct and whether the device network can normally access the external network environment |
| QAVPTTERROR_UPLOAD_RSP_DATA_DECODE_FAIL | 8198 | Upload error | Failed to decode the packet returned during the process of getting the upload parameters. | Check whether the authentication is correct and whether the device can access the internet. |
| QAVPTTERROR_UPLOAD_APPINFO_UNSET | 8200 | Upload error | No appinfo is set. |
Check whether the apply API is called or whether the input parameters are empty. |
| QAVPTTERROR_DOWNLOAD_FILE_ACCESSERROR | 12289 | Download error | An error occurred while accessing the file during download. | Check whether the file path is valid. |
| QAVPTTERROR_DOWNLOAD_SIGN_CHECK_FAIL | 12290 | Download error | Signature verification failed. | Check whether the authentication key is correct and whether the voice messaging and speech-to-text feature is initialized. |
| QAVPTTERROR_DOWNLOAD_COS_INTERNAL_FAIL | 12291 | Download error | Network error. | The server failed to get the audio file. Check whether the API parameter fileid is correct and whether the network is normal. |
| AVPTTERROR_DOWNLOAD_REMOTEFILE_ACCESSERROR | 12292 | Download error | Server file system error. | Check whether the device can access the internet and whether the file exists on the server. |
| QAVPTTERROR_DOWNLOAD_GET_SIGN_NETWORK_FAIL | 12293 | Download error | The HTTP network failed during the process of getting the download parameters. | Check whether the device can access the internet. |
| QAVPTTERROR_DOWNLOAD_SYSTEM_INNER_ERROR | 12294 | Download error | The packet returned during the process of getting the download parameters is empty. | Check whether the device can access the internet. |
| QAVPTTERROR_DOWNLOAD_GET_SIGN_RSP_DATA_DECODE_FAIL | 12295 | Download error | Failed to decode the packet returned during the process of getting the download parameters. | Check whether the device can access the internet. |
| QAVPTTERROR_DOWNLOAD_APPINFO_UNSET | 12297 | Download error | No appinfo is set. |
Check whether the authentication key is correct and whether the voice messaging and speech-to-text feature is initialized. |
| QAVPTTERROR_PLAYER_INIT_ERR | 20481 | Playback error | Initialization error. | Check whether the device is being used, whether the permissions are normal, and whether the initialization is normal. |
| QAVPTTERROR_PLAYER_PLAYING_ERR | 20482 | Playback error | During playback, the client tried to interrupt and play back the next one but failed (which should succeed normally). | Check whether the code logic is correct. |
| QAVPTTERROR_PLAYER_PARAM_NULL | 20483 | Playback error | Parameter is empty. | Check whether the API parameters in the code are correct. |
| QAVPTTERROR_PLAYER_OPENFILE_ERR | 20484 | Playback error | An error occurred while accessing the file during playback | Ensure the existence of the file and the validity of the file path. |
| QAVPTTERROR_PLAYER_PLAYER_NOT_START_ERR | 20485 | Playback error | Playback is not started. | Ensure the existence of the file and the validity of the file path. |
| QAVPTTERROR_S2T_INTERNAL_ERROR | 32769 | Speech-to-text conversion error | An internal error occurred. | Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| QAVPTTERROR_S2T_NETWORK_FAIL | 32770 | Speech-to-text conversion error | Network failed. | Check whether the device can access the internet. |
| QAVPTTERROR_S2T_RSP_DATA_DECODE_FAIL | 32772 | Speech-to-text conversion error | Failed to decode the returned packet. | Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| QAVPTTERROR_S2T_APPINFO_UNSET | 32774 | Speech-to-text conversion error | The appinfo is not set. |
Check whether the authentication key is correct and whether the voice messaging and speech-to-text feature is initialized. |
| QAVPTTERROR_STREAMIN_RECORD_SUC_REC_FAIL | 32775 | Streaming speech-to-text conversion error | Streaming speech-to-text conversion failed, but recording succeeded. | Check whether the network is connected correctly and whether the permission key is correct. |
| QAVPTTERROR_S2T_SIGN_CHECK_FAIL | 32776 | authbuffer check failed. |
authbuffer check failed. |
Check whether authbuffer is correct. |
| QAVPTTERROR_STREAMIN_UPLOADANDRECORD_SUC_REC_FAIL | 32777 | Streaming speech-to-text conversion error | Streaming speech-to-text conversion failed, but recording and upload succeeded. | Check whether there are any errors in the code. |
| QAVPTTERROR_S2T_PARAM_NULL | 32784 | Speech-to-text conversion error | Incorrect speech-to-text conversion parameter. | Check whether the API parameter fileid in the code is empty. |
| QAVPTTERROR_S2T_AUTO_SPEECH_REC_ERROR | 32785 | Speech-to-text conversion error | Speech-to-text translation returned an error. | Error with the backend of voice messaging and speech-to-text feature. Analyze logs, get the actual error code returned from the backend to the client, and ask backend personnel for assistance. |
| QAVPTTERROR_ERR_VOICE_STREAMIN_RUNING_ERROR | 32786 | Streaming speech-to-text conversion error | Streaming speech-to-text conversion failed. | During streaming recording, wait for the execution result of the streaming recording API to return. |
Was this page helpful?