坐姿胸部伸展 PRD
1. 行为配置
| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | chest_stretch / chest-stretch |
| taskId | string | lib:BODY-013;读取动作与科学两字段的条目键 |
| behaviorId | string或null | lib:BODY-013;当日去重标识,null不得作为正式完成标识提交 |
| variantId | string或null | lib:BODY-013:minute-v1;null须由行为配置总表补齐后才能提交正式完成 |
| behaviorName / categoryId | string | 坐姿胸部伸展 / relaxation |
| durationLabel | string | 45秒;仅入口预计时间,不作为动作截止、保持时间或媒体时长 |
| deviceRequirements | array | [camera];仅要求双肩入镜,须经公共权限与取景准备 |
| illustration | 资源引用 | 统一页chest-stretch行为配图;入口和详情共用 |
| science.shared | string | 延展胸大肌与胸小肌,重塑体态并加深呼吸。 |
| science.completion | string | 生物力学研究证实,主动后展伸展能显著增加胸小肌长度(效应量达 40%),减少肩胛骨前倾牵拉,从肌群结构上为挺拔体态与胸廓呼吸腾出空间。 |
| steps | string[] | 按下列顺序展示,常驻展开 |
| rewardType | enum | energy;显示名称“元气” |
| rewardAmount | integer或null | 12;仅奖励资格配置,展示到账量须读取实际回执 |
steps:
- 坐在稳固、无轮且无扶手的椅子上,双脚平放,坐正并离开椅背;手机固定在前方,让双肩入镜。
- 肩膀向后、向下放松,双臂在身体两侧低位展开。
- 胸部轻轻向前、向上,感到舒适伸展后保持5秒,再慢慢放松回位。
- 共做5次,不为对准目标用力挺胸、后仰或屏住呼吸。
| 执行配置 | 类型 | 值与校验 |
|---|---|---|
| totalReps | integer | 5 |
| perSideReps / alternating | integer或null / boolean | null / false |
| holdMs | integer,毫秒 | 5000;仅本次可靠连续保持 |
| completionPolicy | object | {mode:"full-return",requiredReps:5,holdMs:5000};全部完整回位后才形成自然完成资格 |
| recognitionProfile | object或null | 必填;含profileId、已验证设备类型、关键点集合、置信门限(0—1)、稳定判定时长(>0ms)、舒适目标范围、回位范围、进出滞回与事件去重规则;各数值须由目标设备验证配置,不得从线稿位置推导 |
| recognitionProfile.requiredLandmarks | string[] | [left_shoulder,right_shoulder];只以双肩作为必需识别点;髋部、双臂和座位不作为取景或识别有效性的门槛 |
| settleMs | number,毫秒 | 必填,≥0;只控制回正后的结果过渡,不增加身体保持 |
正式开始须校验behaviorId、variantId、识别配置及目标设备支持列表均有效。识别配置缺失或设备未通过校验时,业务开始禁用;预览可查看关键帧,不产生识别事件、计次、完成或奖励。识别事件须携带sessionId、rep、phase、单调时间戳及唯一eventId,跨会话、跨次、重复或不可确认的事件一律拒绝。
2. 页面、字段与操作位置
| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片左侧及右侧 | 左侧illustration;右上behaviorName与durationLabel;其下science.shared;元气图标及服务返回的完成状态 |
| 行为详情 | 自上而下 | 返回今日行动、behaviorName→illustration→“行为说明”及science.shared→“怎么做”及steps→底部主操作;具体方法不折叠 |
| 行为详情 | 底部固定操作区 | 未完成且配置有效、未满3项时“准备开始”;请求中禁用防重;已完成左“查看结果”、右“再练一次”;已满3项禁用开始;配置缺项显示“暂不可开始”,原位说明缺少必要配置 |
| 摄像头准备 | 权限→取景→就绪 | 复用公共页面与结算§2;权限说明“开启摄像头,识别双肩动作与回正”;授权后取景示意只强调双肩,提示“请让双肩完整入镜”;权限拒绝可前往设置或返回详情,相机失败可重试或返回详情;双肩稳定可见且识别配置有效时才可开始,不要求髋部或双臂入镜 |
| 行为执行 | 顶部工具栏及标题 | 左“退出”,右“声音 开/关”;下方显示behaviorName |
| 行为执行 | 中上部主交互 | 左右联动目标、过程小目标、水波与大目标填色;不要求追逐小点 |
| 行为执行 | 同一场景右下角 | 常驻小示范;动作、保持或回正阶段同步,示范不驱动识别和计数 |
| 行为执行 | 场景外提示及底部进度 | prompt显示当前动作,aux显示要点;底部显示“第{rep}/5次”;保持阶段显示本次剩余秒数 |
| 完成结果 | 四层顺序 | 完成标题、行为名、本局表现及符合展示条件的science.completion→实际元气回执→今日进度→返回今日行动;字段按第5节 |
| 退出/重练确认层 | 执行或详情上方 | 复用公共页面与结算§3双按钮与焦点管理;本项恢复去向按第4节 |
入口、详情及已完成按钮关系复用公共页面与结算§1。返回今日行动保留列表滚动位置;结果底部返回立即可用。
3. 执行状态与判定
| phase | 进入条件与画面 | 输入、判定与下一状态 |
|---|---|---|
| move | 当前次开始;“胸部轻轻向前上方展开” | 按本项已校准的双肩动作信号推进过程反馈;到舒适目标进入hold |
| hold | “保持在舒适位置”;显示本次5秒剩余量 | 仅可靠连续保持累计;满5000ms立即提示回正,进入return;提前离开或信号丢失进入recover,当前次不计 |
| return | “慢慢回正”;当前次尚未计为完成 | 可靠确认回到自然坐姿后completedReps加1;未满总数进入下一次move,交替行为换侧;最后一次回正进入settling |
| recover | 先慢慢回正,停止填色与保持,当前次标无效 | 保留此前完整次数;回正并让双肩稳定重新入镜后重做当前次,当前保持从0开始;可结束回今日行动 |
| settling | 回到自然坐姿,显示已确认完整次数 | 不加做、不继续保持;按settleMs结束进入结果 |
次数以“完整动作+可靠连续保持5秒+回正”为单位,当前次未回正不加1。短暂抖动由recognitionProfile的稳定与滞回规则过滤,不补算不可确认时段;可靠输入持续不足时进入recover。目标按个人舒适范围配置,不以固定图形坐标要求更大幅度。肩向后下、双臂低位展开;不得将耸肩、后仰或单独移臂判作胸部前上舒展。
识别仅使用双肩必需关键点及其校准后的时序变化;姿态阈值仍读取已验证的recognitionProfile,不从示范图推导。仅髋部、双臂或座位未入镜不触发未就绪或识别丢失。双肩可靠信号不足时停止当前反馈并提示“先慢慢回正,让双肩重新入镜”,按recover重做当前次。
没有统一时长截断;入口预计时间不触发完成。保持到时即回正,命中、水波和填色动画不阻塞动作、不替代识别事件。
| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | 按状态表控制输入;只有动作态接收本项可靠识别事件 |
| rep | integer | 当前计划动作序号,按本项上限递增 |
| completedReps | integer | 只累计可靠确认并完整回位的次数;不能由示范或动画增长 |
| paused | boolean | 退出确认期间为true;冻结输入及反馈 |
| naturalCompleted / qualified | boolean | 自然收尾事实与业务资格分开;有效证据、身份及完成策略全部通过后qualified才为true |
| holdElapsedMs | number,0—5000 | 当前次可靠连续保持时长;提前离开或失真后归零 |
| fill | number,0—1 | 本次视觉进展;不参与业务计次或奖励 |
4. 结束、退出、中断与重练
| 条件 | 状态处理 | 可见内容、操作与去向 |
|---|---|---|
| 点退出 | 先处理受理时刻已到的自然边界,再冻结动作输入、计时、媒体、字幕及反馈 | “结束本次行动?”;正文“请先慢慢回正。结束后,本次进度将清除。”;左“继续行动”、右“结束本次” |
| 退出确认中继续 | 保留此前完整次数,当前次无效;先回正、重新稳定取景,再从当前次move重新做;不续接部分保持 | 关闭确认层,按本项恢复规则回到执行页;不得补算冻结时间 |
| 退出确认中结束 | phase=quit,清除本会话未完成过程 |
返回原今日行动列表;不提交本次完成,已有首次记录及回执不变 |
| 不适停止 | 停止输入或播放,慢慢回到舒适坐姿 | 显示“请停止练习,慢慢回到舒适坐姿”;返回今日行动,不催补做 |
| 后台、锁屏或关闭页面,尚无有效自然完成 | 停止本会话,清除半途动作与播放进度 | 回前台返回今日行动;再次开始新会话,从第1次或媒体首帧开始,不补算后台时间 |
| 已自然结束且业务资格有效 | 保留本局表现和同一完成请求 | 收束中退出显示“本局已结束”;继续恢复剩余收束,查看完成结果直接进入结果;系统中断后查询原sessionId |
| 只有引导结束或业务资格不足 | 不提交完成、不创建奖励事务 | 按第5节显示引导结束或未完成结果;不得借退出、重新进入或查询补造有效完成 |
| 已完成详情点再练一次 | 按公共页面与结算§3显示重复提醒 | 取消返回详情;继续创建新sessionId与repeatSession=true;重新走本项所需准备,清空本轮状态,首次记录不变 |
| 重练结束 | 保留本次表现,首次记录与奖励事务不变 | 只有资格校验通过才显示“本次练习完成”;本次新增0,今日进度不增加;仅引导结束仍按引导结果显示 |
退出确认与异常恢复均在原公共执行容器内处理。弹层内Tab限定双按钮,继续后焦点返回原操作区。
5. 完成记录与结果字段
完成与奖励的通用字段、幂等、未知状态查询和结果层级严格复用公共页面与结算§4—5:businessDate、sessionId、repeatSession、completionId、completedAt、completionStatus、failureReason、rewardStatus、rewardReceipt、completedCount、firstResult、firstResult.completedCountAtCompletion。同一sessionId仅提交一次;重试和查询沿用原标识;配置元气数不能代替到账回执。
| 本项字段 | 类型与范围 | 生成、读取及约束 |
|---|---|---|
| completedReps | integer,0—5 | 可靠确认并完整回位的次数;表现“完整回位{completedReps}次” |
| requiredReps | integer | 5 |
| recognitionProfileId / recognitionEvidence | string / object[] | 关联校验通过的识别配置及去重事件摘要;不得由动画或手动预览补造 |
| naturalCompleted / qualified | boolean | 末次回正确认后自然结束;满requiredReps且所有业务校验通过才可提交 |
首次完成请求除公共字段外包含completedReps、requiredReps、recognitionProfileId与本项有效事件摘要;不提交视觉fill或小目标数量作为健康效果证据。服务确认前不增加今日完成数。
| 结果条件 | 第一层内容 | 资源与今日进度 |
|---|---|---|
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion;success时标题按公共§5 | pending/unknown时资源“待确认”,查询原sessionId,进度不增加;完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现;隐藏science.completion | 不显示本次奖励;刷新服务实际进度,不自行增加 |
| 资格无效或业务配置缺项 | “本次未完成”、原因及已确认动作事实;不显示完成原文 | 不创建本次奖励;无确认值显示“待确认”;已有服务进度如实保留,不增加 |
| 从已完成详情查看结果 | 读取首次记录的标题、表现和科学完成原文 | 查询首次completionId奖励回执;显示当前业务日服务进度 |
| 重练且资格有效 | “本次练习完成”及本次表现,完成原文按公共规则显示 | 首次回执+“本次新增0”;不覆盖首次表现和完成时标题,今日进度不增加 |
所有结果保留立即可用的“返回今日行动”;查询仅刷新对应区域,不重新播放或重复发奖。
6. 验收条件
| 操作或边界 | 通过条件 |
|---|---|
| 肩部取景 | 仅双肩入镜即可准备;髋部、双臂和座位未入镜不阻止开始、不触发丢失;权限、取景、执行丢失和恢复提示均只要求双肩 |
| 动作量 | 5次;每次连续5秒并回位后计数 |
| 提前离开、丢失或退出后继续 | 此前完整次数不减;当前次不计,回正后重做;保持不得拼接前后两段 |
| 回正确认与重复事件 | 未回正不计数;同一eventId只记一次,旧rep事件不记到下一次 |
| 时长与反馈 | 预计时间到达不截断;保持到时立刻提示回正,不等待填色或水波 |
| 识别缺配置 | 业务开始禁用;线稿、点击外部审阅按钮和填色不会伪造动作完成 |
| 核对入口与详情 | 名称、配图、共用科学文案与展开方法顺序一致;预计时间不驱动动作或媒体截止 |
| 核对科学与资源 | 两段原文逐字匹配taskId;本项资源仅元气;无回执不显示到账,无score、动作分或百分比 |
| 查看结果与再练 | 底部并排双按钮;首次记录和回执不被重练覆盖,查询沿用原标识,返回立即可用 |
| 手机可用性 | 文字、示范和进度互不覆盖;滚动不遮主操作;静音不损失动作及退出信息 |