错误码

最近更新时间:2023-03-17 14:16:30

我的收藏
为方便开发者调试和接入腾讯云游戏多媒体引擎产品 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
没有在控制台开通实时语音消息功能或者转文本功能,请在控制台上开通,参见 服务开通指引