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 creating the channel to display it.
First we retrieve the NotificationManager from NotificationManagerCompat. That’s the interface used for dealing with notifications on Android. Then we create a NotificationChannel that takes the channel’s id, name and importance as arguments. It’s advised to use NotificationManager.IMPORTANCE_HIGH for increasing the chances of the notification appearing as a heads up notification. We also change the lockscreenVisibility to Notification.VISIBILITY_PUBLIC to tell Android that the notification can be shown on the lock screen. Finally we call notificationManager.createNotificationChannel to register the channel.
Up until Android Nought (25), there’s 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 createNotificationChannel multiple times with the same channel, Android will ignore it if there’s an existing channel with the same id.
You should register your channels as early as possible, preferably when Application.onCreate is called.
Channels are immutable, if you need to change some channel configuration you’ll either have to delete the app or change the channel’s id.
Creating a Simple Notification
Now that we have created a channel, we can proceed to creating the notification.
First we start by creating a PendingIntent, that’s the intent that will be called when the notification is clicked, here we’ll simply start an activity. Then we call NotificationCompat.Builder to define how the notification will look like. The CHANNEL_ID parameter has to have the same id we used earlier to create the channel. If you want to learn how to customize you notification you can take a look at the Android Documentation.
The next step is simply calling notificationManager to show the notification. The notification id can be any number, it’s used only if you need to interact with the notification later.
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 a normal activity but there are 2 things you need to change for it to appear on the lock screen.
The first thing is calling showWhenLockedAndTurnScreenOn after onCreate 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 Activity in case you use it in other places.
The second thing is changing the manifest definition by adding launchMode and showOnLockScreen.
That’s it, you’ve created a 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 createNotification method we defined earlier. We need to create another PendingIntent that’ll start the activity that’ll be shown on the lock screen. We then pass that intent to setFullScreenIntent. It’s also important to add a category such as ALARM or CALL for increasing the chances of it appearing on the lock screen.
Here’s 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 Xiaomi and it’s not enabled by default.
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 notificationManager.cancel(id) when the lock screen activity is destroyed.
Conclusion
Android notifications are a great way to notify your users they need to do something but they might not be 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
Photo by Rami Al-zayat on Unsplash