滑动丢帧事件介绍

简介

用户在使用应用时，如果出现滑动列表丢帧的情况，并且持续时间超过一定限制，就会被定义为滑动卡顿，并生成HiAppEvent日志，供应用开发者分析。

如何使用HiAppEvent提供订阅滑动丢帧事件的接口可参见以下文档：

• 订阅滑动丢帧事件（ArkTS）

滑动丢帧事件支持在元服务场景下使用HiAppEvent进行订阅。不支持在应用分身场景或输入法应用场景下使用HiAppEvent进行订阅。

事件检测原理

具体检测原理可参见滑动事件检测章节。

事件params属性描述

params属性：

名称	类型	说明
time	number	事件生成时间，单位为ms。
bundle_version	string	应用版本。
bundle_name	string	应用名称。
process_name	string	应用进程名称。
ability_name	string	应用界面名称。
begin_time	number	滑动开始时间，单位为ms。
duration	number	持续时间，单位为ms。
total_app_frames	number	应用线程绘帧总数。
total_app_missed_frames	number	应用线程丢帧总数。
max_app_frametime	number	应用线程最大单帧耗时，单位ms。
max_app_seq_frames	number	应用线程最长连续丢帧。
total_render_frames	number	图形绘帧总数。
total_render_missed_frames	number	图形丢帧总数。
max_render_frametime	number	图形最大单帧耗时，单位ms。
max_render_seq_frames	number	图形线程最长连续丢帧。
external_log	string[]	应用主线程调用栈文件路径，应用存续生命周期内，采集频次限制为每日一次（应用重启会重置采集计次限制）。应用启动初始10s不会触发检测采集。为避免目录空间超限（限制参考log_over_limit），导致新生成的日志文件写入失败，日志文件处理完后请及时删除。
log_over_limit	boolean	生成的故障日志文件与已存在的日志文件总大小是否超过10M上限。true表示超过上限，日志写入失败；false表示未超过上限。