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_KEYGUARDFLAG_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 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_KEYGUARDFLAG_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

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_KEYGUARDFLAG_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

你可能感兴趣的:(Android)