- 产品动态
- 产品介绍
- 新手指引
- 购买指南
- SDK 下载指引
- 产品功能体验
- 控制台指南
- 快速入门
- 基础功能开发指南
- 进阶功能开发指南
- 客户端 API
- 服务端 API
- 常见问题
- 服务协议
- 联系我们
- 词汇表
- GME 政策
- 产品动态
- 产品介绍
- 新手指引
- 购买指南
- SDK 下载指引
- 产品功能体验
- 控制台指南
- 快速入门
- 基础功能开发指南
- 进阶功能开发指南
- 客户端 API
- 服务端 API
- 常见问题
- 服务协议
- 联系我们
- 词汇表
- GME 政策
为方便开发者调试和接入腾讯云游戏多媒体引擎产品 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 | |
AV_ERR_SERVER_CONNECT_ROOM_FAIL | 10005 |
语音消息错误码
录制音频相关错误码
错误码名称 | 错误码值 | 原因及建议方案 |
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 | |
VOICE_UPLOAD_GET_TOKEN_NETWORK_FAIL | 8196 | |
VOICE_UPLOAD_SYSTEM_INNER_ERROR | 8197 | |
VOICE_UPLOAD_RSP_DATA_DECODE_FAIL | 8198 | |
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 | |
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 | |
VOICE_ERR_VOICE_STREAMIN_RUNING_ERROR | 32786 | 调用接口时在流式语音消息转文本状态当中，请等待接口执行结果返回。 |
VOICE_ERR_VOICE_S2T_TRNSLATE_SERVICE_NOT_AVALIABLE | 32787 | |
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 | |
AV_ERR_MUTESWITCH_DECTECT_ERR | 7018 | iOS 静音开关检测错误，查看是否是在 iOS 机型上调用 |
AV_ERR_SERVICE_NOT_OPENED | 7022 |
是
否
本页内容是否解决了您的问题？