跳到主要内容

通知功能

show_notification

用途:在 Windows 上弹出一条系统通知(操作中心 / 右下角那种),带标题、正文、可选图标和按钮。适合提醒用户任务完成、需要确认等。

int32_t show_notification(const NotificationParams* params);

NotificationParams 各字段是干什么的

字段用途
summary标题,必填,用户第一眼看到的。
body正文说明。
icon小图标的磁盘绝对路径
timeout停留多久(毫秒);<= 0 用系统默认。
button1 / button2通知上的按钮文字;用户点击会触发 notification-action 等(见 事件类型)。
text3多一行辅助文字。
action跟通知动作相关的参数,会进系统回调数据。

返回 1 表示已去显示,0 表示失败或非 Windows。

行为说明

不再需要单独调「注册应用」:第一次显示通知时库会在内部完成注册。用户点击、关闭或显示失败时,宿主通过 jade_on 收到的事件名见 事件类型 · 通知相关事件

示例(C 侧调用后,在回调里处理结果):

NotificationParams p = { 0 };
p.summary = "任务完成";
p.body = "处理已结束";
show_notification(&p);