目录

ArkTS API错误码

以下仅介绍Graphics Accelerate Kit特有错误码，通用错误码请参考通用错误码。

1016600000 当前API不允许在资源加速ExtensionAbility中调用

错误信息

The API call from an ExtensionAbility is not allowed.

错误描述

当前API不允许在资源加速ExtensionAbility中调用。

可能原因

在资源加速ExtensionAbility中调用了不支持的接口，未在允许调用范围内。

处理步骤

请确保当前API在资源加速ExtensionAbility的允许调用范围内。assetDownloadManager提供的接口仅支持调用如下方法：

1016600001 下载任务的域名不在域名白名单中

错误信息

The domain name of the download task is not in the domain name trustlist.

错误描述

下载任务的域名不在域名白名单中。

可能原因

下载任务URL的域名未在AGC控制台配置的域名白名单中。

处理步骤

1016600002 暂停/恢复/获取下载任务时任务ID或组ID不存在

错误信息

The task ID or group ID entered during operations such as pause, resume, and fetch does not exist.

错误描述

暂停/恢复/获取下载任务时任务ID或组ID不存在。

可能原因

未查询到可操作的任务ID或组ID。

处理步骤

任务ID/组ID不存在，请确保任务ID/组ID的正确性。

1016600003 当前任务状态不支持当前操作

错误信息

The current task status does not support the current operator.

错误描述

当前任务状态不支持当前操作。

可能原因

当前任务状态和当前操作不匹配，例如恢复一个未暂停的下载任务，暂停一个已暂停的下载任务。

处理步骤

对任务调用操作前，判断当前任务的状态，确保任务操作和任务状态匹配，例如调用fetchAllAssetDownloadTasks方法查看任务状态信息。

1016600004 任务队列已满

错误信息

The application task queue is full.

错误描述

任务队列已满。

可能原因

资源包下载任务的队列超过200个。

处理步骤

请在任务队列有空间后再提交任务，等待当前下载任务执行完成。

1016600005 资源加速ExtensionAbility方法执行超时

错误信息

Extension life cycle callback execution timed out.

错误描述

资源加速ExtensionAbility方法执行超时。

可能原因

若资源加速ExtensionAbility方法未在生命周期时长内完成执行，将存在超时问题。

处理步骤

通过在线提单提交问题，华为工程师会及时处理。

1016600006 资源加速ExtensionAbility生命周期方法出现异常

错误信息

An exception occurs in the callback extension js.

错误描述

资源加速ExtensionAbility生命周期方法出现异常。

可能原因

资源加速ExtensionAbility内部处理逻辑超时。

处理步骤

排查资源加速ExtensionAbility生命周期方法是否存在未捕获异常。

1016600094 资源加速服务异常

错误信息

Task service ability error.

错误描述

资源加速服务异常。

可能原因

游戏资源加速服务异常。

处理步骤

通过在线提单提交问题，华为工程师会及时处理。

1016600401 资源加速参数错误

错误信息

Parameter error.

错误描述

资源加速参数错误。

可能原因

输入参数的类型错误或参数值内容错误。

处理步骤

检查输入参数是否符合要求，确保无误后再次尝试。

1019400001 启动加速服务异常

错误信息

Service error. 1. Connect to system service failed; 2.System service failed to communicate with dependency module.

错误描述

启动加速服务异常。

可能原因

游戏启动加速服务异常

1. 连接系统服务失败；

2. 系统服务无法与依赖模块通信。

处理步骤

通过在线提单提交问题，华为工程师会及时处理。

1019400002 游戏不在预启动状态

错误信息

The app is not in a preloading state.

错误描述

游戏不在预启动状态。

可能原因

当前游戏不是由预启动运行的。

处理步骤

开发者可在UIAbility的onCreate生命周期回调中通过want.parameters获取启动原因，若参数ohos.params.gamePrelaunch为true时，则表示当前UIAbility是由游戏预启动运行的。

1019400401 启动加速参数错误

错误信息

Parameter error.

错误描述

启动加速参数错误。

可能原因

输入参数的类型错误或参数值内容错误。

处理步骤

检查输入参数是否符合要求，确保无误后再次尝试。

1009503001 游戏伴随服务正在初始化

错误信息

The game buddy service is initializing, please retry later.

错误描述

游戏伴随服务正在初始化，请稍后重试。

可能原因

感知游戏启动后，会拉起游戏伴随服务，才会触发初始化流程。

处理步骤

请退出当前启动的游戏进程，等待一段时间后重新进入游戏，若仍无法启动游戏伴随服务，请通过在线提单提交问题，华为工程师会及时处理。

1009503002 游戏伴随服务不支持当前游戏或没有游戏运行

错误信息

No game is running, or the current game is not supported by the game buddy service. Please launch a supported game first.

错误描述

当前没有游戏在运行或者游戏伴随服务不支持该游戏，请首先启动游戏伴随服务支持的游戏。

可能原因

当前没有游戏在运行或者游戏伴随服务不支持该游戏。

处理步骤

请通过在线提单提交问题，华为工程师会及时处理。