在Android上启用Kiosk模式

我们的云帆机器人（上面运行的安卓程序）有一个线下场景是商场，由于商场人多，总会遇到一些用户在我们的app里乱点，然后会跳出程序进入到系统设置的一些界面，这样很不友好。

比如程序中有一些需要输入文字的地方，弹出了输入法，有的用户就去故意点输入法的设置，结果就能进入到安卓的系统设置，商场的用户用的是我们机器人程序而不是手机，并且机器人上本来就屏蔽了多任务和返回等虚拟按键，结果无法返回原来的程序。

一种解决方式是自己在程序里去实现一个中文的输入法，但这代价也太大了。

另外一种方式就是使用安卓的Kiosk模式。这个模式直译的话是贩售亭，但实际上的意思是屏幕固定功能，也就是我们想要将用户看到的屏幕固定到我们的app中的意思。

介绍url https://www.sureshjoshi.com/mobile/android-kiosk-mode-without-root/

源码展示区：https://github.com/sureshjoshi/android-kiosk-example

中文介绍 https://juejin.im/entry/578f873dd342d30058e99c51

只看代码可能不太明白，于是我对着代码自己重新写了一个demo。其中遇到的问题如下：

1.写好了后运行代码，并不能锁住，主要原因是没有admin的权限，这个需要到设置--系统安全--设备管理 中找到这个程序并选中才可以。

2.另外就是有了admin权限后还是不能锁定，debug后发现是判断isDeviceOwnerApp的时候为false，这个是因为一个系统只能有一个OwnerApp，需要使用adb命令设置对应的recevier。命令是：

adb shell dpm set-device-owner com.honghe.screenlocktest/.AdminReceiver

3.注意这个功能只能安卓5.1之后可用

代码如下

MainActivity

 package com.honghe.screenlocktest;

 import android.app.admin.DevicePolicyManager;
 import android.content.ComponentName;
 import android.content.Context;
 import android.os.Build;
 import android.support.annotation.RequiresApi;
 import android.support.v7.app.AppCompatActivity;
 import android.os.Bundle;
 import android.util.Log;
 import android.view.View;

 import java.io.BufferedReader;
 import java.io.DataOutputStream;
 import java.io.InputStream;
 import java.io.InputStreamReader;

 @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
 public class MainActivity extends AppCompatActivity {
     private static final String TAG = MainActivity.class.getName();
     private DevicePolicyManager dpm;
     private boolean inKioskMode;
     private ComponentName deviceAdmin;
     private Process process = null;
     private DataOutputStream os = null;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 lockScreen();
             }
         });
         findViewById(R.id.button2).setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 dislockScreen();
             }
         });
     }

     private boolean doLockScreen() {
         if (dpm.isLockTaskPermitted(this.getPackageName())) {
             Log.i("yunji.HotelAPP", "start lock screen");
             startLockTask();
             inKioskMode = true;
             Log.i("yunji.HotelAPP", "lock screen success");
             return true;
         }
         Log.w("yunji.HotelAPP", "cannot lock screen");
         return false;
     }

     private void lockScreen() {
         try {
             if (!inKioskMode) {
                 dpm = (DevicePolicyManager) getSystemService(Context.DEVICE_POLICY_SERVICE);
                 deviceAdmin = new ComponentName(this, AdminReceiver.class);
                 Log.e(TAG, "isAdminActive: " + dpm.isAdminActive(deviceAdmin) + "\tisDeviceOwnerApp: " + dpm.isDeviceOwnerApp(getPackageName()));
                 if (dpm.isDeviceOwnerApp(getPackageName())) {
                     //如果这里失效，请使用adb shell命令设置deviceOwnerAPP为当前app $ adb shell dpm set-device-owner com.honghe.screenlocktest/.AdminReceiver
                     //参考 https://juejin.im/entry/578f873dd342d30058e99c51
                     dpm.setLockTaskPackages(deviceAdmin,
                             new String[]{getPackageName()});
                     Log.e(TAG, "setLockTaskPackages: ");
                 }
                 doLockScreen();
             }
         } catch (Exception e) {
             Log.e("yunji.HotelAPP", "Exception: " + e);
         }
     }

     private void dislockScreen() {

         try {
             if (inKioskMode) {
                 stopLockTask();
                 inKioskMode = false;
             }
         } catch (Exception e) {
             Log.e("yunji.HotelAPP", "Exception: " + e);
         }
     }
 }

activity_main.xml

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:orientation="vertical"
     tools:context=".MainActivity">

     <TextView
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="Hello World!"
         app:layout_constraintBottom_toBottomOf="parent"
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintRight_toRightOf="parent"
         app:layout_constraintTop_toTopOf="parent" />

     <Button
         android:id="@+id/button"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="锁定" />

     <Button
         android:id="@+id/button2"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="解锁" />

     <EditText
         android:id="@+id/editText"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:ems="10"
         android:inputType="textPersonName"
         android:text="Name" />

 </LinearLayout>

AdminReceiver.java

 package com.honghe.screenlocktest;
 import android.app.admin.DeviceAdminReceiver;
 import android.content.Context;
 import android.content.Intent;

 /**
  * Created by zkzhou on 7/15/16.
  */
 public class AdminReceiver extends DeviceAdminReceiver {
     @Override
     public void onEnabled(Context context, Intent intent) {
     }

     @Override
     public CharSequence onDisableRequested(Context context, Intent intent) {
         return "Warning: Device Admin is going to be disabled.";
     }

     @Override
     public void onDisabled(Context context, Intent intent) {
     }

     @Override
     public void onLockTaskModeEntering(Context context, Intent intent,
                                        String pkg) {
     }

     @Override
     public void onLockTaskModeExiting(Context context, Intent intent) {
     }
 }

androidManifest.xml

 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.honghe.screenlocktest">

     <application
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
         android:theme="@style/AppTheme">
         <activity android:name=".MainActivity">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />

                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <receiver
             android:name=".AdminReceiver"
             android:label="@string/app_name"
             android:permission="android.permission.BIND_DEVICE_ADMIN">
             <meta-data
                 android:name="android.app.device_admin"
                 android:resource="@xml/device_admin" />

             <intent-filter>
                 <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
             </intent-filter>
         </receiver>
     </application>

 </manifest>

xml/device_admin.xml

 <device-admin xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-policies>
         <force-lock/>
         <watch-login/>
         <disable-camera/>
         <disable-keyguard-features/>
         <encrypted-storage/>
         <expire-password/>
         <limit-password/>
         <reset-password/>
         <set-global-proxy/>
         <wipe-data/>
     </uses-policies>
 </device-admin>