public class KeyguardManager
extends Object
| java.lang.Object | |
| android.app.KeyguardManager | |
可用于锁定和解锁键盘的类。 通过调用参数KEYGUARD_SERVICE调用getSystemService(java.lang.String)获得此类的实例。 控制键盘锁定的实际类是KeyguardManager.KeyguardLock 。
Nested classes |
|
|---|---|
class |
KeyguardManager.KeyguardLock 此类已在API级别13中弃用。请 |
interface |
KeyguardManager.OnKeyguardExitResult 回调传递给 |
公共方法(Public methods) |
|
|---|---|
Intent |
createConfirmDeviceCredentialIntent(CharSequence title, CharSequence description) 获取提示用户确认设备当前用户的凭据（PIN，模式或密码）的意图。 |
void |
exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback) 此方法在API级别13中已弃用。请 此方法要求调用方拥有权限 |
boolean |
inKeyguardRestrictedInputMode() 如果键盘保护屏幕正在显示或处于受限的按键输入模式（即， |
boolean |
isDeviceLocked() 返回设备当前是否处于锁定状态，并需要PIN，图案或密码才能解锁。 |
boolean |
isDeviceSecure() 返回设备是否使用PIN，图案或密码进行保护。 |
boolean |
isKeyguardLocked() 返回键盘锁是否当前锁定。 |
boolean |
isKeyguardSecure() 返回键盘是否通过PIN，图案或密码进行保护，或者SIM卡当前处于锁定状态。 |
KeyguardManager.KeyguardLock |
newKeyguardLock(String tag) 此方法在API级别13中已弃用。请 |
继承方法(Inherited methods) |
|
|---|---|
 From class java.lang.Object
|
|
Intent createConfirmDeviceCredentialIntent (CharSequence title, CharSequence description)
获取提示用户确认设备当前用户的凭据（PIN，模式或密码）的意图。 如果用户成功完成挑战，则主叫方应使用startActivityForResult(Intent, int)启动此活动并检查RESULT_OK 。
| 参数(Parameters) | |
|---|---|
title |
CharSequence
|
description |
CharSequence
|
| 返回(Returns) | |
|---|---|
Intent |
the intent for launching the activity or null if no password is required. |
void exitKeyguardSecurely (KeyguardManager.OnKeyguardExitResult callback)
此方法在API级别13中已被弃用。
改为使用FLAG_DISMISS_KEYGUARD和/或FLAG_SHOW_WHEN_LOCKED ; 这使您可以在应用程序移入和移出前台时无缝地隐藏键盘锁，并且不需要请求任何特殊权限。 安全地退出键盘保护装置。 此api的用例是，在禁用键盘保护程序后，您的应用程序被授予禁用键盘保护程序的权限，并显示在用户没有通过键盘保护程序时视为安全的有限信息，但需要导航到不是可以安全地查看而不会超过键盘。 如果键盘安全，则会提示键盘的解锁屏幕。
此方法要求调用方拥有权限 DISABLE_KEYGUARD 。
| 参数(Parameters) | |
|---|---|
callback |
KeyguardManager.OnKeyguardExitResult: 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. |
boolean inKeyguardRestrictedInputMode ()
如果键盘保护屏幕正在显示或处于受限键盘输入模式（即在键盘保护密码紧急情况屏幕中）。 在这种模式下，某些按键（如Home键和右软键）不起作用。
| 返回(Returns) | |
|---|---|
boolean |
true if in keyguard restricted input mode. |
也可以看看：
boolean isDeviceLocked ()
返回设备当前是否处于锁定状态，并需要PIN，图案或密码才能解锁。
| 返回(Returns) | |
|---|---|
boolean |
true if unlocking the device currently requires a PIN, pattern or password. |
boolean isDeviceSecure ()
返回设备是否使用PIN，图案或密码进行保护。
另请参阅 isKeyguardSecure() ，其将SIM锁定状态视为安全。
| 返回(Returns) | |
|---|---|
boolean |
true if a PIN, pattern or password was set. |
boolean isKeyguardLocked ()
返回键盘锁是否当前锁定。
| 返回(Returns) | |
|---|---|
boolean |
true if keyguard is locked. |
boolean isKeyguardSecure ()
返回键盘是否通过PIN，图案或密码进行保护，或者SIM卡当前处于锁定状态。
另请参阅 isDeviceSecure() ，其忽略SIM锁定状态。
| 返回(Returns) | |
|---|---|
boolean |
true if a PIN, pattern or password is set or a SIM card is locked. |
KeyguardManager.KeyguardLock newKeyguardLock (String tag)
此方法在API级别13中已被弃用。
改为使用FLAG_DISMISS_KEYGUARD和/或FLAG_SHOW_WHEN_LOCKED ; 这使您可以在应用程序移入和移出前台时无缝地隐藏键盘锁，并且不需要请求任何特殊权限。 使您能够锁定或解锁键盘。 通过调用Context.getSystemService()获取此类的实例。 本课程由KeyguardManager包装。
| 参数(Parameters) | |
|---|---|
tag |
String: A tag that informally identifies who you are (for debugging who is disabling he keyguard). |
| 返回(Returns) | |
|---|---|
KeyguardManager.KeyguardLock |
A KeyguardManager.KeyguardLock handle to use to disable and reenable the keyguard. |
Android开发手册