通知功能
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);