请添加图片描述

1. 前言

点击花盆,瓢虫从叶后探出。轻轻倾斜手机,它沿叶片移动,有时出现在卡片边框之外。这时,如果用户想打开薄荷的观察日记,最显眼的瓢虫很容易成为下一次点击的目标。

这个动作暴露了一个设计问题:画面告诉用户“这里有东西”,却未必告诉用户“这里可以操作”。随着装饰向外伸展,两者之间的差别会更加明显。

上一篇讨论两态进出的画面衔接。这一篇固定已有资源、背景锚点和运动路线,检查另一个边界:日记入口应该放在哪里,以及普通态和激活态能否把用户带到同一盆植物的日记。

工程继续使用绑定薄荷 plant-001 的2×2桌面动态卡片,普通页面为 MintCard,激活页面为 MintLive,对应扩展仍为 MintFormAbility 与 MintLiveAbility。瓢虫在普通态藏于叶后,进入后到达既定路线起点,收束时沿原路线返回。观察日记依然由用户手动维护。

请添加图片描述

这里的目标很具体:用户点击日记按钮,最终看到 plant-001 的观察日记。应用被启动只是这条路径中的一个步骤。

2. 方案

可以把日记入口绑定在瓢虫身上。这个方案有一种直观的吸引力:用户看见植物旁的角色,点击它,进入植物页面。但入口会随动作改变位置,普通态又可能被叶片遮住。更直接的限制来自系统。

场景动效的出框只扩大渲染范围,原卡片区域之外的交互事件不响应。扩大画布,并没有同时获得一块更大的按钮。

因此,我把日记入口固定在原卡片底部。花盆区域用于触发动效,瓢虫负责装饰,日记按钮负责进入应用。三个对象各自表达一种意图,后续修改也有明确的落点。

画布局图时,我会同时标出三个范围:原卡片、出框渲染区域、日记按钮。原卡片限定交互的空间边界,按钮决定具体业务动作的命中范围。卡片内部的空白处不会因为位于边界以内,就自动获得导航职责。

请添加图片描述

事件结构应当与这份布局一致。如果整张卡片的父容器都绑定了动效点击,再在内部放一个日记按钮,就需要额外处理事件传播和竞争。先将两个区域分开,能够减少这种隐含关系。点击日记时,无须顺便唤醒瓢虫。

两态的导航方式有所不同。普通态通过卡片的 router 动作进入提供方应用;激活态通过 LiveFormExtensionContext.startAbilityByLiveForm 打开应用。它们可以采用不同的系统调用方式,但应当传达相同的业务目标。

这里的 router 指卡片动作,不能与应用内部的页面路由接口混用。前者负责进入应用,后者决定进入应用以后显示什么。把这两层拆开,才能解释“应用打开了,却没有打开日记”这类问题。

按钮位置也需要同样稳定。激活页面变大以后,按钮仍相对原背景排列,不能贴到新容器的底边。第05篇的进入、互动、收束阶段都沿用这一位置,装饰层也不能覆盖按钮。用户不应为了点击入口而等待动画播放完毕。

3. 实现

先处理坐标。普通态使用原卡片的局部坐标;激活态根据 liveFormInfo.rect 找到原背景,再放置相同的按钮。下面的函数只负责转换矩形,所有输入输出都使用vp:

interface Rect {
  left: number;
  top: number;
  width: number;
  height: number;
}

function inLivePage(card: Rect, button: Rect): Rect {
  return {
    left: card.left + button.left,
    top: card.top + button.top,
    width: button.width,
    height: button.height
  };
}

function fitsCard(button: Rect, width: number, height: number): boolean {
  return Number.isFinite(button.left) &&
    Number.isFinite(button.top) &&
    Number.isFinite(button.width) &&
    Number.isFinite(button.height) &&
    Number.isFinite(width) && Number.isFinite(height) &&
    width > 0 && height > 0 &&
    button.width > 0 && button.height > 0 &&
    button.left >= 0 && button.top >= 0 &&
    button.left + button.width <= width &&
    button.top + button.height <= height;
}

