错误码

最近更新时间:2020-07-21 16:58:19

为方便开发者调试和接入腾讯云游戏多媒体引擎产品 API,这里向您介绍适用于游戏多媒体引擎开发的错误码文档。

一般性错误

错误码名称 错误码值 原因及建议方案
AV_ERR_3DVOICE_ERR_NOT_INITED 7003 需要先调用 InitSpatializer 接口
AV_ERR_NET_REQUEST_FALLED 7004 网络请求失败,一般由网络状态不稳定引起,可参考 实时语音房间问题 进行排查
AV_ERR_CHARGE_OVERDUE 7005 账号欠费导致失败,需要在腾讯云控制台上查看是否欠费
AV_ERR_AUTH_FIALD 7006 鉴权失败 有以下几个原因:1. AppID 不存在或者错误,2. authbuff 鉴权错误,3. 鉴权过期
AV_ERR_IN_OTHER_ROOM 7007 已经在其它房间
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
AV_ERR_3DVOICE_ERR_FILE_DAMAGED 7002 3D 音效文件未加载成功

实时语音客户端错误

错误码名称 错误码值 含义 原因 建议方案    
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_RESOURCE
_IS_OCCUPIED
1008 资源被占用 当需要用到某种资源,如摄像头、屏幕等,而这些资源已经被占用了,则会产生这个错误。 确认具体要用到哪些资源,及这样资源为什么被占用了,确保在正确的时机使用 SDK 相关功能以保证资源使用不冲突。
AV_ERR_CONTEXT
_NOT_EXIST
1101 AVContext 状态问题 当 AVContext 对象未处于 CONTEXT_STATE_STARTED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口时机的正确性。
AV_ERR_CONTEXT
_NOT_STOPPED
1102 AVContext 状态问题 当 AVContext 对象未处于 CONTEXT_STATE_STOPPED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。如不在这种状态下,去调用 AVContext::DestroyContext 时,就会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_ROOM
_NOT_EXIST
1201 AVRoom 状态问题 当 AVRoom 对象未处于 ROOM_STATE_ENTERED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_ROOM
_NOT_EXITED
1202 AVRoom 状态问题 当 AVRoom 对象未处于 ROOM_STATE_EXITED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。如不在这种状态下,去调用 AVContext::StopContext 时,就会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_DEVICE
_NOT_EXIST
1301 设备不存在 当设备不存在或者设备初始化未完成时,去使用设备,则会产生这个错误。 确认设备是否真的存在,确保设备 ID 填写的正确性,确保在设备初始化成功后再去使用设备。
AV_ERR_ENDPOINT
_NOT_EXIST
1401 AVEndpoint 对象不存在 当成员没有在发语音或视频文件时,去获取它的 AVEndpoint 对象时,就可能产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_ENDPOINT
_HAS_NOT_VIDEO
1402 成员没有发视频 当成员没有在发视频时,去做需要成员发视频的相关操作时,就可能产生这个错误。如当某个成员没有发送视频时,去请求他的画面,就会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_TINYID_TO
_OPENID_FAILED
1501 tinyid 转 identifier 失败 当收到某个成员信息更新的信令时,需要去把 tinyid 转成 identifier,如果 IMSDK 库相关逻辑存在问题、网络存在问题等,则会产生这个错误。 确认网络是否存在问题,查看日志确认 IMSDK 相关逻辑是否存在问题。
AV_ERR_OPENID_TO
_TINYID_FAILED
1502 identifier 转 tinyid 失败 当调用 StartContext 接口时,需要去把 identifier 转成 tinyid,如果 IMSDK 库相关逻辑存在问题、网络存在问题、没有处于登录态时等,则会产生这个错误。 确认网络是否存在问题,查看日志确认 IMSDK 相关逻辑是否存在问题,确认已经成功调用 IMSDK 的登录接口。
AV_ERR_DEVICE
_TEST_NOT_EXIST
1601 AVDeviceTest 状态问题 当 AVDeviceTest 对象未处于 DEVICE_TEST_STATE_STARTED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_DEVICE
_TEST_NOT_STOPPED
1602 AVDeviceTest 状态问题 当 AVDeviceTest 对象未处于 DEVICE_TEST_STATE_STOPPED 状态,去调用需要处于这个状态才允许调用的接口时,则会产生这个错误。如不在这种状态下,去调用 AVContext::StopContext 时,就会产生这个错误。 修改业务侧逻辑,确保调用 SDK 接口的时机的正确性。
AV_ERR_INVITET
_FAILED
1801 发送邀请失败 发送邀请时产生的失败。 邀请模块只是用于 DEMO 演示方便用,对外暂不支持邀请功能,所以业务侧不需要处理这些错误码。
AV_ERR_ACCEPTT
_FAILED
1802 接受邀请失败 接受邀请时产生的失败。 邀请模块只是用于 DEMO 演示方便用,对外暂不支持邀请功能,所以业务侧不需要处理这些错误码。
AV_ERR_REFUSE
_FAILED
1803 拒绝邀请失败 拒绝邀请时产生的失败。 邀请模块只是用于 DEMO 演示方便用,对外暂不支持邀请功能,所以业务侧不需要处理这些错误码。
QAV_ERR_NOT_TRY
_NEW_ROOM
2001 没有尝试进入新房间,将停留在旧房间。 切换到新房间失败,但仍然在当前房间 在当前房间仍可以正常使用。
QAV_ERR_TRY_NEW
_ROOM_FAILED
2002 尝试进入新房间,但失败了,旧房间也将关闭。 切换到新房间失败,同时已退出原来的房间 退出房间,重新进入。

