# ArkTS API错误码

以下仅介绍本模块特有错误码，通用错误码请参见通用错误码。

#### 1010710001 图片尺寸不符合要求

**错误信息**

The size of the pixelmap exceeds the limit.

**错误描述**

调用添加图标等接口时，传入的图标图片尺寸不符合要求。

**可能原因**

未知原因

当前图标尺寸不做严格限制。

**处理步骤**

请更换传入的图片数据或通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710002 菜单项数量超出限制

**错误信息**

The number of menu items or submenu items exceeds the limit.

**错误描述**

调用添加图标等接口时，传入的菜单项数量超出限制。

**可能原因**

*   传入的所有一级菜单项的数量超过限制上限20
    
*   传入的某个一级菜单项的子菜单项的数量超过上限20
    

**处理步骤**

请重新设置一级菜单项和二级菜单项或通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710003 API调用频繁

**错误信息**

The API is being called too frequently.

**错误描述**

指定API调用频繁。

**可能原因**

addToStatusBar，removeFromStatusBar，updateStatusBarIcon，updateQuickOperationHeight，updateStatusBarMenu等方法时调用间隔小于20ms。

**处理步骤**

请注意设置API的调用间隔或通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710004 无前台窗口不允许移除图标

**错误信息**

The icon cannot be deleted when no window is in the foreground.

**错误描述**

前台无应用窗口，不允许调用removeFromStatusBar移除状态栏图标。

**可能原因**

应用退后台后调用了removeFromStatusBar方法。

**处理步骤**

请注意API的调用时机或通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710005 字符串长度超出阈值

**错误信息**

The string length exceeds the threshold.

**错误描述**

字串长度超出限制范围。

**可能原因**

*   StatusBarItem中配置的hoverTips字符串长度为0或者大于128。
    
*   调用updateStatusBarHoverTips方法时传入的字符串长度为0或者大于128。
    

**处理步骤**

检查传入字符串的长度是否在取值范围中，如果无法解决请通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710006 菜单项不存在

**错误信息**

Menu item not found.

**错误描述**

对不存在的菜单项进行更新。

**可能原因**

*   调用updateStatusBarMenuItem时，若传入的item的menuCode未在状态栏的一级菜单项中预先定义，则会导致更新失败。
    
*   调用updateStatusBarSubMenuItem时，若传入的item的menuCode未在状态栏的二级菜单项中预先定义，则会导致更新失败。
    

**处理步骤**

请检查待更新的一级或二级菜单项的menuCode是否与现有菜单项的menuCode一致，如果无法解决请通过在线提单提交问题，华为支持人员会及时处理。

#### 1010710007 菜单项的menuCode不唯一

**错误信息**

The menuCode of the menu item is not unique.

**错误描述**

菜单项的menuCode不唯一。

**可能原因**

*   调用addToStatusBar时，菜单中的menuCode不唯一。
*   调用updateStatusBarMenu时，菜单中的menuCode不唯一。
*   调用updateStatusBarMenuItem时，待更新的item的子菜单的menuCode不唯一。
    *   子菜单的各menuCode在当前菜单项中不唯一。
    *   子菜单的menuCode是其他菜单项的menuCode。
    *   子菜单的menuCode在其他菜单项的子菜单中存在。

**处理步骤**

请确保所有菜单项的menuCode值保持唯一，合理配置各菜单项的menuCode值以避免冲突，如果无法解决请通过在线提单提交问题，华为支持人员会及时处理。

#### 1010720001 传入的一级菜单项数据不满足要求

**错误信息**

A menu item contains neither submenu nor menuAction.

**错误描述**

调用添加图标、更新菜单等接口时，传入的一级菜单项数据不满足要求。

**可能原因**

当前传入的某个一级菜单项既不包含menuAction，也不包含subMenu。

**处理步骤**

请排查传入的一级菜单项的参数或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210001 菜单分组数量超过限制

**错误信息**

Maximum number of categories reached.

**错误描述**

添加的分组数量超出限制。

**可能原因**

分组最大数量为3，添加的菜单分组数量超过了限制。

**处理步骤**

请重新设置菜单分组的数量或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210002 菜单分组名称重复

**错误信息**

Duplicate category name.

**错误描述**

传入的分组名称和其他分组名称重复。

**可能原因**

调用添加分组和更新分组接口时，传入的分组名称和已存在的分组名称重复。

**处理步骤**

请重新设置菜单分组的名称或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210003 未找到菜单分组

**错误信息**

Category not found.

**错误描述**

调用获取分组、更新分组、删除分组等接口时，未找到对应的菜单分组。

**可能原因**

*   没有添加菜单分组就去获取所有的菜单分组。
    
*   更新菜单分组时传入的分组Id有误，未找到对应的菜单分组。
    
*   删除菜单分组时传入的分组Id有误，未找到对应的菜单分组。
    
*   获取一个分组下的所有任务时传入的分组Id有误，未找到对应的菜单分组。
    
*   添加菜单任务时传入的分组Id有误，未找到对应的菜单分组。
    

**处理步骤**

请重新设置已存在的分组Id或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210004 未找到菜单任务

**错误信息**

Quick task not found.

**错误描述**

调用获取任务、更新任务、删除任务等接口时，未找到对应的菜单任务。

**可能原因**

*   删除菜单任务时传入的任务Id有误，未找到对应的菜单任务。
    
*   获取一个分组下的所有任务时，获取的任务数量为0。
    
*   更新菜单任务时传入的任务Id有误，未找到对应的菜单任务。
    

**处理步骤**

请重新设置已存在的任务Id或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210005 分组已经存在

**错误信息**

Group already exists.

**错误描述**

调用新增分组接口时，分组已经存在。

**可能原因**

分组已经增加过，不可重复增加。

**处理步骤**

请检查分组信息或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210006 分组未找到

**错误信息**

Group not found.

**错误描述**

调用删除分组接口时，未找到对应分组。

**可能原因**

分组信息不存在。

**处理步骤**

请检查分组信息或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210007 窗口未找到

**错误信息**

Window not found.

**错误描述**

窗口id不存在。

**可能原因**

窗口id有误。

**处理步骤**

请检查窗口id或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210008 字符串长度超出限制

**错误信息**

The string length exceeds the threshold.

**错误描述**

传入的字符串参数的长度超过限制。

**可能原因**

*   调用addCustomCategory方法时传入的字符串长度大于512或者内容为空。
    
*   调用updateCustomCategory方法时传入的字符串长度大于512或者内容为空。
    
*   调用addQuickTask方法时传入的字符串长度大于512或者内容为空。
    
*   调用updateQuickTask方法时传入的字符串长度大于512或者内容为空。
    

**处理步骤**

请重新设置字符串的内容或通过在线提单提交问题，华为支持人员会及时处理。

#### 1020210009 无效的parameter

**错误信息**

Invalid parameter.

**错误描述**

传入的parameters参数的数组大小超过限制。

**可能原因**

*   调用addQuickTask方法时传入的parameters参数的数组大小超过64。
    
*   调用updateQuickTask方法时传入的parameters参数的数组大小超过64。
    

**处理步骤**

请重新设置parameters参数的数组元素数量或通过在线提单提交问题，华为支持人员会及时处理。