Zeitkritische Benachrichtigungen anzeigen

Deine App muss in bestimmten Situationen, z. B. bei einem aktiven Alarm oder einem eingehenden Anruf, möglicherweise dringend die Aufmerksamkeit des Nutzers auf sich ziehen. Bei Apps, die auf Geräte mit Android 9 (API-Level 28) oder niedriger ausgerichtet sind, können Sie eine Aktivität starten, während die App im Hintergrund ausgeführt wird. In diesem Dokument wird beschrieben, wie das auf Geräten mit Android 10 (API-Level 29) bis Android 13 (API-Level 33) funktioniert.

Berechtigung POST_NOTIFICATIONS hinzufügen

Ab Android 13 fügen Sie der Datei AndroidManifest.xml die folgende Zeile hinzu:

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

Anschließend können Sie einen Benachrichtigungskanal erstellen.

Benachrichtigungskanal erstellen

Erstelle einen Benachrichtigungskanal, damit deine Benachrichtigungen richtig angezeigt werden und der Nutzer Benachrichtigungen in den App-Einstellungen verwalten kann. Weitere Informationen zu Benachrichtigungskanälen finden Sie unter Benachrichtigungskanäle erstellen und verwalten.

Erstellen Sie Ihre Benachrichtigungskanäle in der Methode onCreate Ihrer Application-Klasse:

class DACapp : Application() {
    override fun onCreate() {
        super.onCreate()
        val channel = NotificationChannel(
            CHANNEL_ID,
            "High priority notifications",
            NotificationManager.IMPORTANCE_HIGH
        )

        val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

Wenn der Nutzer deine App zum ersten Mal ausführt, wird auf dem Systembildschirm App-Info in etwa Abbildung 1 angezeigt:

Berechtigungen für Benachrichtigungen verwalten

Ab Android 13 müssen Berechtigungen zum Senden von Benachrichtigungen angefordert werden, bevor Nutzern Benachrichtigungen angezeigt werden.

Die minimale Implementierung sieht so aus:

val permissionLauncher = rememberLauncherForActivityResult(
    contract = ActivityResultContracts.RequestPermission(),
    onResult = { hasNotificationPermission = it }
)
...
Button(
    onClick = {
        if (!hasNotificationPermission) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                permissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
            }
        }
    },
) {
    Text(text = "Request permission")
}

Wenn auf Ihrem Gerät Android 13 ausgeführt wird, wird durch Tippen auf die Schaltfläche Request permission das in Abbildung 2 gezeigte Dialogfeld ausgelöst:

Wenn der Nutzer die Berechtigungsanfrage akzeptiert, sieht der Bereich App-Info der App wie in Abbildung 3 aus:

Benachrichtigung mit hoher Priorität erstellen

Geben Sie beim Erstellen der Benachrichtigung einen aussagekräftigen Titel und eine aussagekräftigen Nachricht an.

Das folgende Beispiel enthält eine Benachrichtigung:

private fun showNotification() {
    val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

    val notificationBuilder =
        NotificationCompat.Builder(this, CHANNEL_ID)
            .setSmallIcon(R.drawable.baseline_auto_awesome_24)
            .setContentTitle("HIGH PRIORITY")
            .setContentText("Check this dog puppy video NOW!")
            .setPriority(NotificationCompat.PRIORITY_HIGH)
            .setCategory(NotificationCompat.CATEGORY_RECOMMENDATION)

    notificationManager.notify(666, notificationBuilder.build())
}

Benachrichtigung für den Nutzer anzeigen

Durch den Aufruf der Funktion showNotification() wird die Benachrichtigung so ausgelöst:

Button(onClick = { showNotification() }) {
    Text(text = "Show notification")
}

Die Benachrichtigung in diesem Beispiel sieht aus wie in Abbildung 4:

Laufende Benachrichtigung

Wenn du deine Benachrichtigung für den Nutzer einblendest, kann er die Benachrichtigung oder Erinnerung durch deine App bestätigen oder schließen. Beispielsweise kann der Nutzer einen eingehenden Anruf annehmen oder ablehnen.

Bei einer laufenden Benachrichtigung, z. B. bei einem eingehenden Telefonanruf, musst du die Benachrichtigung mit einem Dienst im Vordergrund verknüpfen. Das folgende Code-Snippet zeigt, wie eine Benachrichtigung angezeigt wird, die mit einem Dienst im Vordergrund verknüpft ist:

// Provide a unique integer for the "notificationId" of each notification.
startForeground(notificationId, notification)

// Provide a unique integer for the "notificationId" of each notification.
startForeground(notificationId, notification);