fitsCard 检查矩形包含关系,调用方还应为圆角和按钮的实际响应区域留出余量。一个矩形落在卡片包围盒内,并不能证明圆角附近的每一点都能响应点击。

沿用第03篇的演算:原卡片为160×160vp,申请区域为 (-20,-20,200,200)vp,原背景在激活页面中偏移到 (20,20)。按钮跟随这个偏移平移,宽高不变。布局时读取当前回调值,不把演算数字固化成设备尺寸,也不将窗口绝对位置当作局部偏移。

请添加图片描述

几何确定后,再定义导航契约。我倾向于先写下应用真正需要知道的内容,再处理两种发送方式。

项目约定
植物身份使用应用字段 plantId,本卡片绑定 plant-001
目标页面该植物的观察日记页面
卡片身份formId 用于关联实例和诊断,不替代植物身份
植物不存在显示植物不存在,并提供返回入口
植物存在但没有日记显示“还没有观察记录”,保留手动记录入口
参数无效显示入口信息异常,不默认切换到其他植物

plantId 是应用自己的约定。发送端从卡片绑定数据中取得它,接收端检查它,再查询持久化资料。不能因为当前只有一盆薄荷,就在所有导航分支里硬编码 plant-001。这样的捷径会把参数错误隐藏到增加第二张卡片时。

普通态的日记按钮发送 router 动作;花盆区域继续通过 message → onFormEvent → requestOverflow 请求动效。激活态的日记按钮使用当前 LiveForm 上下文调用 startAbilityByLiveForm。这两条导航路径最终汇入提供方应用的 EntryAbility,由应用决定日记页的内容。

系统调用的参数结构应按当前SDK的卡片动作、Want和LiveForm接口分别接入。互动卡片开发中的通信关系可以帮助区分这些职责。外层结构不同,不妨碍应用在接收后将它们整理成同一个目标对象。

下面将目标解析独立出来。DiaryInput 表示接收层提取出的业务字段,不承担系统Want结构的定义:

interface DiaryInput {
  plantId?: string;
}

interface DiaryTarget {
  plantId: string;
}

function parseDiaryTarget(input: DiaryInput): DiaryTarget | undefined {
  const id = input.plantId;
  if (typeof id !== 'string' || id.trim().length === 0) {
    return undefined;
  }
  return { plantId: id };
}

这个函数只回答参数能否形成目标。它没有把“格式可接受”等同于“植物存在”。后者需要读取植物资料;读取失败、植物已删除、植物存在但没有日记,分别对应不同页面状态。

我也没有顺手对标识做大小写转换或删除两端空白。植物标识由应用生成,接收端应遵循同一规则。未经约定的规范化可能把一个错误标识变成另一个有效目标。

请添加图片描述

应用冷启动和已有实例接收新请求,都应调用同一套目标处理逻辑。若只在首次创建时解析参数,应用已打开后再点击卡片,就可能停留在之前的页面。页面尚未准备好时可以暂存已校验目标,待页面就绪后消费,不能静默丢弃。

重复点击还会带来另一个问题:第一次读取尚未完成,第二次请求已经到达。既要避免同一目标重复堆页,也要防止较早的读取结果覆盖较新的请求。应用接收层可以用一个递增序号管理异步结果的提交权:

class NavigationRevision {
  private value: number = 0;

  begin(): number {
    this.value += 1;
    return this.value;
  }

  isCurrent(revision: number): boolean {
    return revision === this.value;
  }

  invalidate(): void {
    this.value += 1;
  }
}

每次接受导航意图先调用 begin();读取完成后,只有 isCurrent() 为真时才提交页面状态。无效参数同样应开启一次新处理,防止前一次有效请求的晚到结果覆盖错误页。接收器销毁时调用 invalidate()。这控制的是结果提交,已经发出的读取是否可以取消,需要由存储层另行决定。

