鸿蒙实践中心案例页计时心跳机制实测:30秒浏览任务的会话累计排查记录

举报
yd_253835047 发表于 2026/11/16 08:10:20 2026/11/16
【摘要】 记录一次鸿蒙开发实践中心「每日浏览一个案例」任务的排查过程:会话心跳接口如何按 accumulated_ms 累计、visibilityState 被置为 hidden 时心跳为何静默、以及多轮心停在 20 秒附近时的现场判断方法,最后给出可复现的核对顺序与结论。

在鸿蒙开发实践中心做「每日浏览一个案例」时,页面是否计入时长不取决于你停留多久,而取决于前端心跳有没有被服务端接受并累计。

一、心跳接口形态

案例详情页会在加载后建立一次会话,之后每隔约 5 秒向 /api/growth/sessions/<base64>/heartbeat 发一次 POST。base64 段解出来是 JSON,关键字段是 accumulated_ms、case_id、last_beat_at、exp 与 task_key。服务端以 accumulated_ms 为准累加,达到 need_seconds 指定的秒数后把 today_status 置为 done。

二、实测现象

实测中累计值依次是 0、5235、10246、15236、20245,之后连续多次心跳仍停在 20245,页面侧没有任何报错。查询 /api/growth/tasks/case-view-daily 得到的 elapsed_seconds 始终是 0,只看这个字段会误判为完全没计时——真正的进度在心跳返回的会话对象里。

三、为什么卡在 20 秒

心跳走的是可见性门控:当 document.visibilityState 为 hidden 时定时器不再触发上报,后端也就无从累加。驱动环境里页面常被判定为后台,于是累计会定格。把 visibilityState 与 hidden 用 defineProperty 覆盖为可见后,心跳恢复计数,累计能继续往上走并最终完成任务。

四、可复现的核对顺序

先在案例详情页确认网络面板里出现 /sessions/<base64>/heartbeat 且状态 200;再解出 accumulated_ms 看是否单调递增;若两次心跳之间数值不变,先查页面可见性再查 isTrusted 之外的定时器问题;最后回任务中心点任务状态接口确认 today_status 由 todo 变 done,再去成长中心积分明细核对入账时间与剩余积分。

五、结论

这类「停留满 N 秒」的任务,可核验的证据链是三段:心跳请求存在且返回 200、accumulated_ms 单调递增到阈值、任务状态与积分流水发生变更。三者缺一都不能认为已到账。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。