搭肩绕肘 PRD
1. 行为配置
| 字段 |
类型 |
值与规则 |
| catalogKey / section |
string |
elbow_circles / elbow-circles |
| taskId |
string |
candidate:20261016:shoulder-elbow-circles-v1;读取动作与科学两字段的条目键 |
| behaviorId |
string或null |
null;当日去重标识,null不得作为正式完成标识提交 |
| variantId |
string或null |
null;null须由行为配置总表补齐后才能提交正式完成 |
| behaviorName / categoryId |
string |
搭肩绕肘 / relaxation |
| durationLabel |
string |
45秒;仅入口预计时间,不作为动作截止、保持时间或媒体时长 |
| deviceRequirements |
array |
[camera];须经公共权限与取景准备 |
| illustration |
资源引用 |
统一页elbow-circles行为配图;入口和详情共用 |
| science.shared |
string |
联动肩袖与肩胛肌群,缓解肩颈沉重感,恢复肩背舒展与活力。 |
| science.completion |
string |
运动学著名的“肩肱节律”指出,手臂大范围活动需要盂肱关节与肩胛骨以约 2:1 的比例协同运转。刚才以肘画圈的动作,正是在温和动员肩袖与肩胛周围肌群,促进肩部复合体的协调活动。 |
| steps |
string[] |
按下列顺序展示,常驻展开 |
| rewardType |
enum |
energy;显示名称“元气” |
| rewardAmount |
integer或null |
15;仅奖励资格配置,展示到账量须读取实际回执 |
steps:
- 坐稳、坐直,双脚平放;手机固定在前方,让双肩、双肘和双手完整入镜。
- 双手放在肩上,跟着示范,用双肘慢慢绕一轮;左右肘分别带动左右水轮,只做舒适的幅度。
- 每轮绕完放下双臂、放松,两股水汇到同一株小芽,让它逐步长大;再搭肩开始下一次。
- 共做10次,同一方向,不抢拍、不追求更大的幅度。
| 执行配置 |
类型 |
值与校验 |
| plannedAttempts |
integer |
10;同一示范方向的计划动作机会,不额外补次数 |
| circleDirection |
enum或null |
必填且整局不变,与示范一致;不在局内新增反向一组 |
| recognitionProfile |
object或null |
必填;含profileId、已验证设备类型、关键点集合、置信门限(0—1)、稳定判定时长(>0ms)、舒适目标范围、回位范围、进出滞回与事件去重规则;各数值须由目标设备验证配置,不得从线稿位置推导 |
| completionPolicy |
object或null |
null;必填,定义有效结束证据、最低确认要求及服务校验;不得自行把10次计划机会或植物开花等同业务资格 |
| settleMs |
number,毫秒 |
必填,≥0;只控制放松后的结果过渡 |
正式开始须校验behaviorId、variantId、识别配置及目标设备支持列表均有效。识别配置缺失或设备未通过校验时,业务开始禁用;预览可查看关键帧,不产生识别事件、计次、完成或奖励。识别事件须携带sessionId、attemptIndex、phase、单调时间戳及唯一eventId,跨会话、跨次、重复或不可确认的事件一律拒绝。 completionPolicy缺失时只能预览,不允许正式业务开始与完成。
2. 页面、字段与操作位置
| 页面 |
区域及顺序 |
字段与操作 |
| 今日行动 |
卡片左侧及右侧 |
左侧illustration;右上behaviorName与durationLabel;其下science.shared;元气图标及服务返回的完成状态 |
| 行为详情 |
自上而下 |
返回今日行动、behaviorName→illustration→“行为说明”及science.shared→“怎么做”及steps→底部主操作;具体方法不折叠 |
| 行为详情 |
底部固定操作区 |
未完成且配置有效、未满3项时“准备开始”;请求中禁用防重;已完成左“查看结果”、右“再练一次”;已满3项禁用开始;配置缺项显示“暂不可开始”,原位说明缺少必要配置 |
| 摄像头准备 |
权限→取景→就绪 |
复用公共页面与结算§2;授权成功后取景;权限拒绝可前往设置或返回详情;相机失败可重试或返回详情;开始练习仅在取景及本项识别配置有效时可用 |
| 行为执行 |
顶部工具栏及标题 |
左“退出”,右“声音 开/关”;下方显示behaviorName |
| 行为执行 |
中上部 |
左右各一水轮,由本侧可靠进度驱动;两股水浇同一株植物,显示芽→幼苗→长叶→花苞→花 |
| 行为执行 |
右下角 |
当前搭肩、绕动或下放的小示范;常驻且不驱动计次 |
| 行为执行 |
提示与进度区 |
prompt为“搭肩/双肘慢慢绕一轮/放下双臂”;进度“第{attemptIndex}/10次”;植物生长与确认次数分别保存 |
| 完成结果 |
四层顺序 |
完成标题、行为名、本局表现及符合展示条件的science.completion→实际元气回执→今日进度→返回今日行动;字段按第5节 |
| 退出/重练确认层 |
执行或详情上方 |
复用公共页面与结算§3双按钮与焦点管理;本项恢复去向按第4节 |
入口、详情及已完成按钮关系复用公共页面与结算§1。返回今日行动保留列表滚动位置;结果底部返回立即可用。
3. 执行状态与判定
| phase |
进入条件与画面 |
输入、判定与下一状态 |
| align |
“双手轻放肩上” |
可靠确认搭肩后进入circle;不以点击进入确认动作 |
| circle |
双肘慢慢绕一轮;左右水轮分别随leftProgress/rightProgress转动 |
两侧均可靠完成同一圈轨迹后进入release;单侧多绕不多计 |
| release |
“放下双臂,轻轻放松” |
完整下放确认后本次confirmed=true,completedReps及growthCount各加1;每次只释放固定一股汇流水 |
| water |
两股水浇向同一株植物 |
动画不阻塞下一次align;第10次机会后回到舒适坐姿并进入settling |
| lost / recover |
看不清一侧时停止进度,提示先放松双臂;重新取景 |
当前机会标未确认,不释水、不增加生长;恢复后继续下一次计划机会,不补做;第10次失真后直接放松收尾 |
| settling |
双臂放松,自然坐稳 |
保留实际确认数与生长,不强制开花;按completionPolicy校验后进入对应结果 |
一次完整动作包括搭肩、双肘绕一轮、双臂下放。attemptIndex是本项唯一的计划机会序号,上限10;事件适配层如使用rep,rep必须为attemptIndex的只读同源别名,不能单独保存或递增。completedReps与growthCount均不超过已结束的计划机会数。水轮各自表达本侧进度,只有两侧完成且下放可靠确认后才同时增加一次计数和生长;速度、幅度和单侧多绕均不增加水量。识别丢失或退出打断当前次时,不追补该次;不存在恢复后为了凑开花而增加第11次。自然结束与资格分开,最低有效确认数不得自行补定。
| 运行字段 |
类型与范围 |
更新规则与用途 |
| phase |
enum |
按状态表控制输入;只有动作态接收本项可靠识别事件 |
| completedReps |
integer |
只累计可靠确认并完整回位的次数;不能由示范或动画增长 |
| paused |
boolean |
退出确认期间为true;冻结输入及反馈 |
| naturalCompleted / qualified |
boolean |
自然收尾事实与业务资格分开;有效证据、身份及完成策略全部通过后qualified才为true |
| attemptIndex |
integer,1—10 |
本次结束或未确认恢复后递增;达到上限停止追加动作 |
| leftProgress / rightProgress |
number,各0—1 |
分别来自左右肘可靠信号;失真即停止,不外推 |
| attemptResults |
object[],最多10项 |
每项attemptIndex、confirmed、reason;每个机会只封存一次 |
| growthCount |
integer,0—10 |
等于已确认完整次数;视觉生长不因丢失倒扣,不补齐未确认阶段 |
4. 结束、退出、中断与重练
| 条件 |
状态处理 |
可见内容、操作与去向 |
| 点退出 |
先处理受理时刻已到的自然边界,再冻结动作输入、计时、媒体、字幕及反馈 |
“结束本次行动?”;正文“请先放下双臂。结束后,本次进度将清除。”;左“继续行动”、右“结束本次” |
| 退出确认中继续 |
保留完整次数和植物生长;先下放重新取景,中断当前机会不补做,继续余下计划次数;若已是第10次则收尾 |
关闭确认层,按本项恢复规则回到执行页;不得补算冻结时间 |
| 退出确认中结束 |
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仅提交一次;重试和查询沿用原标识;配置元气数不能代替到账回执。
| 本项字段 |
类型与范围 |
生成、读取及约束 |
| attemptResults |
object[] |
本局10次机会各自的确认状态;无效事件不可补判 |
| completedReps / growthCount |
integer,0—10 |
表现“确认{completedReps}次完整动作”;两者一致 |
| naturalCompleted / qualified |
boolean |
计划机会结束并放松为自然收尾;qualified须读取completionPolicy,不由开花或确认次数自行推断 |
completionPolicy或正式身份未配置时qualified=false,不提交完成或奖励。资格有效后完成请求携带attemptResults、completedReps与识别证据摘要;植物图像和开花状态不作为服务完成证据。
| 结果条件 |
第一层内容 |
资源与今日进度 |
| 资格有效且已提交完成 |
completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion;success时标题按公共§5 |
pending/unknown时资源“待确认”,查询原sessionId,进度不增加;完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed |
“本次未完成”、可展示失败原因及本局表现;隐藏science.completion |
不显示本次奖励;刷新服务实际进度,不自行增加 |
| 资格无效或业务配置缺项 |
“本次未完成”、原因及已确认动作事实;不显示完成原文 |
不创建本次奖励;无确认值显示“待确认”;已有服务进度如实保留,不增加 |
| 从已完成详情查看结果 |
读取首次记录的标题、表现和科学完成原文 |
查询首次completionId奖励回执;显示当前业务日服务进度 |
| 重练且资格有效 |
“本次练习完成”及本次表现,完成原文按公共规则显示 |
首次回执+“本次新增0”;不覆盖首次表现和完成时标题,今日进度不增加 |
所有结果保留立即可用的“返回今日行动”;查询仅刷新对应区域,不重新播放或重复发奖。
6. 验收条件
| 操作或边界 |
通过条件 |
| 单次下放 |
绕完未下放不计数;双侧可靠且下放确认后只计1次、只长1阶段 |
| 缺一路识别 |
当前机会不确认;不补判、不补次数,已有确认数和生长不减少 |
| 第10次机会未确认 |
放松后收尾,可停在未开花状态;不能加第11次强制凑齐 |
| 退出继续 |
当前机会不续接、不补做;余下机会与已有植物阶段正确 |
| 资格与配置 |
正式身份、方向、识别或完成策略缺失阻止业务开始与完成;预览不得生成真实动作记录 |
| 核对入口与详情 |
名称、配图、共用科学文案与展开方法顺序一致;预计时间不驱动动作或媒体截止 |
| 核对科学与资源 |
两段原文逐字匹配taskId;本项资源仅元气;无回执不显示到账,无score、动作分或百分比 |
| 查看结果与再练 |
底部并排双按钮;首次记录和回执不被重练覆盖,查询沿用原标识,返回立即可用 |
| 手机可用性 |
文字、示范和进度互不覆盖;滚动不遮主操作;静音不损失动作及退出信息 |