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