tencent cloud

游戏多媒体引擎

产品动态
产品介绍
产品概述
优势特性
产品功能
应用场景
安全合规认证
新手指引
产品计费
免费额度
购买指南
SDK 下载指引
产品功能体验
基本功能演示
场景化 Demo 体验
控制台指南
用量查看
服务开通
快速入门
快速接入 SDK
快速接入 Sample Project
基础功能开发指南
鉴权密钥
实时语音角色设置
音质选择
进阶功能开发指南
服务端录制
万人范围语音
3D 音效
音效与伴奏
网络音频流转发路由
自定义消息通道
如何应对公司防火墙限制
语言参数参考列表
房间管理功能
客户端 API
Unity SDK
Unreal Engine SDK
Cocos2D SDK
Windows SDK
iOS SDK
Android SDK
macOS SDK
H5SDK
Electron SDK
Flutter SDK
SDK 版本升级指引
错误码
编译工具链文档
服务端 API
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
常见问题
产品功能问题
问题解决指南
计费相关问题
Sample Project 使用问题
一般性问题
鉴权相关问题
实时语音进房失败问题
实时语音无声及音频问题
网络问题
语音转文本问题
工程导出问题
服务协议
服务等级协议
联系我们
词汇表
GME 政策
数据处理和安全协议
隐私协议

错误码

PDF
聚焦模式
字号
最后更新时间: 2024-01-18 15:27:40
为方便开发者调试和接入腾讯云游戏多媒体引擎产品 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
没有在控制台开通实时语音消息功能或者转文本功能,请在控制台上开通,参见 服务开通指引


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