站立交替摆臂 PRD
1. 行为配置
| 字段 |
类型 |
值与规则 |
| catalogKey / section |
string |
arm_swing / arm-swing |
| taskId |
string |
design:20261016:alternating-arm-swing;科学文案和动作条目键 |
| behaviorId / variantId |
string或null |
null / null;null不可作为正式完成标识提交 |
| behaviorName / categoryId |
string |
站立交替摆臂 / agility |
| durationLabel |
string |
30秒;仅入口预计时间,不是播放预算或动作剂量 |
| deviceRequirements |
array |
[];不申请相机,不采集动作或用户节拍输入 |
| illustration |
资源引用 |
统一页arm-swing配图;入口与详情共用 |
| science.shared |
string |
调动双侧运动节律回路,提升肢体协调度与身体律动控制力。 |
| science.completion |
string |
协调动力学经典的 HKB 模型表明,双肢异向(一前一后 180° 相位差)交替运动比同向运动需要更高的辅助运动区(SMA)控制参与,以防止动作自发滑向同向。刚才的交替摆臂,正是在训练双侧异向节律的稳定性。 |
| steps |
string[] |
下列顺序常驻展开 |
| rewardType / rewardAmount |
enum / integer |
energy(元气) / 12;奖励配置不代替真实回执 |
steps:
- 面向屏幕站稳,双膝放松、双臂自然下垂,身边留出摆臂空间。
- 跟随镜像人物,一侧手臂向前摆,另一侧向后摆;随后交换。
- 双脚留在原位,双臂按舒适节奏交替,幅度以自然舒适为准。
| 执行配置 |
类型 |
值与校验 |
| totalCycles / playBudgetMs |
integer或null / number或null |
null / null;正式结束预算必填,不能从入口30秒或一组交换快照推导 |
| mirror / feetMove |
boolean |
true / false;双脚留在原位 |
| cycleDefinition |
string |
右臂前左臂后→左臂前右臂后→自然交换;中间位置是连续经过,不额外停顿 |
| mediaSource |
资源引用或null |
必填;跟练视频或连续动画,须含完整回位收尾 |
| cueTimeline |
object[]或null |
必填;每项cueId、phase、startMs、endMs、prompt、aux、轨道位置、侧别及周期/次数;同一媒体时轴,区间前闭后开,无重叠倒序 |
| completionPolicy |
object或null |
null;正式业务必填,含policyId、服务校验规则及所需独立证据;播放结束本身不得推断身体完成 |
正式开始前校验身份、媒体、完整时间轴、动作预算及completionPolicy;缺少任一必填配置时,业务开始禁用,且不能提交完成。关键帧预览不创建业务完成或奖励。时间轴的秒点读取正式媒体,不能按入口预计时间反推,不增加未确认的BPM、保持或轮数。
2. 页面、字段与操作位置
| 页面 |
区域及顺序 |
字段与操作 |
| 今日行动 |
卡片 |
左配图;右名称与durationLabel,下方science.shared及元气图标;完成状态读取服务 |
| 行为详情 |
自上而下 |
返回、名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作;方法不折叠 |
| 行为详情 |
底部 |
未完成配置有效时开始行动;配置缺项“暂不可开始”;请求中禁用;今日已满3项禁用;已完成左查看结果、右再练一次 |
| 行为执行 |
顶部 |
左退出、右声音开/关,下方行为标题;从详情直接进入局内加载或ready,不增加权限、准备或教程确认页 |
| 行为执行 |
中部主示范 |
中心主示范表现前后纵深;一臂向前、另一臂向后,随后交换;双脚原位;前后臂用形态及“向前/向后”文字区分 |
| 行为执行 |
下方提示、轨道与进度 |
示范下方单条右向左轨道;中心落点固定;实心右菱形表示右臂向前,空心左菱形表示左臂向前,并有文字标签;prompt、aux原位替换,不遮人物 |
| 行为执行 |
底部 |
未收尾时“不舒服,结束”;结束后显示引导结束 |
| 结果 |
四层位置 |
引导事实或有效完成标题与科学文案→真实元气回执→今日进度→立即可用的返回今日行动 |
入口、详情、已有完成记录与滚动位置复用公共页面与结算§1—2。独立资格校验通过且已提交完成后展示科学完成原文,包含pending/unknown;提交明确失败、资格不满足、预览或仅播放结束时隐藏完成原文。资源和今日进度仍等待服务确认。
3. 执行状态与判定
| phase |
进入条件与画面 |
推进、输入与下一状态 |
| ready |
面向屏幕站稳,双膝放松,双臂自然下垂 |
按配置时间轴开始,不新增准备时长 |
| right-front |
右臂向前、左臂向后 |
右侧事件到中心,随后自然交换进入left-front |
| left-front |
左臂向前、右臂向后 |
左侧事件到中心;自然经过return后继续right-front |
| return |
双臂交换途中经过身体两侧 |
不形成一次动作后的停顿;由正式预算决定继续还是在完整回位后收尾 |
| ended |
双臂慢慢放下,自然站稳 |
仅在有效播放预算满足并完成收尾时产生guideEnded |
正式结束预算必须有明确计量单位与边界。总周期数、总时长或阶段预算未配置时,只允许关键帧预览,不能把一个交替示例自动当作整局结束。
播放器自动衔接,不增加逐拍、逐步确认。加载时间不计播放时间;关闭声音不停止字幕、动作或轨道。轨道符号、示范位置及次数均只描述媒体,不生成用户命中、漏拍、连击、得分或健康变化。重复媒体结束事件按同一playbackRunId去重;后台时间、卡顿时间和退出冻结时间不计有效播放。
| 运行字段 |
类型与范围 |
更新规则与用途 |
| phase |
enum |
按状态表控制画面与播放 |
| playbackRunId |
string |
每次从首帧完整重开时生成;区分重开和继续 |
| mediaTimeMs |
number,≥0 |
以媒体当前时轴为准,不以墙钟累计代替 |
| cueId / prompt / aux |
string |
取当前cue;静音时保持完整可读 |
| paused |
boolean |
退出确认期间冻结媒体、字幕、轨道与声音 |
| guideEnded |
boolean |
自然播完全部预算及回位收尾后为true;跳播、审阅跳转或卡顿不补判 |
| qualified |
boolean |
仅业务身份、completionPolicy及独立证据校验通过才true;不得直接等于guideEnded |
4. 结束、退出、中断与重练
| 条件 |
状态处理 |
可见内容与去向 |
| 点退出 |
先处理已到的媒体边界,再同步冻结示范、字幕、声音、轨道与输入 |
公共双按钮“继续行动 / 结束本次”;正文提示“慢慢放下双臂,自然站稳。结束后,本次引导进度将清除。” |
| 退出继续 |
恢复退出前同一示范阶段、字幕与轨道相位;不把冻结时间记为动作或播放进度 |
留在原执行容器,不增加独立教程页 |
| 确认结束或不适 |
停止引导,清除本次未完成过程;不适时提示慢慢放下双臂,自然站稳 |
返回原今日行动;不催补做,不产生本次完成 |
| 后台、锁屏或关闭页面 |
停止并结束半途引导;不补算后台时间 |
回前台今日行动;再次开始为新sessionId,从首帧开始 |
| 引导自然结束 |
封存本次播放事实,按独立资格策略校验 |
仅播放事实进入引导结果;资格有效再按公共完成路径 |
| 已获有效自然完成再退出或系统中断 |
保留表现、原sessionId完成请求和回执 |
进入结果查询原请求,不重复提交 |
| 再练一次 |
按公共重复提醒;继续创建新的repeat session |
从本项首帧新引导开始;首次记录、首次回执及今日进度不变 |
弹层焦点与未知请求恢复遵循公共页面与结算§3。退出继续的本项规则优先于通用恢复;冻结时间不得变成额外身体保持或自动计完成。
5. 完成记录与结果字段
完成记录、幂等与回执字段精确复用公共页面与结算§4—5:businessDate、sessionId、repeatSession、completionId、completedAt、completionStatus、failureReason、rewardStatus、rewardReceipt、completedCount、firstResult、firstResult.completedCountAtCompletion。
| 本项字段 |
类型 |
生成、读取及约束 |
| guideEnded / guideEndedAt |
boolean / 带时区ISO时间或null |
本次有效自然播放及收尾结束事实;与身体完成分开 |
| guideProgress |
object |
记录媒体源、playbackRunId、实际媒体进度与收尾cue,不含用户动作次数 |
| performance |
string |
展示实际播放预算及已播进度;没有用户动作计数 |
| completionPolicyId / sessionEvidence |
string或null / object或null |
正式完成须满足经配置的业务策略;不得伪造相机信号或从媒体位置生成身体动作证据 |
| qualified |
boolean |
completionPolicy为null、身份缺项或证据不满足时固定false |
| 结果条件 |
第一层 |
资源与今日进度 |
| 仅引导结束或预览收束 |
“引导结束”+本项播放事实;不显示以身体完成为前提的science.completion |
不创建completionId或奖励事务;资源无回执显示“待确认”,今日进度显示服务已确认值,无值“待确认” |
| 资格有效且已提交完成 |
completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion;success时标题按公共§5 |
pending/unknown时资源“待确认”,查询原sessionId,进度不增加;完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed |
“本次未完成”、可展示失败原因及本局表现;隐藏science.completion |
不显示本次奖励;刷新服务实际进度,不自行增加 |
| 重练且资格有效 |
“本次练习完成”+本次表现;首次记录不变 |
读取首次回执并显示“本次新增0”;今日进度不增加 |
| 已完成详情查看结果 |
读取当日首次有效完成记录 |
查询首次completionId回执;服务当前业务日进度 |
查询沿用原sessionId或completionId,不重新播放、不重复发奖;返回今日行动始终立即可用。
6. 验收条件
| 操作或边界 |
通过条件 |
| 动作身份 |
前后异向交替,双脚原位;不能画成两臂左右张开或同向举臂 |
| 经过中位 |
return只表达连续交换,没有每对后的强制停顿 |
| 预算缺项 |
不按入口30秒或一次交换结束业务练习;业务开始与完成禁用,关键帧预览可看 |
| 无动作输入 |
无相机权限、触屏节拍、轨迹采集或动作正确判定;示范进度不能改写成用户实际完成 |
| 时间轴和播放预算 |
缺配置阻止业务开始与完成,预览仍可看关键帧;媒体、字幕、轨道同轴,不用入口时长代替 |
| 退出与中断 |
退出同步冻结,继续严格遵守本项恢复;结束清除半途过程,后台不续接,不增加完成或奖励 |
| 结果与原文 |
science两字段逐字匹配taskId,元气金额与行为配置总表一致;只有播放事实时不显示身体完成原文或到账 |
| 首次结果与重练 |
查看结果读取首次记录;新repeat session不覆盖首次表现、回执与今日进度;返回立即可用 |
| 窄屏与静音 |
示范、提示、轨道与底部控件互不遮挡;文字和符号独立传达动作,不依赖颜色或声音 |