以下仅介绍本模块特有错误码，通用错误码请参见通用错误码。
若您的问题仍无法解决，请选择在线提单提交问题，华为支持人员会及时处理。
- 入门了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用
- 分发通过华为应用市场发布你的应用，多渠道触达用户
- 推广与变现一站式流量增长与营销变现平台
- 文档获取全旅程官方文档，助力鸿蒙应用开发、上架与运营。
- 支持获取客服帮助、技术支持、活动资讯等信息
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
本文导读
展开章节
说明
1009200001 接口调用失败状态
错误信息
Failure.
错误描述
API接口调用失败。
可能原因
- 内部创建对象失败。
- 内部运行异常。
- 当前设备可能不支持该特性。
处理步骤
- 请重启应用，如不能解决可在线提单，华为支持人员会及时处理。
- 可调用HMS_AREngine_CheckSupported检查当前设备是否支持该特性。
1009200002 会话已暂停状态
错误信息
Session paused.
错误描述
会话已暂停。
可能原因
当前会话处于暂停状态或当前会话未重新开始。
处理步骤
可调用HMS_AREngine_ARSession_Resume重新开始会话。
1009200003 会话未暂停状态
错误信息
Session not paused.
错误描述
会话未暂停。
可能原因
当前会话处于运行状态。
处理步骤
可调用HMS_AREngine_ARSession_Pause暂停当前会话。
1009200004 未跟踪状态
错误信息
Not tracking.
错误描述
获取跟踪的锚点或平面信息时，会话未处于跟踪状态。
可能原因
当前会话异常。
处理步骤
查询当前会话对象（AREngine_ARSession类型对象）是否为空。
1009200005 未设置纹理状态
错误信息
Texture not set.
错误描述
未设置GL纹理。
可能原因
未设置渲染使用的GL纹理。
处理步骤
查看是否使用HMS_AREngine_ARSession_SetCameraGLTexture()接口设置正确的GL纹理。
1009200006 缺少GL上下文状态
错误信息
GL context missing.
错误描述
缺少OpenGL上下文。
可能原因
当前线程缺少OpenGL上下文，调用eglGetCurrentContext()接口获取的结果为EGL_NO_CONTEXT。
处理步骤
检查HMS_AREngine_ARSession_Update()接口是否在OpenGL渲染线程下调用。
1009200007 不支持的配置状态
错误信息
Configuration not supported.
错误描述
AR Engine不支持当前配置。
可能原因
预览尺寸不支持。
处理步骤
查看预览尺寸是否支持，可调用OH_CameraManager_GetSupportedCameraOutputCapability查看。
1009200008 资源耗尽状态
错误信息
Resource exhausted.
错误描述
内存耗尽。
可能原因
内存不足，分配内存失败。
处理步骤
检查内存是否充足，如内存不足，可提示用户清理内存；如内存充足场景，可在线提单，华为支持人员会及时处理。
1009200009 服务不可用状态
错误信息
Service unavailable.
错误描述
服务不可用状态。
可能原因
设备不支持。
处理步骤
1009200010 相机不可用
错误信息
Camera unavailable.
错误描述
相机不可用状态。
可能原因
- 应用其他场景占用了相机导致AR Engine无法打开相机。
- 相机服务异常，无法打开相机。
- 未正常申请相机权限。
处理步骤
- 排查应用在使用AR Engine时，是否存在其他打开相机场景，如不存在，可在线提单，华为支持人员会及时处理。
- 请确认应用正确申请了相机权限。
1009200011 添加的图片数量超过最大数量
错误信息
The number of images added exceeds the maximum.
错误描述
添加的图片数量超过最大数量。
可能原因
将图像到跟踪图像数据库超出了最大数量限制。
处理步骤
排查应用在添加图像到跟踪图像数据库是否超过最大数量限制。
-
如果使用ArkTS开发，最大数量限制可以通过ARAugmentedImageDatabase.getCapacity获取，数据库中已经存储的图像数量可通过ARAugmentedImageDatabase.getImageCount获取。
-
如果使用C/C++开发，最大数量限制可以通过HMS_AREngine_ARAugmentedImageDatabase_GetCapacity获取，数据库中已经存储的图像数量可通过HMS_AREngine_ARAugmentedImageDatabase_GetImageCount获取。
如符合要求，可在线提单，华为支持人员会及时处理。
1009200012 将质量不足的图像添加到图像数据库中
错误信息
Attempted to add an image with insufficient quality to the image database.
错误描述
将质量不足的图像添加到图像数据库中。
可能原因
尝试将质量不足的图像添加到图像数据库中。
处理步骤
排查应用是否将质量不足的图像添加到图像数据库中，可以参考ARAddAugmentedImageReason，如符合要求，可在线提单，华为支持人员会及时处理。
1009200013 没有有效的图像数据库
错误信息
No valid image database.
错误描述
没有有效的图像数据库。
可能原因
图像数据库未创建。
处理步骤
排查是否使用HMS_AREngine_ARAugmentedImageDatabase_Create创建图像数据库。
如符合要求，可在线提单，华为支持人员会及时处理。
1009200014 跟踪状态正在运行时无法添加图片
错误信息
The pictures cannot be added when the tracking state is running.
错误描述
跟踪状态正在运行时无法添加图片。
可能原因
程序当前正处于跟踪状态。
处理步骤
检查AREngine_ARTrackingState状态，置为ARENGINE_TRACKING_STATE_PAUSED或者ARENGINE_TRACKING_STATE_STOPPED。
1009200015 创建nativeBuffer失败
错误信息
Failed to create nativeBuffer.
错误描述
创建nativeBuffer失败。
可能原因
堆内存完全耗尽。
处理步骤
检查设备内存状态，确保有可用堆内存，如有空闲内存仍然报错，可重启设备。
1009200016 无法写入nativeBuffer
错误信息
Failed to write nativeBuffer.
错误描述
无法写入nativeBuffer。
可能原因
堆内存完全耗尽。
处理步骤
检查设备内存状态，确保有可用堆内存，如有空闲内存仍然报错，可重启设备。
1009200017 相机服务异常
错误信息
The camera service is abnormal.
错误描述
相机服务异常。
可能原因
相机服务异常，比如相机服务重启、跨进程调用异常等。
处理步骤
相机内部错误，出现的情况不明确，建议尝试重新创建业务。
1009200201 非法操作状态
错误信息
ARView invalid operation.
错误描述
ARView操作不规范。
可能原因
ARViewContext已初始化后重复进行config/callBack等相关设置。
处理步骤
请参考ARViewContext示例代码，是否按照示例代码使用。
1009200202 缺少AR呈现场景
错误信息
Graphics3D AR scene required.
错误描述
缺少AR呈现场景。
可能原因
ARViewContext初始化时未提前设置AR呈现场景 - ARViewContext.scene。
处理步骤
在ARViewContext初始化之前先进行AR呈现场景设置，可以参考管理AR会话。
1009200203 ARViewContext.config未配置
错误信息
AREngine config required.
错误描述
ARViewContext.config未配置。
可能原因
ARViewContext初始化时未提前设置config - ARViewContext.config。
处理步骤
在ARViewContext初始化之前先进行config配置，可以参考管理AR会话。
1009200204 AR会话初始化失败
错误信息
AR session setup failed.
错误描述
AR会话初始化失败。
可能原因
因未正确配置config等导致AR session初始化失败。
处理步骤
排查相关接口调用返回错误码信息，根据提示进行重新设置。
1009200205 AR场景相机节点创建失败
错误信息
AR scene camera setup failed.
错误描述
AR场景相机节点创建失败。
可能原因
因资源耗尽、重复创建相机等导致相机节点创建失败。
处理步骤
排查应用在使用ARView时，是否已调用ARViewContext接口进行了初始化，并做了相关相机确认或者系统有充足内存，如不存在，可在线提单，华为支持人员会及时处理。
华为开发者联盟 版权所有 ©2026