简体中文
阶段视图功能增强
约 681 字大约 2 分钟
2025-12-16
在阶段视图场景中，对阶段视图的统计字段区域进行自定义增强。
典型场景例如：
- 自定义阶段视图统计字段区域的展示内容
适用场景
适用于"阶段视图的统计字段区域需要定制化"的场景。
适用页面
- 阶段视图页面
什么时候适合做阶段视图功能增强
如果你遇到下面这些需求，通常都适合优先考虑阶段视图功能增强：
- 想自定义阶段视图顶部统计字段区域的内容
- 想在阶段视图渲染之前执行额外的业务逻辑
开发思路
阶段视图功能增强通常可以拆成三步理解：
- 明确要增强的是阶段视图的哪一个部分
- 选择合适的扩展事件/钩子
- 在插件中接入扩展点并验证行为
开发流程
明确场景与接入点
在开始之前，先确认以下问题：
- 逻辑需要在阶段视图渲染之前还是之后执行（Web 对应
stage.stageView.render.before；移动端对应customTotalInfoHook） - 是否涉及统计字段区域的定制
- 逻辑需要在阶段视图渲染之前还是之后执行（Web 对应
创建阶段视图插件
在后台创建 阶段视图 类插件（Web / 移动端按实际终端选择）。
选择事件或 Hook 并编写逻辑
Web 端：在插件
apply中注册stage.stageView.render.before事件，在回调内使用banner参数自定义阶段视图的统计字段区域。移动端：注册
customTotalInfoHook，在回调中返回自定义内容。联调与验证
- 验证阶段视图顶部统计字段区域的自定义效果
- 对照参考手册核对文案定制与返回值
发布与上线
开发完成后发布插件，在对应阶段视图场景中启用，并在真实流程任务上验证效果。
推荐入口
Web 端
stage.stageView.render.before— 阶段视图渲染之前
移动端
customTotalInfo— 自定义阶段视图统计字段区域
常见问题
Q：如何在阶段视图顶部添加自定义内容？
使用 stage.stageView.render.before 事件（Web）或 customTotalInfo Hook（移动端），在回调中返回自定义的 banner 内容。
Q：移动端如何实现与 Web 端相同的功能？
移动端使用 customTotalInfo Hook，通过返回自定义字符串或内容来实现阶段视图统计字段区域的自定义。