android API之KeyguardManager简介
android.app.KeyguardManager
类用于对
Keyguard
进行管理，即对锁屏进行管理
Class Overview
Class that can be used to lock and unlock the keyboard. Get an instance of this class by calling getSystemService(java.lang.String) with argumentKEYGUARD_SERVICE. The Actual class to control the keyboard locking is KeyguardManager.KeyguardLock.
（1）android.app.KeyguardManager
有两个内部类
| Nested Classes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| class | KeyguardManager.KeyguardLock | This class is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. Handle returned bynewKeyguardLock(String) that allows you to disable / reenable the keyguard. 其实该类所提供了解除锁屏和反解锁屏这两个功能并不能使用FLAG_DISMISS_KEYGUARD和FLAG_SHOW_WHEN_LOCKED来代替。不知gooolge为什么把它标为deprecated |
|||||||||
| interface | KeyguardManager.OnKeyguardExitResult | Callback passed to exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult) to notify caller of result. 这个是为得到执行exitKeyguardSecurely的结果设计的一个回调接口，以表示调用是否成功。 |
|||||||||
（2）主要函数
| void | exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. 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.
|
| boolean | inKeyguardRestrictedInputMode()
If keyguard screen is showing or in restricted key input mode (i.e.
这是函数用于判断当前是否处于锁屏状态。
|
| KeyguardManager.KeyguardLock | newKeyguardLock(String tag)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. Enables you to lock or unlock the keyboard. Get an instance of this class by callingContext.getSystemService(). This class is wrapped by KeyguardManager.
|
android.app.KeyguardManager.KeyguardLock
是
android.app.KeyguardManager
的内部类，我们真正的是通过它来解除锁屏和反解除锁屏
通过
disableKeyguard()
函数来解除锁屏，通过来
reenableKeyguard()
反解除锁屏.
reenableKeyguard()
反解除锁屏的意思是：如果在调用
disableKeyguard()
函数之前是锁屏的，那么就进行锁屏，否则不进行任何操作。当然如果之前没调用
disableKeyguard()
函数，也不进行任何操作。
（3）主要函数
| void | disableKeyguard()
Disable the keyguard from showing.
需要权限
android.permission.DISABLE_KEYGUARD
|
| void | reenableKeyguard()
Reenable the keyguard.
如果在此之前调用了
disableKeyguard()
函数，且在调用
disableKeyguard()
函数之前是锁屏的话，那么就进行锁屏，否则不进行任何操作。
|
android.app.KeyguardManager.OnKeyguardExitResult
只定义了个函数接口
onKeyguardExitResult(boolean success)
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| abstract void | onKeyguardExitResult(boolean success) 返回true表示exitKeyguardSecurely()函数执行成功，否则表示失败 |
||||||||||
实例1：
void test()
{
KeyguardManager keyguardManager=(KeyguardManager )getSystemService(Context.KEYGUARD_SERVICE);
String lockTag=this.getLocalClassName();
KeyguardManager.OnKeyguardExitResult keyguardExitResultListener =new KeyguardManager.OnKeyguardExitResult()
{
@Override
public void onKeyguardExitResult(boolean success) {
// TODO Auto-generated method stub
if(success)
Log.i(tag,"successfull to do Keyguard exit");
else
Log.i(tag,"fail to do Keyguard exit");
}
};
keyguardManager.exitKeyguardSecurely(keyguardExitResultListener);
KeyguardManager.KeyguardLock keyguardLock=keyguardManager.newKeyguardLock(lockTag);
for(int i=10;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will unlock the screen in "+i+" seconds");
}
keyguardLock.disableKeyguard();
for(int i=20;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will roll back the state of Keyguard in "+i+" seconds");
}
long t=System.currentTimeMillis();
keyguardLock.reenableKeyguard();
Log.i(tag,"time:"+(System.currentTimeMillis()-t));
}
注意：需要权限android.permission.DISABLE_KEYGUARD
| Nested Classes |
|||||||||||
class |
KeyguardManager.KeyguardLock |
This class is deprecated. Use |
|||||||||
interface |
KeyguardManager.OnKeyguardExitResult |
Callback passed to |
|||||||||
主要函数
| void | exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. 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.
|
| boolean | inKeyguardRestrictedInputMode()
If keyguard screen is showing or in restricted key input mode (i.e.
这是函数用于判断当前是否处于锁屏状态。
|
| KeyguardManager.KeyguardLock | newKeyguardLock(String tag)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. Enables you to lock or unlock the keyboard. Get an instance of this class by callingContext.getSystemService(). This class is wrapped by KeyguardManager.
|
android.app.KeyguardManager.KeyguardLock
是
android.app.KeyguardManager
的内部类，我们真正的是通过它来解除锁屏和反解除锁屏
通过
disableKeyguard()
函数来解除锁屏，通过来
reenableKeyguard()
反解除锁屏.
reenableKeyguard()
反解除锁屏的意思是：如果在调用
disableKeyguard()
函数之前是锁屏的，那么就进行锁屏，否则不进行任何操作。当然如果之前没调用
disableKeyguard()
函数，也不进行任何操作。
主要函数
| void | disableKeyguard()
Disable the keyguard from showing.
需要权限
android.permission.DISABLE_KEYGUARD
|
| void | reenableKeyguard()
Reenable the keyguard.
如果在此之前调用了
disableKeyguard()
函数，且在调用
disableKeyguard()
函数之前是锁屏的话，那么就进行锁屏，否则不进行任何操作。
|
android.app.KeyguardManager.OnKeyguardExitResult
只定义了个函数接口
onKeyguardExitResult(boolean success)
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| abstract void | onKeyguardExitResult(boolean success) 返回true表示exitKeyguardSecurely()函数执行成功，否则表示失败 |
||||||||||
实例1：
void test()
{
KeyguardManager keyguardManager=(KeyguardManager )getSystemService(Context.KEYGUARD_SERVICE);
String lockTag=this.getLocalClassName();
KeyguardManager.OnKeyguardExitResult keyguardExitResultListener =new KeyguardManager.OnKeyguardExitResult()
{
@Override
public void onKeyguardExitResult(boolean success) {
// TODO Auto-generated method stub
if(success)
Log.i(tag,"successfull to do Keyguard exit");
else
Log.i(tag,"fail to do Keyguard exit");
}
};
keyguardManager.exitKeyguardSecurely(keyguardExitResultListener);
KeyguardManager.KeyguardLock keyguardLock=keyguardManager.newKeyguardLock(lockTag);
for(int i=10;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will unlock the screen in "+i+" seconds");
}
keyguardLock.disableKeyguard();
for(int i=20;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will roll back the state of Keyguard in "+i+" seconds");
}
long t=System.currentTimeMillis();
keyguardLock.reenableKeyguard();
Log.i(tag,"time:"+(System.currentTimeMillis()-t));
}
注意：需要权限android.permission.DISABLE_KEYGUARD
| Nested Classes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| class | KeyguardManager.KeyguardLock | This class is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. Handle returned bynewKeyguardLock(String) that allows you to disable / reenable the keyguard. 其实该类所提供了解除锁屏和反解锁屏这两个功能并不能使用FLAG_DISMISS_KEYGUARD和FLAG_SHOW_WHEN_LOCKED来代替。不知gooolge为什么把它标为deprecated |
|||||||||
| interface | KeyguardManager.OnKeyguardExitResult | Callback passed to exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult) to notify caller of result. 这个是为得到执行exitKeyguardSecurely的结果设计的一个回调接口，以表示调用是否成功。 |
|||||||||
主要函数
| void | exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. 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.
|
| boolean | inKeyguardRestrictedInputMode()
If keyguard screen is showing or in restricted key input mode (i.e.
这是函数用于判断当前是否处于锁屏状态。
|
| KeyguardManager.KeyguardLock | newKeyguardLock(String tag)
This method is deprecated. Use FLAG_DISMISS_KEYGUARD and/or FLAG_SHOW_WHEN_LOCKED instead; this allows you to seamlessly hide the keyguard as your application moves in and out of the foreground and does not require that any special permissions be requested. Enables you to lock or unlock the keyboard. Get an instance of this class by callingContext.getSystemService(). This class is wrapped by KeyguardManager.
|
android.app.KeyguardManager.KeyguardLock
是
android.app.KeyguardManager
的内部类，我们真正的是通过它来解除锁屏和反解除锁屏
通过
disableKeyguard()
函数来解除锁屏，通过来
reenableKeyguard()
反解除锁屏.
reenableKeyguard()
反解除锁屏的意思是：如果在调用
disableKeyguard()
函数之前是锁屏的，那么就进行锁屏，否则不进行任何操作。当然如果之前没调用
disableKeyguard()
函数，也不进行任何操作。
主要函数
| void | disableKeyguard()
Disable the keyguard from showing.
需要权限
android.permission.DISABLE_KEYGUARD
|
| void | reenableKeyguard()
Reenable the keyguard.
如果在此之前调用了
disableKeyguard()
函数，且在调用
disableKeyguard()
函数之前是锁屏的话，那么就进行锁屏，否则不进行任何操作。
|
android.app.KeyguardManager.OnKeyguardExitResult
只定义了个函数接口
onKeyguardExitResult(boolean success)
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| abstract void | onKeyguardExitResult(boolean success) 返回true表示exitKeyguardSecurely()函数执行成功，否则表示失败 |
||||||||||
实例1：
void test()
{
KeyguardManager keyguardManager=(KeyguardManager )getSystemService(Context.KEYGUARD_SERVICE);
String lockTag=this.getLocalClassName();
KeyguardManager.OnKeyguardExitResult keyguardExitResultListener =new KeyguardManager.OnKeyguardExitResult()
{
@Override
public void onKeyguardExitResult(boolean success) {
// TODO Auto-generated method stub
if(success)
Log.i(tag,"successfull to do Keyguard exit");
else
Log.i(tag,"fail to do Keyguard exit");
}
};
keyguardManager.exitKeyguardSecurely(keyguardExitResultListener);
KeyguardManager.KeyguardLock keyguardLock=keyguardManager.newKeyguardLock(lockTag);
for(int i=10;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will unlock the screen in "+i+" seconds");
}
keyguardLock.disableKeyguard();
for(int i=20;i>0;i--)
{
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
Log.i(tag,"We will roll back the state of Keyguard in "+i+" seconds");
}
long t=System.currentTimeMillis();
keyguardLock.reenableKeyguard();
Log.i(tag,"time:"+(System.currentTimeMillis()-t));
}
注意：需要权限android.permission.DISABLE_KEYGUARD