文档中心

云手机

Windows SDK

错误码

警告码及说明

描述：IEngineEventHandler::onWarning 接口返回警告码及说明。详细的警告码及说明如下：

Code	Message	说明
21034001	WARNING_TOKEN_WILL_EXPIRE	拉流 token 即将过期，如果想继续维持拉流状态，请调用 updateExpireTimeOneStep 接口以延长拉流有效期。
30023002	WARNING_LOCAL_ALREADY_SET_BACKGROUND	本地客户端应用已切换到后台，请勿重复调用切换后台接口。
30023003	WARNING_LOCAL_ALREADY_SET_FOREGROUND	本地客户端应用已切换到前台，请勿重复调用切换前台接口。
30009002	WARNING_REMOTE__ALREADY_FOREGROUND	云机应用戏切换前台失败。原因：云机应用已处于前台。
30009101	WARNING_REMOTE__FOREGROUND_FAILURE_NO_SUCH_PACKAGE_NAME	云机应用戏切换前台失败。原因：应用包名不存在。建议：请检查指定的应用包名是否正确。
30009102	WARNING_REMOTE__FOREGROUND_FAILURE_NO_SUCH_PACKAGE_NAME	云机应用切换前台失败。原因：应用包名不存在。建议：请检查指定的应用包名是否正确。
30009103	WARNING_REMOTE__FOREGROUND_FAILURE_NO_PACKAGE_NAME_BACKGROUND	云机应用切换前台失败。原因：指定的应用不在后台或已被关闭。
51010010	WARNING_START_NO_STOP_BEFORE	启动云手机失败。原因：反复初始化流媒体 Engine。同一个客户端连续调用了两次 start() 接口启动云手机之前，未调用 stop() 接口停止云手机。建议：请调用服务端 PodStop 接口后，再调用 start() 接口启动云手机。
51010019	WARNING_START_INVALID_AUTO_RECYCLE_TIME	设置无操作回收服务时长出错。建议：请参考 auto_recycle_time 参数描述进行设置。

错误码及说明

描述：IEngineEventHandler::onError 接口返回错误码及说明。详细的错误码及说明如下：

