在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) + "	isDeviceOwnerApp: " + 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>