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 19672055e8d9972c6d8ee2ec20443246b7a7e6573eTor Norbyeimport android.Manifest; 20672055e8d9972c6d8ee2ec20443246b7a7e6573eTor Norbyeimport android.annotation.RequiresPermission; 21bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.app.trust.ITrustManager; 22bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.content.Context; 2366093a9024a0ad88cb9c629457b9d8118071ae74Jim Millerimport android.content.Intent; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 27bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.os.ServiceManager; 28bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roosimport android.os.UserHandle; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.IWindowManager; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.IOnKeyguardExitResult; 3198365d7663cbd82979a5700faf0050220b01084dJeff Brownimport android.view.WindowManagerGlobal; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 3466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Class that can be used to lock and unlock the keyboard. Get an instance of this 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * class by calling {@link android.content.Context#getSystemService(java.lang.String)} 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with argument {@link android.content.Context#KEYGUARD_SERVICE}. The 3737fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * actual class to control the keyboard locking is 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.app.KeyguardManager.KeyguardLock}. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class KeyguardManager { 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private IWindowManager mWM; 42bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos private ITrustManager mTrustManager; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Intent used to prompt user for device credentials. 4666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 4766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 4866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String ACTION_CONFIRM_DEVICE_CREDENTIAL = 4966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller "android.app.action.CONFIRM_DEVICE_CREDENTIAL"; 5066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 5166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 5266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * A CharSequence dialog title to show to the user when used with a 5366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link #ACTION_CONFIRM_DEVICE_CREDENTIAL}. 5466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 5566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 5666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String EXTRA_TITLE = "android.app.extra.TITLE"; 5766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 5866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 5966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * A CharSequence description to show to the user when used with 6066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link #ACTION_CONFIRM_DEVICE_CREDENTIAL}. 6166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @hide 6266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller */ 6366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller public static final String EXTRA_DESCRIPTION = "android.app.extra.DESCRIPTION"; 6466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 6566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 6666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Get an intent to prompt the user to confirm credentials (pin, pattern or password) 6766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * for the current user of the device. The caller is expected to launch this activity using 6866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link android.app.Activity#startActivityForResult(Intent, int)} and check for 6966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * {@link android.app.Activity#RESULT_OK} if the user successfully completes the challenge. 7066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * 7166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * @return the intent for launching the activity or null if no password is required. 7266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller **/ 73bde3d18dd5748bd24e527c653504346ad012c2dcJim Miller public Intent createConfirmDeviceCredentialIntent(CharSequence title, CharSequence description) { 7466093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller if (!isKeyguardSecure()) return null; 7566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller Intent intent = new Intent(ACTION_CONFIRM_DEVICE_CREDENTIAL); 7666093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.putExtra(EXTRA_TITLE, title); 7766093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.putExtra(EXTRA_DESCRIPTION, description); 7866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller // For security reasons, only allow this to come from system settings. 7966093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller intent.setPackage("com.android.settings"); 8066093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller return intent; 8166093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller } 8266093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller 8366093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller /** 849567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 859567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 869567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 879567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 889567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 899567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handle returned by {@link KeyguardManager#newKeyguardLock} that allows 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you to disable / reenable the keyguard. 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class KeyguardLock { 94d7d2d43b4967bb907b61180aa9d12ca51aaa15e2Kenny Root private final IBinder mToken = new Binder(); 95d7d2d43b4967bb907b61180aa9d12ca51aaa15e2Kenny Root private final String mTag; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project KeyguardLock(String tag) { 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable the keyguard from showing. If the keyguard is currently 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * showing, hide it. The keyguard will be prevented from showing again 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * until {@link #reenableKeyguard()} is called. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A good place to call this is from {@link android.app.Activity#onResume()} 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10866093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * Note: This call has no effect while any {@link android.app.admin.DevicePolicyManager} 109cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * is enabled that requires a password. 110d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * 1119530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 1129530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 1139530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #reenableKeyguard() 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 116672055e8d9972c6d8ee2ec20443246b7a7e6573eTor Norbye @RequiresPermission(Manifest.permission.DISABLE_KEYGUARD) 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void disableKeyguard() { 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.disableKeyguard(mToken, mTag); 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reenable the keyguard. The keyguard will reappear if the previous 12637fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * call to {@link #disableKeyguard()} caused it to be hidden. 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 128d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * A good place to call this is from {@link android.app.Activity#onPause()} 129d6b5705e188e55a3b9dbb07954b16564b1a31b9fJim Miller * 130cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * Note: This call has no effect while any {@link android.app.admin.DevicePolicyManager} 131cb52cb52253c3832ccc7f5f1dbb4d8a0bd8178c0Jim Miller * is enabled that requires a password. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1339530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 1349530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 1359530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #disableKeyguard() 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 138672055e8d9972c6d8ee2ec20443246b7a7e6573eTor Norbye @RequiresPermission(Manifest.permission.DISABLE_KEYGUARD) 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void reenableKeyguard() { 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.reenableKeyguard(mToken); 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback passed to {@link KeyguardManager#exitKeyguardSecurely} to notify 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller of result. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnKeyguardExitResult { 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param success True if the user was able to authenticate, false if 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onKeyguardExitResult(boolean success); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project KeyguardManager() { 16298365d7663cbd82979a5700faf0050220b01084dJeff Brown mWM = WindowManagerGlobal.getWindowManagerService(); 163bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos mTrustManager = ITrustManager.Stub.asInterface( 164bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos ServiceManager.getService(Context.TRUST_SERVICE)); 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 1699567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 1709567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 1719567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 1729567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 1739567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enables you to lock or unlock the keyboard. Get an instance of this class by 17566093a9024a0ad88cb9c629457b9d8118071ae74Jim Miller * calling {@link android.content.Context#getSystemService(java.lang.String) Context.getSystemService()}. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class is wrapped by {@link android.app.KeyguardManager KeyguardManager}. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag A tag that informally identifies who you are (for debugging who 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is disabling he keyguard). 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A {@link KeyguardLock} handle to use to disable and reenable the 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1839567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn @Deprecated 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public KeyguardLock newKeyguardLock(String tag) { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new KeyguardLock(tag); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 189520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard is currently locked. 190520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 19137fde0aca01fcfcd8483df70a4e82f622e15fda2Jean-Michel Trivi * @return true if keyguard is locked. 192520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 193520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardLocked() { 194520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood try { 195505312482782a600e997c91712f03f83c7a70428Mike Lockwood return mWM.isKeyguardLocked(); 196520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } catch (RemoteException ex) { 197520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return false; 198520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 199520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 200520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 201520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 202c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * Return whether the keyguard is secured by a PIN, pattern or password or a SIM card 203c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * is currently locked. 204520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 205c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * <p>See also {@link #isDeviceSecure()} which ignores SIM locked states. 206c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * 207c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * @return true if a PIN, pattern or password is set or a SIM card is locked. 208520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 209520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardSecure() { 210520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood try { 211520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return mWM.isKeyguardSecure(); 212520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } catch (RemoteException ex) { 213520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood return false; 214520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 215520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood } 216520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 217520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If keyguard screen is showing or in restricted key input mode (i.e. in 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard password emergency screen). When in such mode, certain keys, 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as the Home key and the right soft keys, don't work. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if in keyguard restricted input mode. 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.view.WindowManagerPolicy#inKeyguardRestrictedKeyInputMode 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inKeyguardRestrictedInputMode() { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mWM.inKeyguardRestrictedInputMode(); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ex) { 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23550bfeec868157106e8b60abf8964cb24462af182Adrian Roos * Returns whether the device is currently locked and requires a PIN, pattern or 23650bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password to unlock. 237bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * 23850bfeec868157106e8b60abf8964cb24462af182Adrian Roos * @return true if unlocking the device currently requires a PIN, pattern or 23950bfeec868157106e8b60abf8964cb24462af182Adrian Roos * password. 240bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos */ 24150bfeec868157106e8b60abf8964cb24462af182Adrian Roos public boolean isDeviceLocked() { 24250bfeec868157106e8b60abf8964cb24462af182Adrian Roos return isDeviceLocked(UserHandle.getCallingUserId()); 243bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 244bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos 245bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos /** 246c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * Per-user version of {@link #isDeviceLocked()}. 247bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * 248bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos * @hide 249bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos */ 25050bfeec868157106e8b60abf8964cb24462af182Adrian Roos public boolean isDeviceLocked(int userId) { 251bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos try { 25250bfeec868157106e8b60abf8964cb24462af182Adrian Roos return mTrustManager.isDeviceLocked(userId); 253bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } catch (RemoteException e) { 254bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos return false; 255bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 256bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos } 257bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos 258bcd076525ccb8a3dfe7d1002bcae059661c1d111Adrian Roos /** 25982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * Returns whether the device is secured with a PIN, pattern or 26082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * password. 26182893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * 262c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * <p>See also {@link #isKeyguardSecure} which treats SIM locked states as secure. 263c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * 26482893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @return true if a PIN, pattern or password was set. 26582893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos */ 26682893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos public boolean isDeviceSecure() { 26782893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return isDeviceSecure(UserHandle.getCallingUserId()); 26882893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 26982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos 27082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos /** 271c39b4fc6864db8c41261acaa54e0ac6d6a3a9bc1Adrian Roos * Per-user version of {@link #isDeviceSecure()}. 27282893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * 27382893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos * @hide 27482893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos */ 27582893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos public boolean isDeviceSecure(int userId) { 27682893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos try { 27782893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return mTrustManager.isDeviceSecure(userId); 27882893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } catch (RemoteException e) { 27982893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos return false; 28082893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 28182893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos } 28282893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos 28382893681ad6530eec8f2a9b4ecd2e039addf48b7Adrian Roos /** 2849567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * @deprecated Use {@link android.view.WindowManager.LayoutParams#FLAG_DISMISS_KEYGUARD} 2859567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * and/or {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WHEN_LOCKED} 2869567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * instead; this allows you to seamlessly hide the keyguard as your application 2879567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * moves in and out of the foreground and does not require that any special 2889567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * permissions be requested. 2899567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn * 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exit the keyguard securely. The use case for this api is that, after 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabling the keyguard, your app, which was granted permission to 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disable the keyguard and show a limited amount of information deemed 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * safe without the user getting past the keyguard, needs to navigate to 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * something that is not safe to view without getting past the keyguard. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will, if the keyguard is secure, bring up the unlock screen of 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the keyguard. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2999530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * <p>This method requires the caller to hold the permission 3009530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * {@link android.Manifest.permission#DISABLE_KEYGUARD}. 3019530e3a22d5ffa2019d1a5177b6a441d4d6d048bNicolas Falliere * 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callback Let's you know whether the operation was succesful and 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it is safe to launch anything that would normally be considered safe 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * once the user has gotten past the keyguard. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069567a66a5e6f49dd8495fb5f6e2efb9f32e84b35Dianne Hackborn @Deprecated 307672055e8d9972c6d8ee2ec20443246b7a7e6573eTor Norbye @RequiresPermission(Manifest.permission.DISABLE_KEYGUARD) 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void exitKeyguardSecurely(final OnKeyguardExitResult callback) { 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWM.exitKeyguardSecurely(new IOnKeyguardExitResult.Stub() { 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onKeyguardExitResult(boolean success) throws RemoteException { 312a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller if (callback != null) { 313a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller callback.onKeyguardExitResult(success); 314a999d463c1f72fc7d9fcb21e850b78ec77793730Jim Miller } 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }); 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 322