Error Code

Last updated: 2020-04-07 17:27:40

    Welcome to the GME SDK. This document describes error codes that may be reported during GME development.

    General Errors

    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

    Client Errors

    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.

    Server Errors

    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.

    Voice Messaging and Speech-to-Text Errors

    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?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help