Today we’re gonna learn how to show a full screen activity instead of a notification when the device is locked. By default, Android will show the same notification it shows when the device is unlocked but in some cases, such as a phone call, you might want to display a full-screen activity. You can find the . source code here Creating The Notification Let’s start by creating a simple notification that’ll be used later to show an Activity on the look screen. The first thing we need to do before creating the notification is to create the channel to display it. private const val CHANNEL_ID = "heads_up_alerts"
private const val CHANNEL_NAME = "Heads Up Alerts"

private val notificationManager = NotificationManagerCompat.from(context)

private fun createNotificationChannel() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return

    val channel = NotificationChannel(
        CHANNEL_ID, CHANNEL_NAME, NotificationManager.IMPORTANCE_HIGH
    ).apply {
        lockscreenVisibility = Notification.VISIBILITY_PUBLIC
    }

    notificationManager.createNotificationChannel(channel)
} First, we retrieve the from . That’s the interface used for dealing with notifications on Android. Then we create a that takes the channel’s id, name and importance as arguments. It’s advised to use to increase the chances of the notification appearing as a heads-up notification. We also change the to to tell Android that the notification can be shown on the lock screen. Finally, we call to register the channel. NotificationManager NotificationManagerCompat NotificationChannel NotificationManager.IMPORTANCE_HIGH lockscreenVisibility Notification.VISIBILITY_PUBLIC notificationManager.createNotificationChannel Up until Android Nought (25), there was no need to create notification channels, that’s why there’s a guard cause at the beginning of the method. When Should I Create the Channel? There’s no problem in calling multiple times with the same channel, Android will ignore it if there’s an existing channel with the same id. createNotificationChannel You should register your channels as early as possible, preferably when is called. Application.onCreate ; if you need to change some channel configuration, you’ll either have to delete the app or change the channel’s id. Channels are immutable Creating a Simple Notification Now that we have created a channel, we can create the notification. private fun createNotification(): Notification {
    val contentIntent = Intent(context, HomeActivity::class.java)
    val contentPendingIntent = PendingIntent.getActivity(context, 0, contentIntent, 0)
    
    return NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notifications_active_black_24)
        .setColor(ResourcesCompat.getColor(context.resources, R.color.purple_200, null))
        .setContentTitle(context.getString(R.string.notification_title))
        .setAutoCancel(true)
        .setContentIntent(contentPendingIntent)
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .build()
} First, we start by creating a , that’s the intent that will be called when the notification is clicked. Here, we’ll simply start an activity. Then we call to define how the notification will look like. The parameter has to have the same id we used earlier to create the channel. If you want to learn how to customize your notification, you can take a look at the . PendingIntent NotificationCompat.Builder CHANNEL_ID Android Documentation The next step is simply calling to show the notification. The notification id can be any number; it’s used only if you need to interact with the notification later. notificationManager const val NOTIFICATION_ID = 24756

notificationManager.notify(NOTIFICATION_ID, createNotification()) That’s what you should see when your notification is displayed. Creating the Lock Screen Activity Now we’ll create the Activity that’ll be displayed on the lock screen. That activity is very similar to normal activity, but there are two things you need to change for it to appear on the lock screen. The first is calling after to define that the activity can appear on the lock screen and that the screen should be turned on when it appears. I added the method to the activity, but you can easily add that as an extension to the Activity in case you use it in other places. showWhenLockedAndTurnScreenOn onCreate class LockscreenActivity : AppCompatActivity() {

    private lateinit var binding: ActivityLockscreenBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        showWhenLockedAndTurnScreenOn()
        super.onCreate(savedInstanceState)

        binding = ActivityLockscreenBinding.inflate(layoutInflater)
        setContentView(binding.root)
    }

    private fun showWhenLockedAndTurnScreenOn() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O_MR1) {
            setShowWhenLocked(true)
            setTurnScreenOn(true)
        } else {
            window.addFlags(
                WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED
                        or WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
            )
        }
    }
} The second thing is changing the manifest definition by adding and . launchMode showOnLockScreen <activity
  android:name=".presentation.LockscreenActivity"
  android:launchMode="singleTop"
  android:showOnLockScreen="true" /> That’s it. You’ve created an activity that can appear on the lock screen. The last thing we need to do is to tell Android that we want that activity to appear on the lock screen instead of the notification. Adding the Activity to Notification We’ll have to modify the method we defined earlier. We need to create another that’ll start the activity that’ll be shown on the lock screen. We then pass that intent to . It’s also important to add a category such as ALARM or CALL to increase the chances of it appearing on the lock screen. createNotification PendingIntent setFullScreenIntent private fun createNotification(): Notification {
        val contentIntent = Intent(context, HomeActivity::class.java)
        val contentPendingIntent = PendingIntent.getActivity(context, 0, contentIntent, 0)

        val fullScreenIntent = Intent(context, LockscreenActivity::class.java)
        val fullScreenPendingIntent = PendingIntent.getActivity(context, 0, fullScreenIntent, 0)

        return NotificationCompat.Builder(context, CHANNEL_ID)
            .setSmallIcon(R.drawable.notifications_active_black_24)
            .setColor(ResourcesCompat.getColor(context.resources, R.color.purple_200, null))
            .setContentTitle(context.getString(R.string.notification_title))
            .setAutoCancel(true)
            .setContentIntent(contentPendingIntent)
            .setFullScreenIntent(fullScreenPendingIntent, true)
            .setPriority(NotificationCompat.PRIORITY_HIGH)
            .setCategory(NotificationCompat.CATEGORY_ALARM)
            .build()
    } Here’s a video of the . end result It’s not Working !!! For some of you, the activity might not appear on the lock screen, and that’s because of your phone. Not all phones allow full-screen intents by default. I have a and it’s not enabled by default. Xiaomi, To enable it, you have to go to the -> -> . app configuration Other permissions Show On Lock screen The notification will also not appear if you have an existing notification with the same id that has not been dismissed. Ideally, you should cancel the notification by calling when the lock screen activity is destroyed. notificationManager.cancel(id) Conclusion Android notifications are a great way to notify your users they need to do something, but they might not work well when the phone is locked. Full-screen activities come to solve that problem, allowing you to show the activity even if the phone is locked. The source code can be found . here Resources How to manage incoming video call for every Android OS version with FCM notifications Show an urgent message Photo by on Rami Al-zayat Unsplash Also published . here

This story contains new, firsthand information uncovered by the writer.

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

Ditch the Notification and Show an Activity on Your Android Lock Screen Instead

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

How I Built a Budget Tracker with Jetpack Compose

Java bits: 0xFF and 0xFFL

10 Things You Didn't Know You Could Do With Google Keep

10 Things to check on Android code reviews

10 Mistakes In Mobile App Development That Make You Look Dumb

How I Built a Budget Tracker with Jetpack Compose

Java bits: 0xFF and 0xFFL

10 Things You Didn't Know You Could Do With Google Keep

10 Things to check on Android code reviews

10 Mistakes In Mobile App Development That Make You Look Dumb

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps