文档中心

云手机

Android SDK

错误码

警告码及说明

警告码回调接口为 IPlayerListener#onWarning，具体错误原因见回调接口中的 message。

警告码	警告信息	说明
10010	WARNING_START_NO_STOP_BEFORE	启动云手机失败。原因：同一个客户端连续调用了两次启动接口之间没有调用停止接口。建议：请调用停止接口，结束上一次 “游戏”，再调用启动接口。
10019	WARNING_START_INVALID_AUTO_RECYCLE_TIME	设置无操作推流服务回收时长出错。建议：请参考 setAutoRecycleTime 接口描述进行设置。
30007	WARNING_SDK_LACK_OF_LOCATION_PERMISSION	SDK 无定位服务权限。原因：定位服务权限未开启。建议：检查设备定位服务权限是否开启。
30012	WARNING_UNEXPECTED_CONTEXT_TYPE	客户端传入 Context 类型错误。原因：预期客户端传入 Activity，但实际传入了全局 Context。建议：请将 Container 的 Context 修改为 Activity。
30013	WARNING_SDK_LOCATION_DISABLED	云端请求定位时，客户端未开启定位功能。
34001	WARNING_TOKEN_WILL_EXPIRE	拉流 token 即将过期，如果想继续维持拉流状态，请调用 updateExpireTime 接口以延长拉流有效期。
40037	WARNING_LOCAL_ALREADY_SET_BACKGROUND	应用切换后台失败。原因：应用已处于后台，请勿重复调用。
40038	WARNING_LOCAL_ALREADY_SET_FOREGROUND	应用切换前台失败。原因：应用已处于前台，请勿重复调用。
40040	WARNING_FOREGROUND_CHANGE_STATUS_NO_PACKAGENAME	云机应用切换前台失败。原因：应用包名不存在。建议：请检查指定的应用包名是否正确。
40041	WARNING_FOREGROUND_CHANGE_STATUS_REPEAT	云机应用切换前台失败。原因：云机应用已处于前台，请勿重复调用。
40043	WARNING_FOREGROUND_CHANGE_STATUS_NOTFOND	云机应用切换前台失败。原因：指定的应用不在后台或已被关闭。
40044	WARNING_GAME_STOPPED_INGAME_EXIT	应用停止。原因：一般是因为云机运行的应用主动退出了。建议：客户端需要提示用户目前应用主动被结束了，如果需要，可以重新开始应用。
40054	WARNING_NATIVE_IME_DISABLED	不允许设置输入法类型
61001	WARNING_START_NET_REQUEST_CANCEL	网络请求取消

错误码及说明

错误码回调接口为 IPlayerListener#onError，具体错误原因见回调接口中的 message 。

错误码	错误信息	说明
11022	ERROR_START_USERID_AUTH_FAILED	用户 ID 鉴权失败。原因：1. 用户 ID 错误。2.enableUserAuth 参数未与AssumeRole 接口接口同步开启。建议：1. 请检查用户 ID。2.若 AssumeRole 接口生成带用户 ID 校验的临时 Token，则 enableUserAuth 需同步开启；反之不开启。
20000	ERROR_STREAM_GENERAL	串流连接错误。原因：网络原因。建议：请检查网络。
20002	ERROR_STREAM_CHANGE_CLARITY_ID_NOT_IN_START_STATE	切换清晰度失败。原因：当前处于非播放状态。建议：请调用启动接口，在收到播放成功回调后，再调用切换清晰度档位接口。
30000	ERROR_SDK_GENERAL	客户端 SDK 通用错误。
30001	ERROR_SDK_INIT_FAILED	客户端 SDK 初始化失败。
30002	ERROR_SDK__EMPTY	客户端调用 SDK 接口错误。原因：接口参数为空。建议：请参考接口说明文档，检查接口参数。
30009	ERROR_INIT_ACCOUNT_ID_ILLEGAL	未指定火山引擎账号。建议：通过火山引擎官网页面右上角用户 > 账号管理 > 主账号信息获取正确的账号。
30010	ERROR_CREATE_ENGINE_ERROR	创建 Engine 失败。建议：联系火山引擎云游戏技术支持。
30201	ERROR_DOWNLOAD_PLUGIN_FAILED	下载插件失败。建议：检查 vePhoneSDK 以及插件包的依赖是否配置正确。
30203	ERROR_INJECT_DEX_FAILED	classLoader 加载插件失败。建议：检查 vePhoneSDK 以及插件包是否已成功下载。
30204	ERROR_CHECK_PLUGIN_FAILED	检查插件失败。建议：检查 vePhoneSDK 以及插件包是否已成功下载。
30205	ERROR_LOAD_PLUGIN_FAILED	加载插件失败。检查 vePhoneSDK 以及插件包是否已成功下载。
31006	ERROR_ABI_IS_NOT_SUPPORT	未能识别的 ABI 类型。原因：设备可能为模拟器或者特殊设备。建议：联系火山引擎云游戏技术支持。
40010	ERROR_POD_STREAM_TIMEOUT	拉流超时的兜底错误码（拉流超时相关错误码还包括 40012、40013、40014、40015）。如遇该报错可稍后重试，或在业务内设置弹窗报错逻辑。
40012	ERROR_CLIENT_JOIN_TIMEOUT	客户端加房超时，通常是手机网络异常导致。
40013	ERROR_POD_JOIN_TIMEOUT	Pod 加房超时，通常是 Pod 状态、性能或网络等异常导致，请稍后重试。
40014	ERROR_POD_PUBLISH_TIMEOUT	Pod 发布视频流超时，通常是 Pod 性能或网络原因导致，请稍后重试。
40015	ERROR_CLIENT_FIRST_FRAME_TIMEOUT	客户端接收首帧超时，通常是手机网络异常导致。
40016	ERROR_CLIENT_KICKED_OUT	客户端连接云端失败。原因：1. 用户 ID（userId）与云端内已有用户冲突。2. 云端内用户数量已达上限。建议：1. 请检查 userId 是否重复，确保同一云端内每个用户的 userId 唯一。2. 请确认当前云端用户数量是否已满，如需继续请稍后重试。注意云手机实例需要使用 2026 年 9 月 2 日及之后发布的镜像，镜像版本请见公共镜像发布历史。
40045	ERROR_STORAGE_NOT_ENOUGH	云手机存储空间不足。原因：存储云手机画面截图文件的空间不足，请清理存储空间后再尝试截图操作。
40046	ERROR_POD_UNKNOWN_FAILURE	未知错误，云手机画面截图失败，请稍后重试。
40055	ERROR_REMOTE_STOPPED_TOKEN_EXPIRED	应用停止。原因：拉流 token 已过期，请再次调用 start 接口重新启动拉流。
60001	ERROR_NET_REQUEST_ERROR	网络请求失败。
60002	ERROR_HTTP_REQUEST_ERROR	网络请求失败。
71001	ERROR_FILE_CHANNEL_FILE_NOT_FOUND	文件传输失败。原因：推送或拉取的文件不存在。建议：请检查文件名是否正确且确保文件存在后重试。
71002	ERROR_FILE_CHANNEL_FILE_NO_ACCESS	文件传输失败。原因：无访问权限推送或拉取文件。建议：提示用户通过客户端申请目标目录的文件读写权限。
71003	ERROR_FILE_CHANNEL_NETWORK_ABORT	文件传输失败。原因：推送或拉取文件过程中网络异常中断。建议：请检查网络连接后重试。
71004	ERROR_FILE_CHANNEL_TIMEOUT	文件传输失败。原因：推送或拉取文件过程中超时。建议：请检查网络连接后重试。
71005	ERROR_FILE_CHANNEL_STORAGE_NOT_ENOUGH	文件传输失败。原因：推送或拉取文件磁盘空间不足。建议：请确保有足够的存储空间保存文件。
71006	ERROR_FILE_CHANNEL_INTERNAL_ERROR	文件传输失败。原因：推送或拉取文件发生内部错误，通常是依赖库集成原因触发的。建议：请检查应用引入依赖库是否与云手机 SDK 冲突。
71007	ERROR_FILE_CHANNEL_UNSPPORTED	文件传输失败。原因：发送文件不支持低于8.0版本的 Android 系统。建议：请检查系统版本是否低于 Android 8.0。

最近更新时间：2026.09.03 14:46:10

这个页面对您有帮助吗？

有用

无用