通知 | Notification

创建 OS 桌面通知

Process: Main

在渲染器进程中使用

如果您想要显示来自渲染器进程的通知，则应使用HTML5通知API

Class: Notification

创建 OS 桌面通知

Process: Main

Notification是一个 EventEmitter。

它创建一个新的Notification具有原生属性的设置options。

Static Methods

该Notification班有下列静态方法：

Notification.isSupported()

返回Boolean- 当前系统是否支持桌面通知

new Notification([options]) Experimental

• options 目的
  • title 字符串 - 通知的标题，当通知窗口显示时，它将显示在通知窗口的顶部
  • subtitle字符串 - （可选）通知的副标题，将显示在标题下方。苹果系统
  • body 字符串 - 通知的正文文本，将显示在标题或副标题下方
  • silent 布尔值 - （可选）显示通知时是否发出操作系统通知噪音
  • icon NativeImage - （可选）通知中使用的图标
  • hasReply布尔值 - （可选）是否向通知添加内联回复选项。苹果系统
  • replyPlaceholder字符串 - （可选）要在联机回复输入字段中写入的占位符。苹果系统
  • sound字符串 - （可选）显示通知时播放的声音文件的名称。苹果系统
  • actionsNotificationAction [] - （可选）添加到通知的操作。请阅读NotificationAction文档macOS中的可用操作和限制

Instance Events

创建的对象new Notification会发出以下事件：

注意：某些事件仅在特定的操作系统上可用，并且被标记为这样。

Event: ‘show’

返回：

• event Event

当通知显示给用户时发出，注意这可能会被多次触发，因为可以通过该show()方法多次显示通知。

Event: ‘click’

返回：

• event Event

当用户点击通知时发出。

Event: ‘close’

返回：

• event Event

当通过用户的手动干预关闭通知时发出。

在通知结束的所有情况下，此事件不能保证排除。

Event: ‘reply’ macOS

返回：

• event 事件
• reply 字符串 - 用户在内嵌回复字段中输入的字符串

当用户点击通知时的“回复”按钮时发出hasReply: true。

Event: ‘action’ macOS

返回：

• event 事件
• index Number - 已激活的操作的索引

Instance Methods

创建的对象new Notification具有以下实例方法：

notification.show()

立即向用户显示通知，请注意这与HTML5 Notification实现不同，只是实例化new Notification并不立即向用户显示，您需要在OS显示之前调用此方法。

Playing Sounds

在macOS上，您可以指定显示通知时要播放的声音的名称。除了自定义声音文件之外，还可以使用任何默认声音（在系统偏好设置>声音下）。确保声音文件在应用程序包（例如，YourApp.app/Contents/Resources）或以下位置之一下复制：

• ~/Library/Sounds
• /Library/Sounds
• /Network/Library/Sounds
• /System/Library/Sounds