ドキュメントを開く +

サウンドと通知レベル

通知をどれだけ目立たせるかを決めます。どのサウンドを鳴らすか、着信のように鳴らし続けるか、集中モードを突破するかを選べます。

内蔵サウンド#

sound に次のいずれかの名前を指定します。アプリの「設定 → サウンド」で試聴できます。

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 に指定してください。

取り込まずに自分でホストしたサウンドを鳴らすには、最大 6 MB の .caf ファイルへの HTTPS リンクを soundUrl に指定します。

着信のように鳴らす#

call=1 でサウンドを 30 秒間繰り返すので、1 件の通知でも見逃しにくくなります。内蔵サウンドにもカスタムサウンドにも使えます。

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 を返します。提供後はアプリで有効にし、volume で 0〜1 の音量を指定できるようになります。それまでは timeSensitive と call=1 を組み合わせてください。

Android の場合#

Android では Breeze の通知チャンネルに設定したサウンドが鳴るため、sound=default のみ受け付けます。レベルごとのサウンドは Android の Breeze の通知設定で変更してください。passive と timeSensitive にはそれぞれ専用のチャンネルがあります。