实时语音服务端错误

错误码名称 错误码值 含义 原因 建议方案
AV_ERR_SERVER_FAILED 10001 一般错误 具体原因需要通过分析日志确认后台返回给客户端的真正错误码才能知道。 查看并确认进房 API 中的参数,如 AppID, UIN, AuthBuffer 的合法性(参照文档)。请查看控制台上的相关参数是否与本地的一致。请查看控制台是否欠费。检查开发者测试设备网络环境,是在开发者内网环境还是外网环境。
AV_ERR_SERVER
_INVALID_ARGUMENT
10002 错误参数 调用 SDK 接口时,或 SDK 内部发送信令给后台时,传了错误的参数。 确保调用 SDK 接口时所传的参数的正确性。分析日志,获取后台返回给客户端的真正错误码,并联系后台同事协助解决。
AV_ERR_SERVER
_NO_PERMISSION
10003 没有权限 没有权限使用某个功能。如进入房间时所带的签名错误或过期,就会产生这个错误。 确保在设置正确的权限参数后才去使用相应的功能。检查 AppID 及权限密钥是否正确。
AV_ERR_SERVER_TIMEOUT 10004 超时 进行某个操作,在规定的时间内,还未返回操作结果,则会产生这个错误。 分析日志,获取后台返回给客户端的真正错误码,并联系后台同事协助解决。
AV_ERR_SERVER_ALLOC
_RESOURCE_FAILED
10005 网络错误 执行某些操作时,网络错误 看并确认进房 API 中的参数,例如 AppID, UIN, AuthBuffer 的合法性(参照文档)。如果合法,检查开发者测试设备网络环境,是在开发者内网环境还是外网环境。如果是开发者内网,请开发者探测下 url:openmsf.3g.qq.com:15000 是否能够连接上。如上 url 成功连接,请探测下 url:cloud.tim.qq.com:15000 是否能够连通。
AV_ERR_SERVER
_ID_NOT_IN_ROOM
10006 不在房间内 在不在房间内时,去执行某些操作,则会产生这个错误。 确保在正确的时机使用 SDK 相关功能
AV_ERR_SERVER
_NOT_IMPLEMENT
10007 未实现 调用 SDK 接口时,如果相应的功能还未支持,则会产生这个错误。 暂不支持该功能,找其他替代方案。
AV_ERR_SERVER
_REPEATED_OPERATION
10008 重复操作 已经在进行某种操作,再次去做同类型的其他操作,则会产生这个错误。 等待上一个操作完成后再进行下一个操作。
AV_ERR_SERVER
_ROOM_NOT_EXIST
10009 房间不存在 房间不存在时,去执行某些操作,则会产生这个错误。 确保在正确的时机使用 SDK 相关功能
AV_ERR_SERVER
_ENDPOINT_NOT_EXIST
10010 成员不存在 某个成员不存在时,去执行该成员相关的操作,则会产生这个错误。 分析日志,获取后台返回给客户端的真正错误码,并联系后台同事协助解决。
AV_ERR_SERVER
_INVALID_ABILITY
10011 错误能力 具体原因需要通过分析日志确认后台返回给客户端的真正错误码才能知道。 分析日志,获取后台返回给客户端的真正错误码,并联系后台同事协助解决。

