通知トレイの管理

​

トレイ内の通知ライフサイクル

​

クリックと却下の動作

​

復元された通知（Android）

​

バッジの動作

​

プログラムによる通知のクリア

• コンテンツ消費に伴う同期：ユーザーが通知の指す画面（受信ボックス、メッセージセンター、アクティビティフィード）を開いたため、通知が不要になった場合。すべてをクリアするか、一部のコンテンツのみが消費された場合はターゲット指定のメソッドを使用します。
• ログアウト：前のユーザーの通知が次のユーザーに見えないよう、すべてをクリアします。

​

clearAllNotifications()

​

removeNotification() と removeGroupedNotifications()（Android）

​

一定時間後に通知を自動的に却下する

• Android 8.0（API 26）以降：通知サービス拡張機能で setTimeoutAfter() を使用してタイムアウトを設定します。タイムアウトが経過すると、Android は通知をシェードから削除します。API 26 未満のデバイスでは、この呼び出しは無視され、ユーザーが操作するまで通知が残ります。
• iOS：サポートされていません。iOS には配信済み通知を自動的に期限切れにする方法はありません。最も近い選択肢は、collapse_id を使用して新しい通知で置き換えるか、後続のプッシュが届いたときに Apple の removeDeliveredNotifications(withIdentifiers:) を使用して Notification Service Extension から削除することです。

class NotificationServiceExtension : INotificationServiceExtension {
    override fun onNotificationReceived(event: INotificationReceivedEvent) {
        event.notification.setExtender { builder ->
            // Remove this notification from the shade after 10 minutes (API 26+ only)
            builder.setTimeoutAfter(10 * 60 * 1000L)
        }
    }
}

public class NotificationServiceExtension implements INotificationServiceExtension {
    @Override
    public void onNotificationReceived(INotificationReceivedEvent event) {
        event.getNotification().setExtender(builder ->
            // Remove this notification from the shade after 10 minutes (API 26+ only)
            builder.setTimeoutAfter(10 * 60 * 1000L)
        );
    }
}

​

サービス拡張機能による通知のカスタマイズ

• Android では、INotificationServiceExtension を実装し、setExtender() を使用して NotificationCompat オプションを変更するか、event.preventDefault() を呼び出して表示を抑制します。
• iOS では、リッチメディア、バッジの増分、配信確認のために UNNotificationServiceExtension（セットアップ時に作成される OneSignalNotificationServiceExtension）を使用します。

​

FAQ

​

Android でアプリを開くと古い通知が再表示されるのはなぜですか？

​

TTL の期限が切れると、トレイから通知が削除されますか？

​

トレイをクリアせずにバッジだけをクリアできますか？

​

ユーザーが通知を却下したときのリスナーはありますか？