Qt显示Linux desktop natification气泡提示框

在现代Linux桌面环境上我们时常可以看到类似的消息框：

这些消息框常用在如下场景：

• 即时聊天软件的新消息
• 闹钟定时提示
• 电池电量提示
• 邮件消息
• 长耗时操作的完成提示

在freedesktop.org的规范中这种消息框被称为Desktop Notification，中文名我们形象得称其为“气泡框”。通过调用D-BUS服务org.freedesktop.Notifications提供的接口即可显示在桌面上。

所以我们先了解一下这个D-BUS服务。

org.freedesktop.Notifications概览

一个气泡框消息通常会包含如下的属性：

名称	说明
Application Name	标示发送消息的程序，最好使用程序全名
Replaces ID	可选的消息ID，服务器通过id控制消息框的渲染，通常不用关注
Icon	显示在气泡框上的图标
Summary	标题，只能显示一行，叫title应该更合适
Body	消息体，支持部分HTML标签；<b></b>；<i></i>；<u></u>；<a></a>；<img src=... alt=...>
Actions	显示一些按钮或者菜单（QAction），不过这一功能通常未被实现
Hints	为消息体提供的额外数据，比如显示在屏幕的位置（x，y坐标）
Expiration Timeout	气泡框显示的时长，单位毫秒；指定为-1时行为取决于实现；为0时气泡框将一直显示在桌面上直到用户点击

其中Icon和Hints中的image_path必须为本地绝对路径或者file://开头的文件URL。另外使用桌面环境预定义图标的名字也是可以的。

气泡框还有三个紧急程度可供选择：

名称	值	说明
Low	0	默认值，可以设置如何显示，应该设置一个合理的显示时间以便气泡框可以隐藏退出
Normal	1	同low
Critical	2	代表重要通知，不应该自动过期隐藏

所有的气泡框消息请求都是异步的，通常构造请求并发送后用户就可以不再关心后续的信息，如果有特殊需要则可以自定义处理org.freedesktop.Notifications发送的信号。

得益于freedesktop.org的标准规范，包括KDE，GNOME，XFCE4在内的许多桌面环境都提供了对Desktop Notification的支持，虽然外观上可能存在一些差异但是创建气泡框的方法是一样的。

不过不用担心，我们不会直接去使用D-BUS，因为已经有简化的现成方案可供选择了。下面就让我们一起看看这些方案。

方案一：调用外部命令

可能你已经知道了，我要介绍的命令就是notify-send。

notify-send几乎被所有的桌面环境和发行版支持，它依赖于后面会介绍的libnotify和glib，如果你的系统上没有安装可以使用如下命令进行安装：

debian/Ubuntu:

sudo apt install libnotify-bin

Arch Linux:

sudo pacman -S libnotify

安装后可以用如下命令显示气泡框：

# notify-send title body [options]
notify-send test 'This is a desktop Notification test.' -t 10000

-t参数设置超时时间。效果如下：

具体的参数可以参考这里：https://ss64.com/bash/notify-send.html

方案二：通过编程方式实现

在Qt代码中调用外部命令就可以显示气泡框，然而这种方式不够灵活，所以我们需要使用前面提到的libnotify在我们的代码里生成并显示气泡框。

libnotify对各个语言都提供了binding，可以参考这里。

这里我们选择使用golang的binding：

package main
import ("github.com/mqu/go-notify")

func main() {
	notify.Init("Hello world")
	hello := notify.NotificationNew("Hello World!", "This is an example notification.","dialog-information")
	hello.SetTimeout(5000)
	hello.Show()
}

上面的代码将会显示一个可以在桌面停留5s的气泡框：

不过如果每次都要使用一大串代码才能显示消息的话必然是低效的，而且需要换算时间至毫秒，所以我写了一个帮助函数在notify.go:

// ShowNotification 显示org.freedesktop.Notifications气泡消息框
// duration == -1时使用默认delay
// duration == 0表示不设置超时，desktop notification将会一直显示
func ShowNotification(title, text, image string, delay time.Duration) {
	var notifyDelay int32
	if delay == -1 {
		notifyDelay = duration2millisecond(defaultNotifyDelay)
	} else {
		notifyDelay = duration2millisecond(delay)
		// 不合法值(包括duration不足1ms)，使用默认值进行替换
		if notifyDelay == -1 {
			notifyDelay = duration2millisecond(defaultNotifyDelay)
		}
	}

	libnotify.Init(applicationName)

	notify := libnotify.NotificationNew(title, text, image)
	if notify == nil {
		fmt.Fprintf(os.Stderr, "Unable to create a new notification\n")
		return
	}
	notify.SetTimeout(notifyDelay)

	notify.Show()
}

// duration2millisecond 将time.Duration转换成millisecond
// duration不足1ms将返回-1
func duration2millisecond(duration time.Duration) int32 {
	res := int32(duration / time.Millisecond)
	if res < 0 {
		return -1
	}

	return res
}

首先将时间值转换成毫秒数，如果太小或者不合法就使用默认的停留时间。applicationName是程序的完整名称。

因为气泡框消息是异步的，所以在调用了Show()之后函数就会返回，后续操作xwindows都会帮我们处理，所以这个函数调用之后是立刻返回的，不会阻塞Qt的gui事件循环，可以放心的使用：

// download something success
ShowNotification("下载", "文件下载完成", "dialog-information", 5*time.Second)

这样我们也可以轻松地在我们的Qt程序中使用气泡消息框了。

参考：

https://developer.gnome.org/notification-spec/