静蹲 PRD
1. 行为配置
| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | static_squat / static-squat |
| taskId | string | candidate:20261016:supported-static-squat-v1;科学及动作条目键 |
| behaviorId / variantId | string或null | null / null;null不能提交正式完成 |
| behaviorName / categoryId | string | 静蹲 / physical_capacity |
| durationLabel | string | 45秒;只在入口显示预计时间,不作为动作量、保持预算、视频正式长度或结算条件 |
| deviceRequirements | array | [];视频跟练,不申请相机或动作权限 |
| illustration | 资源引用 | 统一页static-squat行为配图 |
| science.shared | string | 强化股四头肌与臀肌,提升下肢力量储备与膝关节稳定性。 |
| science.completion | string | 肌电图(EMG)研究显示,在浅至中度屈膝蹲姿下维持静态支撑,股四头肌(股直肌、股内侧肌)的肌电激活度随屈膝角度显著上升。刚才的短时保持与受控起身,正是在安全募集膝关节周围的稳定肌群。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy(元气) / 15;真实增加量仅从奖励回执读取 |
steps:
- 按配置的支撑方式站位,确认支撑稳固,把手机固定在前方。
- 跟随对应示范,在舒适范围内缓慢下蹲,保持稳定、自然呼吸。
- 按配置的保持段结束后受控起身,完整回到站姿;次数、组数和保持量由动作配置提供。
- 最后回到站姿,放松站稳;不适时停止,先慢慢起身并扶稳。
| 动作及播放配置 | 类型 | 值与校验 |
|---|---|---|
| supportMode | enum或null | null;必填,从扶稳浅蹲/靠墙浅蹲中明确一种;不能串为两组 |
| sets / repsPerSet | integer或null | null / null;均必填正整数,不由入口45秒反推 |
| holdMs | number或null,毫秒 | null;必填正数,不以关键帧停留或剪辑示例生成 |
| totalMediaDurationMs | number或null,毫秒 | null;成片确定后回填,须含全部完整下蹲、保持、起身及收尾 |
| mediaSource | 资源引用或null | null;正式业务必填,完整人物、支撑物、动作接触点和终帧 |
| cueTimeline | object[]或null | null;正式业务必填;每项含cueId、phase、startMs、endMs、字幕与配音;侧别及示范次数仅在本项阶段适用时携带;按正式媒体起止时间回填,不以入口预计时间补齐 |
| completionPolicy | object或null | null;正式业务必填,含policyId、所需独立完成证据及服务校验;不得默认播放结束等于身体完成 |
| previewMode | enum | keyframes;只查看下列视频占位与字幕锚点,不创建正式会话或产生完成资格 |
businessReady仅在身份、动作预算、正式媒体、完整时间轴和completionPolicy全部校验通过时为true;否则禁用业务开始与完成。媒体时轴必须连续、有限、无重叠倒序,覆盖完整回位收尾;区间前闭后开,末尾由媒体自然结束事件处理。关键帧预览不提供黑屏定时器,不用示例剪辑秒点形成身体剂量。
2. 页面、字段与操作位置
视频画面、字幕安全区、素材比例、时间轴、异常回位和播放控制继承体力储备视频执行规范的“公共布局”“时间轴”“播放控制与结果去向”;本项动作量、字幕锚点和必填配置以下列字段为准。规范中的剪辑沟通示例秒点不作为正式时间轴或剂量。
| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片 | 左配图;右名称与durationLabel,下方science.shared与元气图标;完成状态来自服务 |
| 行为详情 | 从上到下 | 返回、名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作;方法常驻展开 |
| 行为详情 | 底部固定区 | 配置有效时开始行动,请求中防重;配置缺项“暂不可开始”;今日已满3项禁用;已有当日记录左查看结果、右再练一次 |
| 执行A区 | 顶部公共控制 | 退出与声音开/关始终可用;关闭声音不隐藏字幕与示范进度 |
| 执行B区 | 中部主画面 | 视频占位标注“此处放视频”;使用人物和必要支撑物完整的关键帧,正式播放器替换占位后不显示开发标注 |
| 执行C区 | 视频下方安全区 | 同一时刻只显示一条当前字幕,最多两行;阶段切换原位替换,不遮挡手脚、接触点或支撑关系 |
| 执行D区 | 字幕下方 | 仅示范阶段或示范次数,不能称为用户完成次数;未知时长不显示倒数 |
| 结果 | 四层 | 引导播放结束事实或有效完成结果→真实元气回执→今日进度→立即可用的返回今日行动 |
公共入口、详情与执行容器遵循公共页面与结算§1—2。无需设备准备或教程确认页。预览锚点如下,只有画面、字幕与阶段,未取得正式媒体时不生成播放时刻:
| 阶段锚点 | B区画面 | C区字幕 | D区示范进度 |
|---|---|---|---|
| setup | 配置支撑物和站位 | 确认支撑稳固,站稳 | 准备 |
| descend | 舒适范围内缓慢下蹲 | 在舒适范围内缓慢下蹲 | 下蹲示范 |
| hold | 配置支撑姿势,保持稳定 | 保持稳定,自然呼吸 | 保持示范 |
| rise | 受控起身,回到站姿 | 缓慢起身,回到站姿 | 起身示范 |
| finish | 完整站稳后放松 | 回到站姿,放松站稳 | 示范收尾 |
左右按示范者身体标识;正面素材须写清观看对应关系,字幕换侧与实际画面同步。优先完整竖屏;其他比例也不得裁掉必要身体或支撑物。
3. 执行状态与判定
| phase | 进入条件与画面 | 处理与下一状态 |
|---|---|---|
| preview | 打开关键帧预览,显示视频占位及阶段字幕 | 仅切换锚点;无运行时钟、不计身体完成,不创建业务会话 |
| loading | 业务配置通过后加载正式媒体;首帧占位,字幕“视频加载中,请先保持舒适姿势” | 加载不计时;成功从首帧开始playing,失败进入error |
| error | “视频暂时无法播放” | 可重试或返回详情;不记完整播放,不提交完成 |
| playing | 按本项视频时间轴连续播放 | 画面、配音、字幕及示范进度共用mediaTimeMs;无逐次点击确认,按自然结束事件进入guideEnded |
| recover | 卡顿或退出继续后,字幕替换为“先慢慢起身,扶稳站好” | 停止媒体、配音及当前动作字幕;显示“重新开始 / 结束本次”;不自动续播或重播 |
| guideEnded | 完整媒体自然播放结束且最后回位收尾cue已结束;“引导播放结束” | 仅封存播放事实;按独立业务策略校验资格,未配置或不满足时不提交完成 |
setup→按sets与repsPerSet展开(descend→hold→rise)→finish→guideEnded。supportMode、次数、组数、holdMs或正式时间轴缺失时,保持段仅显示静态关键帧,不运行保持计时,不自动延长,不显示次数或保持倒数,不允许业务开始或完成。
| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | preview / loading / error / playing / recover / guideEnded / result / quit |
| previewPhase | enum或null | 只指向本项关键帧锚点,不生成媒体或动作完成事件 |
| playbackRunId | string或null | 正式从首帧开始时生成;重新开始生成新的播放运行标识,半途记录不拼接为完整播放 |
| mediaTimeMs / mediaDurationMs | number或null,毫秒 | 由正式播放器读取;未知时长为null;加载、卡顿和暂停不累加 |
| cueId / subtitle / demonstrationProgress | string或null | 取媒体当前阶段;次数只是示范次数,回位后才切换到下次 |
| guideEnded / guideEndedAt | boolean / 带时区ISO时间或null | 同一playbackRunId完整自然结束仅记一次;拖动预览或重复ended事件不得补判 |
| qualified | boolean | 须由completionPolicy及其所需独立证据验证;未配置时false,不能直接取guideEnded |
| paused | boolean | 公共退出确认期间冻结视频、配音、字幕与时间轴 |
播放结束、身体完成、服务完成记录和资源到账分别记录。播放器位置与示范次数不能充当身体识别数据,不能据此创建实际完成或到账成功。
4. 结束、退出、中断与重练
| 触发 | 状态处理 | 可见操作与去向 |
|---|---|---|
| 点退出 | 同步停止视频、配音、字幕;先处理已经发生的媒体结束边界,再进入公共确认 | “结束本次行动?”;正文“先回到舒适姿势。结束后,本次播放进度将清除。”;左继续行动、右结束本次 |
| 退出确认选择继续 | 进入同一执行页recover,提示“先慢慢起身,扶稳站好” | “重新开始 / 结束本次”;不续接半途动作 |
| 卡顿 | 立刻停止媒体、配音与示范进度,进入recover | 同上;不让用户在动作姿势等待缓冲结束自动继续 |
| 恢复态重新开始 | 丢弃半途完整播放资格,从首帧开始新的playbackRunId | 播放对应站位准备和全部动作,不拼接前后片段 |
| 结束本次或不适 | 停止媒体并清除本次未完成过程;提示“先慢慢起身,扶稳站好” | 返回原今日行动列表;不要求补做,不提交本次完成 |
| 后台、锁屏或页面关闭 | 结束半途引导,不保留中途播放续接资格 | 回前台今日行动;再次进入从首帧开始,不补算后台时间 |
| 已获有效业务自然完成后退出或中断 | 保留原sessionId完成请求与表现 | 按公共§3进入结果并查询原请求,不重复提交或发奖 |
| 已有记录点再练一次 | 公共重复提醒,取消留在详情;继续创建新repeat session | 从首帧开始;当日首次记录、回执及今日进度不变 |
公共页面与结算§3负责公共弹层、焦点与重练记录保护。本项播放恢复规则是先回位后用户决定重新开始或结束,不能用公共“继续”直接恢复身体动作片段。
5. 完成记录与结果字段
公共记录、首次去重、上限和奖励状态精确复用公共页面与结算§4—5:businessDate、sessionId、repeatSession、completionId、completedAt、completionStatus、failureReason、rewardStatus、rewardReceipt、completedCount、firstResult、firstResult.completedCountAtCompletion。
| 本项字段 | 类型 | 生成、读取及约束 |
|---|---|---|
| guideEndedAt | 带时区ISO时间或null | 仅正式媒体完整自然结束时生成;预览不生成 |
| playbackFact | object或null | mediaSource、playbackRunId、完整播放标记及终帧cue;不包含用户动作完成次数 |
| performance | string | 按已配置动作预算播放的静蹲引导结束;只可描述实际播放事实 |
| completionPolicyId / sessionEvidence | string或null / object或null | 正式业务资格所需配置及独立证据,不能从播放器进度伪造 |
| qualified | boolean | 身份、策略或必要证据缺项时false;不提交completionId或奖励事务 |
| 结果条件 | 第一层 | 资源回执与今日进度 |
|---|---|---|
| 只有视频结束 | “引导播放结束”与本次播放事实;不显示以身体完成为前提的science.completion | 无本次有效完成和奖励;资源、进度无确认值显示“待确认”,已有服务进度如实保留,不增加 |
| 预览阶段结束 | 保留“视频占位/阶段预览”标识,不伪装完整播放或身体完成 | 不创建会话完成或奖励,不增加进度 |
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion;success时标题按公共§5 | pending/unknown时资源“待确认”,查询原sessionId,进度不增加;完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现;隐藏science.completion | 不显示本次奖励;刷新服务实际进度,不自行增加 |
| 从已完成详情查看结果 | 首次有效完成记录的标题、表现与科学完成原文 | 查询首次completionId回执;显示服务当前业务日进度 |
| 重练且业务资格有效 | “本次练习完成”及本次表现,首次记录不覆盖 | 首次奖励回执+本次新增0,进度不增加 |
仅播放结束不得先写“行动完成”再等待服务补验证。所有请求重试使用原sessionId,奖励查询使用原completionId,返回今日行动随时可用。
6. 验收条件
| 操作或边界 | 通过条件 |
|---|---|
| 必要参数缺失 | 支撑、组数、次数、保持任一缺失,业务开始与完成均禁止;可查看静态阶段,不显示伪造倒数 |
| 支撑唯一 | 每段示范与同一supportMode一致;不把扶稳与靠墙拼成两组 |
| 完整回位 | 按配置展开完整下蹲、保持、起身周期;最后回到站姿后再收尾 |
| 视频占位 | B区标明此处放视频;C/D区字幕和阶段位置明确;静态预览无假时钟、动作识别或业务完成 |
| 时间轴 | 正式媒体、字幕、配音同轴;不以入口预计秒数强拉或压缩动作;加载不计时 |
| 卡顿与退出继续 | 立即停止并提示本项回位;继续到recover,手动重开从首帧;不自动续播或拼接完成 |
| 系统中断 | 后台结束半途引导,回前台列表;新会话从首帧,不增加今日进度或到账 |
| 播放结束与结果 | 只记播放事实,无有效独立资格不显示身体完成文案、completionId或到账成功 |
| 科学与元气 | 两字段逐字匹配taskId;金额与总表一致;实际到账只用奖励回执 |
| 已完成关系 | 底部查看结果/再练一次并排;重练独立session,不覆盖首次记录;返回立即可用 |