我要评论在现代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参数设置超时时间。效果如下：
具体的参数可以参考这里：
方案二：通过编程方式实现
在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的气泡框：
不过如果每次都要使用一大串代码才能显示消息的话必然是低效的，而且需要换算时间至毫秒，所以我写了一个帮助函数在:
// 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程序中使用气泡消息框了。
参考：
您可能感兴趣的文章:
如您对本文有疑问或者有任何想说的，请 点击进行留言回复，万千网友为您解惑！
网友评论