show · 显示一条系统通知。 - 鼠子Blog

显示一条系统通知。

签名

TypeScript

KSM.notification.show(args: {
  title: string;
  body: string;
}): Promise<{ shown: boolean }>

平台与权限

Windows	Android	权限
支持	支持	`notification.show`

Android13 及以上还需要运行时权限 POST_NOTIFICATIONS。

参数

参数	类型	必填	说明
`title`	`string`	是	通知标题
`body`	`string`	是	通知正文

返回值

错误	场景
普通 `TypeError`	标题或正文不是字符串
`PERMISSION_DENIED`	权限未授予，或 Android 运行时权限缺失
`NOT_SUPPORTED`	宿主没有配置通知服务
`TIMEOUT`	宿主未在默认时间内响应

行为

Windows 通过 Shell_NotifyIconW 添加或更新托盘通知图标。
Android 创建 kasumi 通知渠道并发送普通通知。
Android 没有 POST_NOTIFICATIONS 时返回 PERMISSION_DENIED。
Android 底层发送异常可能表现为 { shown: false }。
不支持点击回调、操作按钮或自定义图标。

示例

TypeScript

const result = await KSM.notification.show({
  title: 'Kasumi',
  body: '同步完成'
});

if (!result.shown) {
  console.info('系统没有接受通知');
}

错误

错误	场景
普通 `TypeError`	标题或正文不是字符串
`PERMISSION_DENIED`	权限未授予，或 Android 运行时权限缺失
`NOT_SUPPORTED`	宿主没有配置通知服务
`TIMEOUT`	宿主未在默认时间内响应

相关