语音转文字错误

错误码名称 错误码值 含义 原因 建议方案
QAVPTTERROR_RECORDER
_PARAM_NULL
4097 录音错误 参数为空 检查代码中接口参数是否正确。
QAVPTTERROR_RECORDER
_INIT_ERROR
4098 录音错误 初始化错误 检查设备是否被占用,或者权限是否正常,是否初始化正常。
QAVPTTERROR_RECORDER
_RECORDING_ERR
4099 录音错误 正在录制中 确保在正确的时机使用 SDK 录制功能。
QAVPTTERROR_RECORDER
_NODATA_ERR
4100 录音错误 没有采集到音频数据 检查麦克风设备是否正常。
QAVPTTERROR_RECORDER
_OPENFILE_ERR
4101 录音错误 录音时,录制文件访问错误 确保文件存在,文件路径的合法性。
QAVPTTERROR_RECORDER
_PERMISSION_MIC_ERR
4102 录音错误 麦克风未授权错误 使用 SDK 需要麦克风权限,添加权限请参考对应引擎或平台的 SDK 工程配置文档。
QAVPTTERROR_RECORDER
_AUDIO_TOO_SHORT
4103 录音错误 录音时间太短错误 首先,限制录音时长的单位为毫秒,检查参数是否正确;其次,录音时长要1000毫秒以上才能成功录制。
QAVPTTERROR_RECORDER
_RECORD_NOT_START
4104 录音错误 没有启动录音操作 检查是否已经调用启动录音接口。
QAVPTTERROR_UPLOAD
_FILE_ACCESSERROR
8193 上传错误 上传文件时,文件访问错误 确保文件存在,文件路径的合法性。
QAVPTTERROR_UPLOAD
_SIGN_CHECK_FAIL
8194 上传错误 签名校验失败错误 检查鉴权密钥是否正确,检查是否有初始化离线语音。
QAVPTTERROR_UPLOAD
_COS_INTERNAL_FAIL
8195 上传错误 网络错误 检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_UPLOAD
_GET_TOKEN_NETWORK_FAIL
8196 上传错误 获取上传参数过程中网络失败 检查鉴权是否正确,检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_UPLOAD
_SYSTEM_INNER_ERROR
8197 上传错误 获取上传参数过程中回包数据为空 检查鉴权是否正确,检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_UPLOAD
_RSP_DATA_DECODE_FAIL
8198 上传错误 获取上传参数过程中回包解包失败 检查鉴权是否正确,检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_UPLOAD
_APPINFO_UNSET
8200 上传错误 没有设置 appinfo 检查 apply 接口是否有调用,或者入参是否为空。
QAVPTTERROR_DOWNLOAD
_FILE_ACCESSERROR
12289 下载错误 下载文件时,文件访问错误 检查文件路径是否合法。
QAVPTTERROR_DOWNLOAD
_SIGN_CHECK_FAIL
12290 下载错误 签名校验失败 检查鉴权密钥是否正确,检查是否有初始化离线语音。
QAVPTTERROR_DOWNLOAD
_COS_INTERNAL_FAIL
12291 下载错误 网络错误 服务器获取语音文件失败,检查接口参数 fileid 是否正确,检查网络是否正常。
QAVPTTERROR_DOWNLOAD
_REMOTEFILE_ACCESSERROR
12292 下载错误 服务器文件系统错误 检查设备网络是否可以正常访问外网环境,检查服务器上是否有此文件。
QAVPTTERROR_DOWNLOAD
_GET_SIGN_NETWORK_FAIL
12293 下载错误 获取下载参数过程中,HTTP 网络失败 检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_DOWNLOAD
_SYSTEM_INNER_ERROR
12294 下载错误 获取下载参数过程中,回包数据为空 检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_DOWNLOAD_GET
_SIGN_RSP_DATA_DECODE_FAIL
12295 下载错误 获取下载参数过程中,回包解包失败 检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_DOWNLOAD
_APPINFO_UNSET
12297 下载错误 没有设置 appinfo 检查鉴权密钥是否正确,检查是否有初始化离线语音。
QAVPTTERROR_PLAYER_INIT_ERR 20481 播放错误 初始化错误 检查设备是否被占用,或者权限是否正常,是否初始化正常。
QAVPTTERROR_PLAYER
_PLAYING_ERR
20482 播放错误 正在播放中,试图打断并播放下一个失败了(正常是可以打断的) 检查代码逻辑是否正确。
QAVPTTERROR_PLAYER
_PARAM_NULL
20483 播放错误 参数为空 检查代码中接口参数是否正确。
QAVPTTERROR_PLAYER
_OPENFILE_ERR
20484 播放错误 播放时,文件访问错误 确保文件存在,文件路径的合法性。
QAVPTTERROR_PLAYER
_PLAYER_NOT_START_ERR
20485 播放错误 播放未开始 确保文件存在,文件路径的合法性。
QAVPTTERROR_S2T
_INTERNAL_ERROR
32769 语音转文字错误 内部错误 出现此情况请联系腾讯云工作人员,并参照 下载及使用问题 提供日志文件。
QAVPTTERROR_S2T
_NETWORK_FAIL
32770 语音转文字错误 网络失败 检查设备网络是否可以正常访问外网环境,参考 如何检查网络
QAVPTTERROR_S2T
_RSP_DATA_DECODE_FAIL
32772 语音转文字错误 回包解包失败 出现此情况请联系腾讯云工作人员,并参照 下载及使用问题 提供日志文件。
QAVPTTERROR_S2T
_APPINFO_UNSET
32774 语音转文字错误 没有设置 appinfo 检查鉴权密钥是否正确,检查是否有初始化离线语音。
QAVPTTERROR_STREAMIN
_RECORD_SUC_REC_FAIL
32775 流式语音转文本错误 流式语音转文本失败,但是录音成功了 检查网络是否正确连接,检查权限密钥是否正确。
QAVPTTERROR_S2T
_SIGN_CHECK_FAIL
32776 authbuffer 校验失败 authbuffer 校验失败 检查 authbuffer 是否正确。
QAVPTTERROR_STREAMIN
_UPLOADANDRECORD_SUC_REC_FAIL
32777 流式语音转文本错误 流式语音转文本失败,但是录音成功了,上传也成功了。 检查代码是否有错误。
QAVPTTERROR_S2T_PARAM_NULL 32784 语音转文字错误 语音转文本参数错误 检查代码中接口参数 fileid 是否为空。
QAVPTTERROR_S2T
_AUTO_SPEECH_REC_ERROR
32785 语音转文字错误 语音转文本翻译返回错误 出现此情况请联系腾讯云工作人员,并参照 下载及使用问题 提供日志文件。
QAVPTTERROR_ERR
_VOICE_STREAMIN_RUNING_ERROR
32786 流式语音转文本错误 流式语音转文本失败 在流式录制状态当中,请等待流式录制接口执行结果返回。
QAVPTTERROR_ERR_VOICE
_STREAMING_ASR_ERROR
50012 流式语音转文本错误 请求 ASR 错误 重新上传录制文件(UploadRecordedFile),然后调用转文本接口(SpeechToText)。出现此情况请联系腾讯云工作人员,并参照 下载及使用问题 提供日志文件。
目录