KeyguardManager.java revision 82893681ad6530eec8f2a9b4ecd2e039addf48b7
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.app.trust.ITrustManager; 20bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.content.Context; 2166093a9024a0ad88cb9c629457b9d8118071ae74Jim Millerimport android.content.Intent; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 25bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.os.ServiceManager; 26bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.os.UserHandle; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.IWindowManager; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.IOnKeyguardExitResult; 2998365d7663cbd82979a5700faf0050220b01084dJeff Brownimport android.view.WindowManagerGlobal; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 3266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Class that can be used to lock and unlock the keyboard. Get an instance of this 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * class by calling {@link android.content.Context#getSystemService(java.lang.String)} 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with argument {@link android.content.Context#KEYGUARD_SERVICE}. The 3537fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * actual class to control the keyboard locking is 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.app.KeyguardManager.KeyguardLock}. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class KeyguardManager { 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private IWindowManager mWM; 40bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos private ITrustManager mTrustManager; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Intent used to prompt user for device credentials. 4466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 4566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 4666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String ACTION_CONFIRM_DEVICE_CREDENTIAL = 4766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller "android.app.action.CONFIRM_DEVICE_CREDENTIAL"; 4866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 4966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 5066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * A CharSequence dialog title to show to the user when used with a 5166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link #ACTION_CONFIRM_DEVICE_CREDENTIAL}. 5266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 5366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 5466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String EXTRA_TITLE = "android.app.extra.TITLE"; 5566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 5666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 5766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * A CharSequence description to show to the user when used with 5866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link #ACTION_CONFIRM_DEVICE_CREDENTIAL}. 5966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 6066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 6166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String EXTRA_DESCRIPTION = "android.app.extra.DESCRIPTION"; 6266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 6366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 6466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Get an intent to prompt the user to confirm credentials (pin, pattern or password) 6566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * for the current user of the device. The caller is expected to launch this activity using 6666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link android.app.Activity#startActivityForResult(Intent, int)} and check for 6766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link android.app.Activity#RESULT_OK} if the user successfully completes the challenge. 6866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * 6966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @return the intent for launching the activity or null if no password is required. 7066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller **/ 71bde3d18dd5748bd24e527c653504346ad012c2dcJim Miller public Intent createConfirmDeviceCredentialIntent(CharSequence title, CharSequence description) { 7266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller if (!isKeyguardSecure()) return null; 7366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller Intent intent = new Intent(ACTION_CONFIRM_DEVICE_CREDENTIAL); 7466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.putExtra(EXTRA_TITLE, title); 7566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.putExtra(EXTRA_DESCRIPTION, description); 7666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller // For security reasons, only allow this to come from system settings. 7766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.setPackage("com.android.settings"); 7866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller return intent; 7966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller } 8066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 8166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 829567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 839567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 849567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 859567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 869567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 879567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handle returned by {@link KeyguardManager#newKeyguardLock} that allows 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you to disable / reenable the keyguard. 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class KeyguardLock { 92d7d2d43b4967bb907b61180aa9d12ca51aaa15e2Kenny Root private final IBinder mToken = new Binder(); 93d7d2d43b4967bb907b61180aa9d12ca51aaa15e2Kenny Root private final String mTag; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project KeyguardLock(String tag) { 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable the keyguard from showing. If the keyguard is currently 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * showing, hide it. The keyguard will be prevented from showing again 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * until {@link #reenableKeyguard()} is called. 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A good place to call this is from {@link android.app.Activity#onResume()} 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Note: This call has no effect while any {@link android.app.admin.DevicePolicyManager} 107cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * is enabled that requires a password. 108d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * 1099530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 1109530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 1119530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #reenableKeyguard() 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void disableKeyguard() { 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.disableKeyguard(mToken, mTag); 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reenable the keyguard. The keyguard will reappear if the previous 12337fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * call to {@link #disableKeyguard()} caused it to be hidden. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 125d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * A good place to call this is from {@link android.app.Activity#onPause()} 126d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * 127cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * Note: This call has no effect while any {@link android.app.admin.DevicePolicyManager} 128cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * is enabled that requires a password. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1309530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 1319530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 1329530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #disableKeyguard() 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void reenableKeyguard() { 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.reenableKeyguard(mToken); 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback passed to {@link KeyguardManager#exitKeyguardSecurely} to notify 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller of result. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnKeyguardExitResult { 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param success True if the user was able to authenticate, false if 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onKeyguardExitResult(boolean success); 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project KeyguardManager() { 15898365d7663cbd82979a5700faf0050220b01084dJeff Brown mWM = WindowManagerGlobal.getWindowManagerService(); 159bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos mTrustManager = ITrustManager.Stub.asInterface( 160bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos ServiceManager.getService(Context.TRUST_SERVICE)); 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1649567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 1659567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 1669567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 1679567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 1689567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 1699567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enables you to lock or unlock the keyboard. Get an instance of this class by 17166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * calling {@link android.content.Context#getSystemService(java.lang.String) Context.getSystemService()}. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class is wrapped by {@link android.app.KeyguardManager KeyguardManager}. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag A tag that informally identifies who you are (for debugging who 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is disabling he keyguard). 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A {@link KeyguardLock} handle to use to disable and reenable the 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn @Deprecated 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public KeyguardLock newKeyguardLock(String tag) { 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new KeyguardLock(tag); 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 185520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard is currently locked. 186520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 18737fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * @return true if keyguard is locked. 188520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 189520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardLocked() { 190520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood try { 191505312482782a600e997c91712f03f83c7a70428Mike Lockwood return mWM.isKeyguardLocked(); 192520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } catch (RemoteException ex) { 193520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return false; 194520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 195520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 196520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 197520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 198520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard requires a password to unlock. 199520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 20037fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * @return true if keyguard is secure. 201520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 202520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardSecure() { 203520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood try { 204520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return mWM.isKeyguardSecure(); 205520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } catch (RemoteException ex) { 206520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return false; 207520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 208520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 209520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 210520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If keyguard screen is showing or in restricted key input mode (i.e. in 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard password emergency screen). When in such mode, certain keys, 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as the Home key and the right soft keys, don't work. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if in keyguard restricted input mode. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.WindowManagerPolicy#inKeyguardRestrictedKeyInputMode 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inKeyguardRestrictedInputMode() { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mWM.inKeyguardRestrictedInputMode(); 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22850bfeec868157106e8b60abf8964cb24462af182Adrian Roos * Returns whether the device is currently locked and requires a PIN, pattern or 22950bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password to unlock. 230bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * 23150bfeec868157106e8b60abf8964cb24462af182Adrian Roos * @return true if unlocking the device currently requires a PIN, pattern or 23250bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password. 233bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos */ 23450bfeec868157106e8b60abf8964cb24462af182Adrian Roos public boolean isDeviceLocked() { 23550bfeec868157106e8b60abf8964cb24462af182Adrian Roos return isDeviceLocked(UserHandle.getCallingUserId()); 236bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 237bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos 238bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos /** 23950bfeec868157106e8b60abf8964cb24462af182Adrian Roos * Returns whether the device is currently locked and requires a PIN, pattern or 24050bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password to unlock. 241bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * 24250bfeec868157106e8b60abf8964cb24462af182Adrian Roos * @param userId the user for which the locked state should be reported. 24350bfeec868157106e8b60abf8964cb24462af182Adrian Roos * @return true if unlocking the device currently requires a PIN, pattern or 24450bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password. 245bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * @hide 246bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos */ 24750bfeec868157106e8b60abf8964cb24462af182Adrian Roos public boolean isDeviceLocked(int userId) { 248bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos try { 24950bfeec868157106e8b60abf8964cb24462af182Adrian Roos return mTrustManager.isDeviceLocked(userId); 250bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } catch (RemoteException e) { 251bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos return false; 252bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 253bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 254bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos 255bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos /** 25682893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * Returns whether the device is secured with a PIN, pattern or 25782893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * password. 25882893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * 25982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @return true if a PIN, pattern or password was set. 26082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos */ 26182893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos public boolean isDeviceSecure() { 26282893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return isDeviceSecure(UserHandle.getCallingUserId()); 26382893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 26482893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos 26582893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos /** 26682893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * Returns whether the device is secured with a PIN, pattern or 26782893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * password. 26882893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * 26982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @param userId the user for which the secure state should be reported. 27082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @return true if a PIN, pattern or password was set. 27182893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @hide 27282893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos */ 27382893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos public boolean isDeviceSecure(int userId) { 27482893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos try { 27582893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return mTrustManager.isDeviceSecure(userId); 27682893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } catch (RemoteException e) { 27782893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return false; 27882893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 27982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 28082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos 28182893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos /** 2829567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 2839567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 2849567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 2859567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 2869567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 2879567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exit the keyguard securely. The use case for this api is that, after 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabling the keyguard, your app, which was granted permission to 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disable the keyguard and show a limited amount of information deemed 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * safe without the user getting past the keyguard, needs to navigate to 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * something that is not safe to view without getting past the keyguard. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will, if the keyguard is secure, bring up the unlock screen of 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the keyguard. 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2979530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 2989530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 2999530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callback Let's you know whether the operation was succesful and 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it is safe to launch anything that would normally be considered safe 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * once the user has gotten past the keyguard. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3049567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn @Deprecated 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void exitKeyguardSecurely(final OnKeyguardExitResult callback) { 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.exitKeyguardSecurely(new IOnKeyguardExitResult.Stub() { 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onKeyguardExitResult(boolean success) throws RemoteException { 309a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller if (callback != null) { 310a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller callback.onKeyguardExitResult(success); 311a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller } 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }); 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 319