What's the difference between isDeviceLocked and isKeyguardSecure in android's KeyguardManager?

android api locking lockscreen keyguard
xmllmx picture xmllmx · May 4, 2015 · Viewed 7.9k times · Source

Below is excerpted from http://developer.android.com/reference/android/app/KeyguardManager.html

public boolean isDeviceLocked ()

Returns whether the device is currently locked and requires a PIN, pattern or password to unlock. Returns true if unlocking the device currently requires a PIN, pattern or password.

public boolean isKeyguardSecure ()

Return whether the keyguard requires a password to unlock. Returns true if keyguard is secure.

What's the difference between isDeviceLocked and isKeyguardSecure?

Answer

Martin Nordholts picture Martin Nordholts · May 5, 2015

public boolean isDeviceLocked ()

This method takes the current UI state of the Lockscreen into account.

So if a secure Screen Lock has been setup, it will contrary to isKeyguardSecure() return false if:

  • The user has unlocked the Lockscreen and is using the device
  • The Smart Lock feature (Settings -> Security -> Smart Lock) allows the device to be unlocked without further authentication

public boolean isKeyguardSecure ()

This method does NOT take the current UI state of the Lockscreen into account.

So if a secure Screen Lock has been setup, it will always return true, regardless of if the Lockscreen has been unlocked by the user or if Smart Lock allows unlock without further authentication.

I was not able to reproduce the behavior reported by ByteHamster btw.

Related questions

How can I send a Firebase Cloud Messaging notification without use the Firebase Console?

I'm starting with the new Google service for the notifications, Firebase Cloud Messaging. Thanks to this code https://github.com/firebase/quickstart-android/tree/master/messaging I was able to send notifications from my Firebase User Console to my Android device. …

Read More
App not setup: This app is still in development mode

I have followed the instructions here: The developers of this app have not set up this app properly for Facebook Login? Made my app public and the circle is green so the app is public. But when I try to …

Read More
How exactly to use Notification.Builder

I found that I am using a deprecated method for noficitations (notification.setLatestEventInfo()) It says to use Notification.Builder. How do I use it? When I try to create a new instance, it tells me: Notification.Builder cannot be resolved …

Read More