目录

ArkTS API错误码

以下仅介绍Game Service Kit特有错误码,通用错误码请参考通用错误码。

1010300001 游戏内部通用错误

错误信息

System internal error.

错误描述

游戏内部通用错误。

可能原因

Game Service Kit系统内部错误。

处理步骤

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

1010300002 鉴权失败

错误信息

Auth Failed.

错误描述

鉴权失败。

可能原因

网络连接或传参错误。

处理步骤

  1. 首次使用设备进行登录时,请确认网络连接正常。
  2. 请检查init接口传参是否正确。

1010300003 非法请求

错误信息

Invalid request.

错误描述

非法请求。

可能原因

未初始化或初始化未成功时,调用了其他接口。

处理步骤

请先调用init接口,并确保调用成功。

1002000001 游戏内部通用错误

错误信息

System internal error.

错误描述

游戏内部通用错误。

可能原因

Game Service Kit系统内部错误。

处理步骤

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

1002000002 网络错误

错误信息

Network connection error.

错误描述

网络错误。

可能原因

网络连接错误。

处理步骤

请检查网络连接是否正常。

1002000003 未查到华为账号相关信息

错误信息

The HUAWEI ID is not signed in or not authorized.

错误描述

未查到华为账号相关信息。

可能原因

未查到华为账号相关信息。

处理步骤

确认华为账号已经登录并授权。

1002000004 实名认证返回强制实名但用户取消,或需要强制实名但没有实名

错误信息

User cancels real name authentication or not real name.

错误描述

实名认证返回强制实名但用户取消,或需要强制实名但没有实名。

可能原因

实名认证返回强制实名但用户取消,或需要强制实名但没有实名。

处理步骤

调用unionLogin接口再次引导用户进行实名认证。

1002000005 只支持服务地和注册地均为中国境内(不包含中国香港、中国澳门、中国台湾)的华为账号

错误信息

The country or region of the signed-in Huawei ID does not support.

错误描述

只支持服务地和注册地均为中国境内(不包含中国香港、中国澳门、中国台湾)的华为账号。

可能原因

华为账号服务地和注册地不是中国境内(不包含中国香港、中国澳门、中国台湾)。

处理步骤

在用户登录游戏时,引导用户更换或重新注册中国境内(不包含中国香港、中国澳门、中国台湾)的华为账号进行登录。

1002000006 玩家未成年并且当前不在可游戏时间

错误信息

User is underage and has no playable time.

错误描述

玩家未成年并且当前不在可游戏时间。

可能原因

玩家未成年,且当前不在允许游戏的时间内。

处理步骤

检查当前未成年人的游戏时间是否为周五、周六、周日和法定节假日的20时至21时:

1002000008 该华为账号在禁止名单中

错误信息

The HUAWEI ID is in the blocklist.

错误描述

华为账号在禁止名单中。

可能原因

处理步骤

1002000009 当前游戏不支持第三方游戏账号

错误信息

The game account is unavailable for the game.

错误描述

当前游戏不支持第三方游戏账号。

可能原因

登录的游戏号不正确。

处理步骤

换游戏号。

1002000010 华为teamPlayerId与当前玩家不匹配

错误信息

The playerId is not current player.

错误描述

华为teamPlayerId与当前玩家不匹配。

可能原因

调用bindPlayer或unbindPlayer接口时,teamPlayerId传错。

处理步骤

请检查teamPlayerId是否正确,并重新调用bindPlayer或unbindPlayer接口传递正确teamPlayerId。

1002000011 玩家未确认协议、隐私声明

错误信息

Agreement not agreed.

错误描述

玩家未确认协议、隐私声明。

可能原因

玩家在弹出隐私协议窗口时选择了取消,或init接口未调用成功前调用了其他接口。

处理步骤

重新调用init接口。

1002000012 游戏官方账号与华为teamPlayerId已绑定

错误信息

The thirdOpenId or teamPlayerId has been bound.

错误描述

游戏官方账号与华为teamPlayerId已绑定。

可能原因

调用bindPlayer接口时,游戏官方账号与华为teamPlayerId已绑定。

处理步骤

无需处理。

1002000013 游戏官方账号与华为teamPlayerId未绑定

错误信息

The thirdOpenId and teamPlayerId are not bound.

错误描述

游戏官方账号与华为teamPlayerId未绑定。

可能原因

调用unbindPlayer接口时,游戏官方账号与华为teamPlayerId未绑定。

处理步骤

无需处理。

1002000014 此接口不适用于此游戏

错误信息

This interface is not available for this game.

错误描述

此接口不适用于此游戏。

可能原因

当前游戏不支持调用此接口。

处理步骤

  1. 请确认当前游戏调用unionLogin接口是否报错。
  2. 若是调用unionLogin接口出现报错,请游戏再次尝试unionlogin以外的接口。
  3. 若调用unionlogin以外的接口还是报错,请通过在线提单提交问题,华为工程师会及时处理。若调用unionlogin以外的接口不报错,说明当前游戏没有使用unionLogin接口的权限,请使用其它接口。
  4. 若游戏没有使用unionLogin接口的权限,但游戏又想重新使用unionlogin接口,请通过在线提单提交问题,华为工程师会及时处理。

1002000015 当前玩家信息无效

错误信息

The current player information is invalid.

错误描述

当前玩家信息无效。

可能原因

常见原因是游戏登录成功后,用户切换了华为账号,导致游戏中的当前玩家信息无效。

处理步骤

请重新调用unionLogin接口,获取玩家信息。

1002000016 玩家取消联合登录

错误信息

Union login canceled by user.

错误描述

玩家取消联合登录。

可能原因

在联合登录的过程中,玩家取消了联合登录。

处理步骤

如需继续登录,请重新调用unionLogin接口。

1002000017 非法应用

错误信息

Illegal application identity.

错误描述

非法应用。

可能原因

Client ID、APP ID、签名等配置信息错误或缺失。

处理步骤

检查Client ID、APP ID、签名等信息是否已配置或正确,并根据情况补充配置或进行修改。