创建时长事件
调用 eventStart 来开始计时,配置要计时的事件名称以及计时事件要上报的属性。
当该事件上传时,会自动在事件属性中加入 _duration 这一属性来表示事件的持续时长,单位为毫秒。
同一事件名只能有一个在计时的事件,多次设置同一事件名时,以最后一次设置为准。
参数说明
参数名称 | 参数含义 | 参数类型 | 是否必传 |
eventName | 自定义时长事件名称 | string | 是 |
调用示例
SolarEngineAPI::eventStart("game_session");
上报时长事件
调用 eventFinish 方法可以上报开发者自定义的时长事件
参数说明
参数名称 | 参数含义 | 参数类型 | 是否必传 |
eventName | 自定义时长事件名称 | string | 是 |
customProperties |
时长事件自定义属性 | object | 否 |
调用示例
SEJSONObject event;
event.setNumber("level_reached", 5);
event.setNumber("score", 1500);
event.setString("game_mode", "adventure");
event.setString("difficulty", "normal");
event.setNumber("coins_earned", 50);
event.setNumber("powerups_used", 2);
event.setBool("completed_objective", true);
SolarEngineAPI::eventFinish("game_session", event);
注:在上报预置事件 _appEnd 时,会默认上报由上一次 _appStart 开始计时的时长,即退出事件的时长无需配置开始计时,会默认赋值。