KeyguardManager.javaAPI DocAndroid 1.5 API5472Wed May 06 22:41:54 BST


public class KeyguardManager extends Object
Class that can be used to lock and unlock the keyboard. Get an instance of this class by calling {@link android.content.Context#getSystemService(java.lang.String)} with argument {@link android.content.Context#KEYGUARD_SERVICE}. The Actual class to control the keyboard locking is {@link}.

Fields Summary
private android.view.IWindowManager
Constructors Summary

        mWM = IWindowManager.Stub.asInterface(ServiceManager.getService(Context.WINDOW_SERVICE));
Methods Summary
public voidexitKeyguardSecurely($OnKeyguardExitResult callback)
Exit the keyguard securely. The use case for this api is that, after disabling the keyguard, your app, which was granted permission to disable the keyguard and show a limited amount of information deemed safe without the user getting past the keyguard, needs to navigate to something that is not safe to view without getting past the keyguard. This will, if the keyguard is secure, bring up the unlock screen of the keyguard.

callback Let's you know whether the operation was succesful and it is safe to launch anything that would normally be considered safe once the user has gotten past the keyguard.

        try {
            mWM.exitKeyguardSecurely(new IOnKeyguardExitResult.Stub() {
                public void onKeyguardExitResult(boolean success) throws RemoteException {
        } catch (RemoteException e) {

public booleaninKeyguardRestrictedInputMode()
If keyguard screen is showing or in restricted key input mode (i.e. in keyguard password emergency screen). When in such mode, certain keys, such as the Home key and the right soft keys, don't work.

true if in keyguard restricted input mode.

        try {
            return mWM.inKeyguardRestrictedInputMode();
        } catch (RemoteException ex) {
            return false;
public$KeyguardLocknewKeyguardLock(java.lang.String tag)
Enables you to lock or unlock the keyboard. Get an instance of this class by calling {@link android.content.Context#getSystemService(java.lang.String) Context.getSystemService()}. This class is wrapped by {@link KeyguardManager}.

tag A tag that informally identifies who you are (for debugging who is disabling he keyguard).
A {@link KeyguardLock} handle to use to disable and reenable the keyguard.

        return new KeyguardLock(tag);