计时卡

在列表中查看倒计时,并用右侧圆钮开始或暂停。

计时卡把时间、备注、进度环和开始/暂停按钮压进一张卡片。它负责画面,不负责计时:剩余时间、运行状态和环形进度都由应用算好,再交给 render。

Rust
use aeris_ui::device::countdown_card::{CardActions, CardState, CountdownCard};
基础用法
use aeris_ui::device::countdown_card::{CardActions, CardState, CountdownCard};

let actions = CardActions { open, menu, toggle, data: 7 };
let mut card = unsafe {
    CountdownCard::new(root, 8, *b"00:02:30", "Tea timer", actions)
};

if let Some(card) = card.as_mut() {
    card.set_ring_color(0x5EE7FE);
    card.render(*b"00:02:30", CardState::Ready, 0, false);
}

时间必须是 8 字节,例如 b"00:02:30"。data 会原样传给三个回调,适合在列表里标识具体任务。

组件结构

组成说明
卡面328 × 98 px 圆角卡片,横向位置固定 4 px。
时间30 px,位于左上 22, 16,只占数字和冒号。
备注25 px 次文字色,位于 22, 49。
右侧圆钮70 × 70 px,距右边 14 px,显示开始、播放或暂停图标。
进度环70 × 70 px,画在圆钮上;Ready 状态为 0。

圆钮的点击区由 13 条横带拼成,贴合圆形轮廓,点按圆外不会触发切换。

示例

开始与暂停

切换状态
extern "C" fn toggle(event: lv::Obj) {
    let data = unsafe { lvx_event_get_user_data(event) };
    let timer = app.timer_mut(data);
    timer.running = !timer.running;
    app.cards[data].render(
        timer.remaining,
        if timer.running { CardState::Running } else { CardState::Paused },
        timer.ring_steps,
        true,
    );
}

Ready 显示开始图标并隐藏进度环;Paused 显示播放图标;Running 显示暂停图标。两种非 Ready 状态都会在圆钮后面加一层半透明黑底。

每秒更新

倒计时
let moving = card.render(*b"00:02:29", CardState::Running, STEPS * 3 / 4, true);
if moving {
    // 数字仍在滚动,下一帧继续调用 draw。
}

render 返回数字是否仍在动画。把返回值接到页面的逐帧循环,或者直接按帧调用 draw。

只改颜色

进度环颜色
card.set_ring_color(0x5EE7FE);

颜色只作用于圆钮上的进度环,不影响时间和备注。

长按菜单

短按与长按
let actions = CardActions { open, menu, toggle, data: index };

短按卡片调用 open,长按调用 menu,点按右侧圆钮调用 toggle。三个回调都携带同一个 data。

停止动画

页面暂停
card.finish();

页面切走或暂停时调用 finish,让数字立即落到最新值,避免后台继续请求帧。

状态与交互

状态圆钮进度环
Ready开始图标,无黑底0,隐藏
Paused播放图标,半透明黑底显示传入进度
Running暂停图标,半透明黑底显示传入进度

短按卡片打开详情,长按打开菜单,点按圆钮切换计时。组件不判断当前是否真的在计时,只按传入状态绘制。

接口参考

CountdownCard::new

pub unsafe fn new(
    parent: Obj,
    y: i32,
    initial: [u8; 8],
    subtitle: &str,
    actions: CardActions,
) -> Option<Self>
参数类型说明
parentObj卡片挂载的父对象。
yi32纵向位置,横向固定 4 px。
initial[u8; 8]8 字节时间,如 b"00:02:30"。
subtitle&str计时备注。
actionsCardActions打开、菜单、切换回调与数据。

CardActions

字段类型说明
openLvxEventCallback短按卡片。
menuLvxEventCallback长按卡片或圆钮。
toggleLvxEventCallback点按右侧圆钮。
datausize三个回调共用的事件数据。

方法

方法返回值说明
render(bytes, state, ring_steps, animate_digits)bool更新时间、状态和环形进度,返回数字是否仍在动画。
set_ring_color(color)—设置进度环的 0xRRGGBB 色值。
draw(now)bool推进数字动画。
finish()—立即完成数字动画。
rootObj卡片根对象,可用于布局或销毁。

尺寸

项目值说明
卡片328 × 98 px与普通卡片一致。
圆钮70 × 70 px距右边 14 px。
时间字号30 px8 字节等宽数字。
进度范围0–256STEPS。

主题与样式

  • 时间使用主文字色,备注使用次文字色。
  • 圆钮图标来自三张独立素材,切换状态时替换图片来源。
  • 进度环默认使用素材原色,set_ring_color 可覆盖。
  • 计时卡不随主题自动换环色,需要按状态或主题手动设置。

交互与适配

  • 在 UI 线程创建和更新;父对象负责销毁。
  • 时间固定 8 字节,不足或超出都会影响排版。
  • 短按、长按和圆钮点击是三个独立入口,不要重复绑定。
  • 实际计时、持久化和通知由应用处理,组件只画状态。
  • 数字动画逐帧推进,页面不可见时停止调用 draw。

相关组件

设备端入口:device::countdown_card::CountdownCard

大纲