浏览文档 +

声音与提醒级别

决定一条通知有多响:播放哪种铃声、是否像来电一样持续响铃、能否突破专注模式。

内置铃声#

把 sound 设为以下名称之一。可以在 App 的“设置 → 声音”中试听。

alarm anticipate bell birdsong bloom calypso chime choo descent electronic fanfare glass gotosleep healthnotification horn ladder mailsent minuet multiwayinvitation newmail newsflash noir paymentsuccess shake sherwoodforest silence spell suspense telegraph tiptoes typewriters update

text
https://push.breezelabs.dev/YOUR_KEY/Coffee%20is%20ready?sound=minuet

自定义铃声#

在 iPhone 上打开“设置 → 声音 → 添加声音文件”,选择任意 m4a、mp3、wav 或 caf 文件。Breeze 会把它转换为 iOS 需要的格式,并截取前 30 秒。发送时把列表中显示的名称填进 sound。

不导入、直接播放你自己托管的铃声:在 soundUrl 中填写指向 .caf 文件的 HTTPS 链接,文件最大 6 MB。

像来电一样响铃#

call=1 会让铃声重复 30 秒,一条通知也很难错过。可与任意内置或自定义铃声配合使用。

text
https://push.breezelabs.dev/YOUR_KEY/Server%20is%20down?call=1&sound=alarm

提醒级别#

level 行为
active 默认。有声音和横幅
passive 静默加入通知中心,不点亮屏幕
timeSensitive 如果你允许 Breeze 发送“时效性通知”,可突破专注模式并在锁定屏幕上停留更久
critical 静音模式和专注模式下也会响铃。暂不可用

关键警报#

关键警报需要 Apple 授予的特殊权限,Breeze 目前还没有获得。在此之前,服务对 critical 返回 HTTP 422。开放后,你可以在 App 中开启,并用 volume 设置 0 到 1 的音量。在此之前,请用 timeSensitive 配合 call=1。

Android#

Android 播放 Breeze 通知渠道中设置的声音,因此只接受 sound=default。请在 Android 的 Breeze 通知设置中按级别更改声音。passive 和 timeSensitive 各有独立的渠道。