Code	Message	说明
10100013	ERROR_START_USERID_AUTH_FAILED	用户 ID 鉴权失败。原因：1. 用户 ID 错误。2.enableUserAuth 参数未与AssumeRole 接口接口同步开启。建议：1. 请检查用户 ID。2.若 AssumeRole 接口生成带用户 ID 校验的临时 Token，则 enableUserAuth 需同步开启；反之不开启。
11000001	ERROR_REQUEST_PARAMETER_BINDING_ERROR	参数绑定错误。建议：检查传入的参数格式是否正确。
11000007	ERROR_INVALID_REQUEST_PARAMETER	请求参数错误。建议：检查传入的参数名称是否正确。
11000008	ERROR_DOWN_STREAM_UNKNOWN_ERROR	服务端下游错误。建议：请联系火山引擎云手机技术支持。
12000000	ERROR_BUSINESS_ID_ERROR	业务 ID 错误。建议：请检查业务是否存在，可通过火山引擎云手机控制台『业务详情』页面获取。
12000001	ERROR_START_PRODUCT_NOT_EXIST	启动云手机失败。原因：指定的云手机业务 ID 不存在。建议：检查您的业务 ID 是否正确。可通过火山引擎云手机控制台『业务管理』页面获取。
13000001	ERROR_START_APPLICATION_NOT_EXIST	启动云手机失败。原因：指定的应用不存在。建议：检查指定的 app_id 是否正确。
16000000	ERROR_START_CONFIGURATION_CODE_NOT_EXIST	启动云手机失败。原因：实例资源套餐不存在。建议：检查指定的 configuration_code 是否正确。
17000000	ERROR_ACCOUNT_ID_INIT_ERROR	火山引擎账号 ID 错误。建议：请检查使用的账号和签名，可通过火山引擎官网页面右上角用户 > 账号管理 > 主账号信息获取正确的账号。
17000001	ERROR_ACCOUNT_ID_NOT_FOUND	火山引擎账号 ID 不合法。建议：通过火山引擎官网页面右上角用户 > 账号管理 > 主账号信息获取正确的账号。
17000003	ERROR_ACCOUNTID_MISMATCH	指定的火山引擎账号校验失败。建议：通过火山引擎官网页面右上角用户 > 账号管理 > 主账号信息获取正确的账号。
17100000	ERROR_USER_IS_INVALID	子账号不合法。建议：请检查子账号是否有业务和实例相关操作权限。可参考创建和管理子账号权限。
18100000	ERROR_GENERIC_INSTANCE_ERROR	套餐、实例不存在。建议：请检查实例状态、订购的资源是否过期。
18100001	ERROR_START_POD_NOT_EXIST	启动云手机失败。原因：实例不存在。建议：检查指定的 pod_id 是否正确。
18100002	ERROR_INSTANCE_OFFLINE	实例离线。建议：请检查实例状态。
18100003	ERROR_POD_NOT_READY	云机实例未就绪。建议：请检查指定的实例已开机运行。
18500000	ERROR_UNIVERSAL_STARTUP_FAILED	启动云手机失败。
18500001	ERROR_INTERNAL_POD_START_FAILED	启动云手机失败。建议：请检查实例状态或联系火山引擎云手机技术支持。
18500002	ERROR_INTERNAL_POD_MUTE_FAILED	启动云手机失败。建议：请检查实例状态或联系火山引擎云手机技术支持。
18500003	ERROR_INTERNAL_CONFIG_FAILED	启动云手机失败。建议：请检查实例状态或联系火山引擎云手机技术支持。
21001004	ERROR_GAME_STOPPED_DUPLICATE_START	游戏停止。原因：某个 start() 请求使用了与当前游戏相同的 userId 和 gameId，导致当前游戏停止。建议：请检查调用 start() 接口的参数是否重复。如果需要重新启动被停止的游戏，请再次使用相同的 userId 和 gameId 调用 start() 接口。
21001011	ERROR_START_CONNECTION_ENDED	启动云手机失败。原因：在调用 start() 接口启动云手机成功回调触发之前，云手机被停止（可能原因包括：服务端应用崩溃导致启动失败）。
21040055	ERROR_REMOTE_STOPPED_TOKEN_EXPIRED	应用停止。原因：拉流 token 已过期，请再次调用 start 接口重新启动拉流。
22040007	ERROR_STOPPED_DUPLICATE_START	云手机停止。原因：同一客户端或同一用户重复调用 start() 接口启动相同会话，导致当前连接被停止。建议：请避免重复调用 start() 接口；如需重新启动，请先确认当前会话已停止后再发起新的 start() 请求。
22040016	ERROR_CLIENT_KICKED_OUT	云手机停止。原因：当前连接被其他客户端或同一用户的新连接挤下线。建议：请确认是否存在多端同时连接或重复登录；如需继续使用，请重新调用 start() 接口建立连接。
22040047	ERROR_STREAMING_BANNED_BY_SERVER	拉流失败或停止。原因：服务端禁止当前拉流请求，可能是鉴权、策略或资源状态不满足要求。建议：请检查 Token、用户 ID、业务配置和实例状态是否正确；确认无误后重新调用 start() 接口，如仍失败请联系技术支持。
30008000	ERROR_POD_EXIT_CRASH	云手机停止。原因：服务端应用崩溃。建议：请尝试复现应用在本地设备是否运行异常，如本地未复现，可以联系火山引擎云手机服务技术支持。
30008003	ERROR_GAME_STOPPED_IDLE	云手机停止。原因：用户长时间未操作，服务端自动断开连接。建议：客户端需要提示用户长时间无操作被踢下线。
30008005	ERROR_GAME_STOPPED_API	云手机停止。原因：服务端主动停止。
30008006	ERROR_POD_STOPPED_BACKGROUND_TIMEOUT	云手机停止。原因：客户端切换后台，超过指定的保活时长未切换前台，服务端自动断开了连接。建议：客户端需要提示用户因为应用切后台超过保活时长，连接断开。
51010000	ERROR_START_GENERAL	启动云手机失败。原因：通用错误。建议：请检查开始 start() 接口参数。
52030000	ERROR_SDK_GENERAL	客户端 SDK 通用错误。
52030001	ERROR_SDK_INIT_FAILED	客户端 SDK 初始化失败。
52030002	ERROR_SDK__PARAMETER_EMPTY	客户端调用 SDK 接口错误。原因：接口参数为空。建议：请参考接口说明文档，检查接口参数。
53071001	ERROR_FILE_CHANNEL_FILE_NOT_FOUND	文件传输失败。原因：上传或下载的文件不存在。建议：请检查文件名是否正确且确保文件存在后重试。
53071002	ERROR_FILE_CHANNEL_FILE_NO_ACCESS	文件传输失败。原因：上传或下载的文件无权限访问。建议：请检查文件的访问权限。
53071003	ERROR_FILE_CHANNEL_NETWORK_ABORT	文件传输失败。原因：上传或下载文件过程中网络异常中断。建议：请检查网络连接后重试。
53071004	ERROR_FILE_CHANNEL_TIMEOUT	文件传输失败。原因：上传或下载文件过程中超时。建议：请检查网络连接后重试。
53071005	ERROR_FILE_CHANNEL_STORAGE_NOT_ENOUGH	文件传输失败。原因：上传或下载文件磁盘空间不足。建议：请确保有足够的存储空间保存文件。
53071006	ERROR_FILE_CHANNEL_INTERNAL_ERROR	文件传输失败。原因：上传或下载文件发生内部错误
54050000	ERROR_MESSAGE_GENERAL	未知错误
54050001	ERROR_MESSAGE_NOT_CONNECTED	发送消息错误。原因：客户端 SDK 与火山引擎云游戏 PaaS 服务未连接。建议：请检查网络后，重新调用发送消息接口，进行消息发送。
54050002	ERROR_MESSAGE_FAILED_TO_PARSE_MSG	消息通道数据解析失败。原因：无法解析接收到的消息。
54050003	ERROR_MESSAGE_CHANNEL_UID_ILLEGAL	指定的消息通道 ID 无效。原因：指定的消息通道 ID 与云机初始化 veMessageChannelClient 时填入的用户 ID 不符。
54050007	ERROR_MESSAGE_OVER_SIZED	通过客户端 SDK 发送的消息错误。原因：消息包体过大（不应超过60kb）。建议：减小发送包体大小，重新发送。
54050009	ERROR_MESSAGE_TIMEOUT_ILLEGAL	发送消息错误。原因：指定的消息发送超时时长不符合要求，必须为大于0的值。
6100000x	ERROR_NET_REQUEST_ERROR	网络请求失败
62000xxx	ERROR_HTTP_REQUEST_ERROR	网络请求失败

最近更新时间：2026.09.03 10:03:44

这个页面对您有帮助吗？

有用

无用