游戏多媒体引擎错误码-客户端 API-文档中心-腾讯云

为方便开发者调试和接入腾讯云游戏多媒体引擎产品 API，这里向您介绍适用于游戏多媒体引擎开发的错误码文档。
通用错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_NET_REQUEST_FALLED
7004
网络请求失败，一般由网络状态不稳定引起，可参见 实时语音房间问题 进行排查
AV_ERR_CHARGE_OVERDUE
7005
账号欠费导致失败，需要在腾讯云控制台上查看是否欠费
AV_ERR_AUTH_FIALD
7006
鉴权失败 有以下几个原因：
1. AppID 不存在或者错误。
2. authbuff 鉴权错误。
3. 鉴权过期。
AV_ERR_REPEATED_OPERATION
1001
已经在进行某种操作，再次去做同样的操作，则会产生这个错误。操作类别主要有：AVContext 类、房间类、设备类、成员类。AVContext 类型的操作：StartContext/StopContext。房间类型的操作：EnterRoom/ExitRoom。设备类型的操作：打开/关闭某个设备。建议等待上一个操作完成后再进行下一个操作
AV_ERR_EXCLUSIVE_OPERATION
1002
已经在进行某种操作，再次去做同类型的其他操作，则会产生这个错误。请等待上一个操作完成后再进行下一个操作
AV_ERR_HAS_IN_THE_STATE
1003
对象已经处于某种状态，再去做使得它进入这种状态的操作时，则会产生这个错误。如已经在房间中，再去做进入房间的操作，就会产生这个错误，由于已经处于所要状态，可以认为该操作已经成功，当作成功来处理
AV_ERR_INVALID_ARGUMENT
1004
调用 SDK 接口时，传入错误的参数，则会产生这个错误。如进入房间时，传入的房间类型不等于 AVRoom::ROOM_TYPE_PAIR 或 AVRoom::ROOM_TYPE_MULTI，就会产生这个错误。请详细阅读 API 文档，获取每个接口的每个参数的有效取值范围，保证传入参数的正确性并进行相应的预防处理。
AV_ERR_TIMEOUT
1005
进行某个操作，在规定的时间内，还未返回操作结果，则会产生这个错误。多数情况下，涉及到信令传输的、且网络出问题的情况下，才容易产生这个错误。如执行进入房间操作时，30s后还没有返回进入房间操作完成的结果的话，就会产生这个错误。请确认网络是否有问题，是否能连接到外网环境，并尝试重试。
AV_ERR_NOT_IMPLEMENTED
1006
调用 SDK 接口时，如果相应的功能还未支持，则会产生这个错误。
AV_ERR_NOT_IN_MAIN_THREAD
1007
SDK 对外接口要求在主线程执行，如果业务侧调用 SDK 接口时，没有在主线程调用，则会产生这个错误。请修改业务侧逻辑，确保在主线程调用 SDK 接口。
AV_ERR_CONTEXT_NOT_EXIST
1101
当 AVContext 对象未处于 CONTEXT_STATE_STARTED 状态，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。修改业务侧逻辑，确保调用 SDK 接口时机的正确性。
AV_ERR_CONTEXT_NOT_STOPPED
1102
当 AVContext 对象未处于 CONTEXT_STATE_STOPPED 状态，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。如不在这种状态下，去调用 AVContext::DestroyContext 时，就会产生这个错误。修改业务侧逻辑，确保调用 SDK 接口的时机的正确性。
实时语音功能错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_IN_OTHER_ROOM
7007
已经在其它房间，需要退房后成功后再进行操作。
AV_ERR_ROOM_NOT_EXIST
1201
未进房的状态下，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。请确保调用 SDK 接口的时机的正确性。
AV_ERR_ROOM_NOT_EXITED
1202
未退房的状态下，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。如不在这种状态下，去调用 AVContext::StopContext 时，就会产生这个错误。请确保调用 SDK 接口的时机的正确性。
AV_ERR_DEVICE_NOT_EXIST
1301
当设备不存在或者设备初始化未完成时，去使用设备，则会产生这个错误。请确认设备是否真的存在，确保设备 ID 填写的正确性，确保在设备初始化成功后再去使用设备。
AV_ERR_SERVER_FAILED
10001
进房出现未知错误：
1. 请查看并确认进房 API 中的参数，如 AppID， UIN， AuthBuffer 的合法性（参照文档）。
2. 请查看控制台上的相关参数是否与本地的一致。
3. 请查看控制台是否欠费。
4. 检查开发者测试设备网络环境，是在开发者内网环境还是外网环境。
AV_ERR_SERVER_NO_PERMISSION
10003
被剔除出实时语音房间
AV_ERR_SERVER_REQUEST_ROOM_ADDRESS_FAIL
10004
进入实时语音房间失败，建议参见 开发问题收集日志，联系 GME 开发者协助进行分析错误，解决问题。
AV_ERR_SERVER_CONNECT_ROOM_FAIL
10005
进入实时语音房间失败，建议参见 开发问题收集日志，联系 GME 开发者协助进行分析错误，解决问题。
语音消息错误码
录制音频相关错误码
错误码名称
错误码值
原因及建议方案
VOICE_RECORDER_PARAM_NULL
4097
参数为空，请检查代码中接口参数是否正确
VOICE_RECORDER_INIT_ERROR
4098
初始化错误：
1. 请检查设备是否被占用。
2. 相关权限是否正常。
3. 是否初始化正常。
VOICE_RECORDER_RECORDING_ERROR
4099
调用录制接口时，正在录制状态中。请确保在正确的时机使用 SDK 录制功能。
VOICE_RECORDER_NO_AUDIO_DATA_WARN
4100
没有采集到音频数据，请检查麦克风设备是否正常。
VOICE_RECORDER_OPENFILE_ERROR
4101
录音时，录制文件访问错误，
1. 请确保文件存在。
2. 请检查文件路径的合法性。
VOICE_RECORDER_MIC_PERMISSION_ERROR
4102
麦克风未授权错误。使用 SDK 需要麦克风权限，添加权限请参考对应引擎或平台的 SDK 工程配置文档。
VOICE_RECORD_AUDIO_TOO_SHORT
4103
录音时间太短：
1. 限制录音时长的单位为毫秒，请检查参数是否正确。
2. 录音时长要1000毫秒以上才能成功录制。
VOICE_RECORD_NOT_START
4104
没有启动录音操作，需要检查是否已经调用启动录音接口。
上传音频相关错误码
错误码名称
错误码值
原因及建议方案
VOICE_UPLOAD_FILE_ACCESSERROR
8193
上传文件时，文件访问错误，1、请确保文件存在，2、请检查文件路径的合法性。
VOICE_UPLOAD_SIGN_CHECK_FAIL
8194
签名校验失败错误：
1. 请检查鉴权密钥是否正确。
2. 请检查是否有初始化离线语音。
VOICE_UPLOAD_COS_INTERNAL_FAIL
8195
网络错误导致上传cos失败，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_UPLOAD_GET_TOKEN_NETWORK_FAIL
8196
上传文件过程中失败：
1. 请检查鉴权是否正确。
2. 请检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_UPLOAD_SYSTEM_INNER_ERROR
8197
上传文件过程中失败：
1. 请检查鉴权是否正确。
2. 请检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_UPLOAD_RSP_DATA_DECODE_FAIL
8198
上传文件过程中失败：
1. 请检查鉴权是否正确。
2. 请检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_UPLOAD_APPINFO_UNSET
8200
鉴权未设置：
1. 请检查 applyAuthBuffer 接口是否有调用。
2. 请检查 applyAuthBuffer 接口入参是否为空
下载音频相关错误码
错误码名称
错误码值
原因及建议方案
VOICE_DOWNLOAD_FILE_ACCESS_ERROR
12289
下载文件时，路径访问出错，请检查文件路径的合法性。
VOICE_DOWNLOAD_SIGN_CHECK_FAIL
12290
签名校验失败：
1. 请检查鉴权密钥是否正确。
2. 请检查是否有初始化离线语音。
VOICE_DOWNLOAD_COS_INTERNAL_FAIL
12291
获取语音文件失败：
1. 请检查接口参数 fileid 是否正确。
2. 请检查网络是否正常。
VOICE_DOWNLOAD_REMOTEFILE_ACCESS_ERROR
12292
获取语音文件失败：
1. 请检查接口参数 fileid 是否正确。
2. 请检查网络是否正常。
VOICE_DOWNLOAD_GET_SIGN_NETWORK_FAIL
12293
网络错误导致获取语音文件，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_DOWNLOAD_SYSTEM_INNER_ERROR
12294
网络错误导致获取语音文件，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_DOWNLOAD_GET_SIGN_RSP_DATA_DECODE_FAIL
12295
网络错误导致获取语音文件，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_DOWNLOAD_APPINFO_UNSET
12297
鉴权未设置：
1. 请检查 applyAuthBuffer 接口是否有调用。
2. 请检查 applyAuthBuffer 接口入参是否为空。
播放音频相关错误码
错误码名称
错误码值
原因及建议方案
VOICE_PLAY_INIT_ERROR
20481
初始化错误：
1. 请检查设备是否被占用。
2. 相关权限是否正常。
3. 是否初始化正常。
VOICE_PLAY_PLAYING_ERROR
20482
正在播放中，试图打断并播放下一个失败了，可以先暂停播放后再继续播放音频文件。
VOICE_PLAY_PARAM_NULL
20483
参数为空导致出错，请检查代码中接口参数是否正确。
VOICE_PLAY_OPEN_FILE_ERROR
20484
打开音频文件失败：
1. 请确保文件存在。
2. 请检查文件路径的合法性。
VOICE_PLAY_NOT_START
20485
音频文件无法开始播放：
1. 请确保文件存在。
2. 请检查文件路径的合法性。
VOICE_PLAYER_SILKFILE_NULL
20486
音频播放文件内容为空，请确保文件内容正常
VOICE_PLAYER_SILKFILE_READ_ERROR
20487
读取音频文件失败，请确保文件格式正确
VOICE_PLAYER_INIT_DEVICE_ERROR
20488
设备初始化失败，请检查扬声器设备是否正常。
VOICE_PLAYER_ERROR
20489
播放失败，系统内部错误，例如线程创建，内存申请申请释放出错，建议重新启动播放音频文件
语音转文字错误码
错误码名称
错误码值
原因及建议方案
VOICE_ERR_VOICE_S2T_SYSTEM_INTERNAL_ERROR
32769
系统问题导致转文本失败，建议参见 开发问题收集日志，联系 GME 开发者协助进行分析错误，解决问题。
VOICE_ERR_VOICE_S2T_NETWORK_FAIL
32770
网络问题导致转文本失败，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_ERR_VOICE_S2T_RSP_DATA_DECODE_FAIL
32772
网络错误导致转文本失败，检查设备网络是否可以正常访问外网环境，参见 如何检查网络。
VOICE_ERR_VOICE_S2T_APPINFO_UNSET
32774
鉴权未设置：
1. 请检查 applyAuthBuffer 接口是否有调用。
2. 请检查 applyAuthBuffer 接口入参是否为空。
VOICE_ERR_VOICE_STREAMIN_RECORD_SUC_REC_FAIL
32775
流式语音转文本失败，但是录音成功了，请检查鉴权密钥是否正确
VOICE_ERR_VOICE_S2T_SIGN_CHECK_FAIL
32776
签名校验失败：
1. 请检查鉴权密钥是否正确。
2. 请检查是否有初始化离线语音。
VOICE_ERR_VOICE_STREAMIN_UPLOADANDRECORD_SUC_REC_FAIL
32777
流式语音转文本失败，但是录音成功了，上传也成功了，请检查网络是否正确，并重新调用接口将文件进行转文本操作
VOICE_ERR_VOICE_S2T_PARAM_NULL
32784
语音转文本参数错误，请检查代码中接口参数 fileid 是否为空。
VOICE_ERR_VOICE_S2T_AUTO_SPEECH_REC_ERROR
32785
语音转文本翻译返回错误，建议参见 开发问题收集日志，联系 GME 开发者协助进行分析错误，解决问题。
VOICE_ERR_VOICE_STREAMIN_RUNING_ERROR
32786
调用接口时在流式语音消息转文本状态当中，请等待接口执行结果返回。
VOICE_ERR_VOICE_S2T_TRNSLATE_SERVICE_NOT_AVALIABLE
32787
翻译功能不支持。建议参见 开发问题收集日志，联系 GME 开发者协助进行分析错误，解决问题。
VOICE_ERR_VOICE_S2T_TRNSLATE_LANGUAGE_NOT_SUPPORTED
32788
调用翻译的语言参数不支持，请重新检查接口传入参数
VOICE_ERR_VOICE_STREAMING_ASR_ERROR
327698
请求流式语音消息转文本服务时出现错误，请重新上传录制文件（UploadRecordedFile），然后调用录音文件转文本接口（SpeechToText）。
伴奏功能错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_ACC_OPENFILE_FAILED
4001
打开文件失败，检查文件是否存在
AV_ERR_ACC_FILE_FORAMT_NOTSUPPORT
4002
不支持的文件格式，查看文件格式是否在支持范围内
AV_ERR_ACC_DECODER_FAILED
4003
解码失败，查看文件格式是否在支持范围内
AV_ERR_ACC_BAD_PARAM
4004
参数错误，需要重新检查参数
AV_ERR_ACC_MEMORY_ALLOC_FAILED
4005
内存不足导致内存分配失败，建议清理设备内存
AV_ERR_ACC_CREATE_THREAD_FAILED
4006
创建线程失败，建议清理设备内存
AV_ERR_ACC_STATE_ILLIGAL
4007
状态非法，建议清理设备内存
AV_ERR_START_ACC_FIRST
4008
设备采集播放延迟录制开始前,要先开启伴奏
AV_ERR_START_ACC_IS_STARTED
4009
设备采集播放延迟预览开始前,要先停止伴奏
AV_ERR_HARDWARE_TEST_RECORD_IS_STARTED
4010
设备采集播放延迟预览前,要先停止录制
AV_ERR_HARDWARE_TEST_PREVIEW_IS_STARTED
4011
设备采集播放延迟录制开始前,要先停止预览
AV_ERR_HARDWARE_TEST_PREVIEW_DATA_IS_EMPTY
4012
设备采集播放延迟录制开始前,要先停止预览
音效功能错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_EFFECT_OPENFILE_FAILED
4051
打开文件失败，建议检查文件是否存在，文件路径是否正确
AV_ERR_EFFECT_FILE_FORAMT_NOTSUPPORT
4052
不支持的文件格式，建议重新检查文件格式
AV_ERR_EFFECT_DECODER_FAILED
4053
解码失败，建议重新检查文件格式
AV_ERR_EFFECT_BAD_PARAM
4054
参数错误，建议检查接口传入参数是否正常
AV_ERR_EFFECT_MEMORY_ALLOC_FAILED
4055
内存分配失败，建议清理设备内存
AV_ERR_EFFECT_CREATE_THREAD_FAILED
4056
创建线程失败，建议清理设备内存
AV_ERR_EFFECT_STATE_ILLIGAL
4057
状态非法，建议清理设备内存
实时语音录制错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_RECORD_OPENFILE_FAILED
5001
打开文件失败，建议检查文件是否存在，文件路径是否正确
AV_ERR_RECORD_FILE_FORAMT_NOTSUPPORT
5002
不支持的文件格式，建议重新检查文件格式
AV_ERR_RECORD_DECODER_FAILED
5003
解码失败，建议重新检查文件格式
AV_ERR_RECORD_BAD_PARAM
5004
参数错误，建议检查接口传入参数是否正常
AV_ERR_RECORD_MEMORY_ALLOC_FAILED
5005
内存分配失败，建议清理设备内存
AV_ERR_RECORD_CREATE_THREAD_FAILED
5006
创建线程失败，建议清理设备内存
AV_ERR_RECORD_STATE_ILLIGAL
5007
状态非法，建议清理设备内存
其他错误码
错误码名称
错误码值
原因及建议方案
AV_ERR_3DVOICE_ERR_FILE_DAMAGED
7002
3D 音效文件未加载成功
AV_ERR_3DVOICE_ERR_NOT_INITED
7003
使用 3D 音效功能，需要先调用 InitSpatializer 接口
AV_ERR_NO_PERMISSION
7009
要进行某个操作的时候，没有权限，检查是否已经申请权限
AV_ERR_FILE_CANNOT_ACCESS
7010
无法访问文件，检查文件是否存在，路径是否正确
AV_ERR_FILE_DAMAGED
7011
文件被损坏，请检查文件是否可用
AV_ERR_SERVICE_NOT_OPENED
7012
没有在控制台开通实时语音功能，请在控制台上开通，参见 服务开通指引
AV_ERR_USER_CANCELED
7013
用户主动取消此操作，例如没进房成功就进行退房操作
AV_ERR_LOAD_LIB_FAILED
7014
库文件没有正常加载，请检查库文件是否缺失，以及所使用的功能，是否有对应的库文件存在，参见 库文件对应功能
AV_ERR_SDK_NOT_FULL_UPDATE
7015
升级 SDK 时，没有升级所有的文件，导致某些模块不匹配，请全量升级 SDK，参见 SDK 版本升级指引
AV_ERR_MUTESWITCH_DECTECT_ERR
7018
iOS 静音开关检测错误，查看是否是在 iOS 机型上调用
AV_ERR_SERVICE_NOT_OPENED
7022
没有在控制台开通实时语音消息功能或者转文本功能，请在控制台上开通，参见 服务开通指引