同目标重复请求则在应用导航层合并:目标页已经显示时更新必要内容,无须再压入一个相同页面。发送端可以抑制正在处理的重复发起,但两态不共享内存锁,接收端仍须承担最终判断。

启动失败时记录错误,并让仍然可交互的入口恢复。若LiveForm已经销毁,就由普通态承接后续操作,不在销毁回调里补发导航。单次动效最多3500ms,用户打开日记也不必等瓢虫完成回程。

4. 检验

我会先验证区域,再验证导航。前者回答事件有没有到达预期组件,后者回答应用是否理解了这个事件。将两者合并成一句“按钮能点”,会漏掉很多故障。

测试时固定设备、系统、SDK、构建、卡片位置、背景矩形与按钮布局。第04篇的路线和映射参数、第05篇的阶段安排和切换配置都保持不变。一次改变多个条件,会让边界问题很难定位。

点位位置主要检查
P1日记按钮中心是否进入目标日记,有无额外动效请求
P2按钮边界内侧是否属于实际设计命中区域
P3按钮外、卡片内的空白处是否错误触发导航或动效
P4花盆动效触发区普通态是否只走既有动效链
P5原卡片边界内外的成对点边界与圆角附近的实际响应
P6原卡片外的装饰位置是否产生卡片业务事件,以及宿主如何响应

请添加图片描述

设计点位记录为卡片局部vp,实际点击记录为屏幕px,同时保留像素密度与裁剪信息。边界内外的取点距离提前固定。一次无法确定落点的边缘点击,不能用来判断整条边界。

P6优先选择既定路线中瓢虫实际出框的位置。若当前姿态没有跨过原边界,就使用已有出框装饰位置,并在记录中区分。不要为了得到一张容易解释的截图,临时改变路线却仍沿用原来的条件说明。

框外点击不触发卡片业务,并不意味着手机完全没有响应。桌面可能处理该动作,也可能中断动画。记录时应将卡片事件、宿主操作和会话结束分开。

导航测试覆盖普通态、激活态的进入段、互动段与收束段,每种条件分别执行。点击发生时的实际状态需要结合日志和录屏确认,不能因为原计划在互动段点击,就把已经结束的会话算作激活态样本。

还要分别检查应用未启动和已有实例的情况。每次记录发送路径、请求结果、应用收到的 plantId、最终页面及植物身份。请求返回成功、应用收到参数和页面可见,是三个不同的观察点。

请添加图片描述

失败用例同样围绕这条路径安排:卡片还显示旧摘要,但植物已经删除;参数缺失或类型不符;植物存在而日记为空;读取失败;快速重复点击;点击恰逢会话结束。参数异常通过测试入口注入,植物删除则保留原卡片再操作,避免把两种条件混在一起。

每组有效条件重复三次并保存全部记录,快速点击另记次数与间隔。结果表保留预期、实际表现、日志及录屏编号;尚未执行的项目保持待测。不同阶段重新激活,不把多次会话拼成一次超过上限的操作。

判断入口是否可靠,需要同时看三个结果:目标正确,没有意外双触发,失败后仍可再次操作。只有按钮中心成功一次,还不足以解释边缘、重复点击与中断时的行为。

5. 结尾

日记入口的位置是一份交互约定。瓢虫可以随叶片移动,按钮则留在原卡片内,让普通态和激活态都能表达同一个清楚的动作。

两态分别处理系统启动方式,应用统一处理植物身份、页面落点与失败状态。区域清单、导航契约和逐点测试表,使布局变化和路由变化都有可核对的依据,也能把“点不到”与“到了错误页面”分开调查。

下一篇继续使用这盆 plant-001 和已有入口,检查系统打断及能力不可用时的退场行为,再增加一张植物卡片观察动效竞争。无论动画能否继续,普通态都应完整地保留摘要与日记入口。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