鸿蒙实践中心案例页计时心跳机制实测:30秒浏览任务的会话累计排查记录
在鸿蒙开发实践中心做「每日浏览一个案例」时,页面是否计入时长不取决于你停留多久,而取决于前端心跳有没有被服务端接受并累计。
一、心跳接口形态
案例详情页会在加载后建立一次会话,之后每隔约 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 单调递增到阈值、任务状态与积分流水发生变更。三者缺一都不能认为已到账。
- 点赞
- 收藏
- 关注作者
评论(0)