错误码名称	错误码值	原因及建议方案
AV_ERR_NET_REQUEST_FALLED	7004	网络请求失败，一般由网络状态不稳定引起，可参见实时语音房间问题进行排查
AV_ERR_CHARGE_OVERDUE	7005	账号欠费导致失败，需要在腾讯云控制台上查看是否欠费
AV_ERR_AUTH_FIALD	7006	鉴权失败有以下几个原因： 1. AppID 不存在或者错误。 2. authbuff 鉴权错误。 3. 鉴权过期。
AV_ERR_REPEATED_OPERATION	1001	已经在进行某种操作，再次去做同样的操作，则会产生这个错误。操作类别主要有：AVContext 类、房间类、设备类、成员类。AVContext 类型的操作：StartContext/StopContext。房间类型的操作：EnterRoom/ExitRoom。设备类型的操作：打开/关闭某个设备。建议等待上一个操作完成后再进行下一个操作
AV_ERR_EXCLUSIVE_OPERATION	1002	已经在进行某种操作，再次去做同类型的其他操作，则会产生这个错误。请等待上一个操作完成后再进行下一个操作
AV_ERR_HAS_IN_THE_STATE	1003	对象已经处于某种状态，再去做使得它进入这种状态的操作时，则会产生这个错误。如已经在房间中，再去做进入房间的操作，就会产生这个错误，由于已经处于所要状态，可以认为该操作已经成功，当作成功来处理
AV_ERR_INVALID_ARGUMENT	1004	调用 SDK 接口时，传入错误的参数，则会产生这个错误。如进入房间时，传入的房间类型不等于 AVRoom::ROOM_TYPE_PAIR 或 AVRoom::ROOM_TYPE_MULTI，就会产生这个错误。请详细阅读 API 文档，获取每个接口的每个参数的有效取值范围，保证传入参数的正确性并进行相应的预防处理。
AV_ERR_TIMEOUT	1005	进行某个操作，在规定的时间内，还未返回操作结果，则会产生这个错误。多数情况下，涉及到信令传输的、且网络出问题的情况下，才容易产生这个错误。如执行进入房间操作时，30s后还没有返回进入房间操作完成的结果的话，就会产生这个错误。请确认网络是否有问题，是否能连接到外网环境，并尝试重试。
AV_ERR_NOT_IMPLEMENTED	1006	调用 SDK 接口时，如果相应的功能还未支持，则会产生这个错误。
AV_ERR_NOT_IN_MAIN_THREAD	1007	SDK 对外接口要求在主线程执行，如果业务侧调用 SDK 接口时，没有在主线程调用，则会产生这个错误。请修改业务侧逻辑，确保在主线程调用 SDK 接口。
AV_ERR_CONTEXT_NOT_EXIST	1101	当 AVContext 对象未处于 CONTEXT_STATE_STARTED 状态，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。修改业务侧逻辑，确保调用 SDK 接口时机的正确性。
AV_ERR_CONTEXT_NOT_STOPPED	1102	当 AVContext 对象未处于 CONTEXT_STATE_STOPPED 状态，去调用需要处于这个状态才允许调用的接口时，则会产生这个错误。如不在这种状态下，去调用 AVContext::DestroyContext 时，就会产生这个错误。修改业务侧逻辑，确保调用 SDK 接口的时机的正确性。

错误码

本页目录：

通用错误码

实时语音功能错误码

语音消息错误码

录制音频相关错误码

上传音频相关错误码

下载音频相关错误码

播放音频相关错误码

语音转文字错误码

伴奏功能错误码

音效功能错误码

实时语音录制错误码

其他错误码