1. 场景介绍

事件上报为开发者提供了收集玩家在游戏过程中产生的特定数据，上报并存储至华为游戏服务器，随后在AppGallery Connect上进行归纳分析的能力。

开发者可以自由决策需要上报玩家的哪些事件数据，比如：玩家付费达到一定金额，玩家进入特定游戏场景，玩家通过某关卡等。

开发者可以根据事件上报的数据针对性的对游戏进行改进，比如玩家购买某个游戏道具的上报人数远低于预期，那么开发者可以适当调整该游戏道具费用和趣味性。

一个事件包含的基本属性如下表。

2. 前提条件

• 确认当前集成的HMS SDK在3.0.3.300版本及以上。

• 在开发事件上报功能前，请确认已经在AppGallery Connect中配置事件，参见新增事件。

• 调用事件相关接口时，用户的华为帐号必须为已登录状态，参见游戏登录。

• 用户必须打开华为应用市场（10.3及以上版本）中的游戏服务开关才能使用事件功能。如果用户没有开启游戏服务开关，当游戏调用事件相关接口时HMS SDK会自动拉起华为应用市场的游戏服务开关页面引导用户打开开关，如果用户未打开游戏服务开关，将返回7018错误码，游戏需要主动提示用户到华为应用市场“我的-设置-游戏服务”页面中开启游戏服务开关。

3. 初始化EventsClient实例

在使用事件接口的能力前需要先调用Games.getEventsClient()获取EventsClient实例。示例代码如下：

复制
EventsClient client = Games.getEventsClient(this, mAuthHuaweiId);

接口中传入的mAuthHuaweiId对象在用户登录游戏时获取，如果当前华为帐号登录状态已失效，则需要调用HuaweiIdAuthService.getSignInIntent方法再次登录或调用HuaweiIdAuthService.silentSignIn方法静默授权获取AuthHuaweiId。

4. 上报玩家的事件数据

应用可以在用户触发游戏事件时调用EventsClient.grow方法向华为游戏服务器上报事件数据，传入eventId和growAmount。

• eventId为当前事件的ID，在配置事件时生成。

• growAmount为在已有事件数值的基础上要增量增加的数值。例如游戏需要跟踪的事件为“击败100只怪物”，玩家在首次战斗中击败20只怪物，首次上报该事件时growAmount为20。玩家在下一次战斗中又击败了40只怪物，此时上报事件时growAmount为增量增加的数值40。

上报事件的示例代码如下：

复制
client.grow(eventId, growAmount);

5. 获取事件数据

开发者可以在游戏中向用户展示事件的数据。

● 如果用户需要查看所有事件数据，应用可以调用EventsClient.getEventList方法。

● 如果用户只需查看某些特定的事件，应用可以调用EventsClient.getEventListByIds方法，在方法中传入包含指定事件ID的数组。

两种方法均可以通过boolean类型的forceReload参数指定是从华为游戏服务端还是从应用客户端本地缓存中查询数据。

获取所有事件数据的示例代码如下：

复制
Task<List<Event>> task = client.getEventList(forceReload);

获取特定事件数据的示例代码如下：

复制
Task<List<Event>> task = client.getEventListByIds(forceReload, eventIds);

事件结果数据返回的示例代码如下：

复制
task.addOnSuccessListener(new OnSuccessListener<List<Event>>() {
         @Override
         public void onSuccess(List<Event> data) {
            if (data == null) {
                Log.w("Event", "event is null");
                return;
            } 
            for (Event event : data) {
                Log.i("Event", "event id:" + event.getEventId());
            }
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(Exception e) {
            if (e instanceof ApiException) {
                String result = "rtnCode:" 
+ ((ApiException) e).getStatusCode();
                Log.e("Event", result);
            }
        }
    });