androidで画面をロックする方法がよく分からない。

「帰省 持ち物」というキーワードでここにたどり着く人が後を絶たない。

さて、androidで画面をロックするコードを書いたものの、今ひとつよく分からない。
ソフトウェア技術ドキュメントを勝手に翻訳 - Android 開発ガイド l. デバイス管理を参考にして、なんとか必要そうなコードを拾ったものの、やっぱりよく分からない。

まずは、AndroidManifest.xmlだが、タグ以下を追加してデバイス管理を許可する。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="jp.headcubicle"
      android:versionCode="1"
      android:versionName="1.0">
    <uses-sdk android:minSdkVersion="10" />

    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".LockTest"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <receiver android:name="DarSample"
            android:permission="android.permission.BIND_DEVICE_ADMIN">
            <meta-data android:name="android.app.device_admin"
                android:resource="@xml/dar_sample" />
            <intent-filter>
                <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

次に、/res/xmlの下に"dar_sample.xml"という名前でファイルを作成し、デバイスポリシを定義する。
今回は画面ロックが出来ればいいので、のみ記述する。

<?xml version="1.0" encoding="utf-8"?>
<device-admin xmlns:android="http://schemas.android.com/apk/res/android">
  <uses-policies>
    <force-lock/>
  </uses-policies>
</device-admin>

そして、一番よく分からないDeviceAdminReceiverのサブクラス。作成はしたものの、特に何をしているわけでもない。

package jp.headcubicle;

import android.app.admin.DeviceAdminReceiver;
import android.content.Context;
import android.content.Intent;

/**
 * 何もしない。
 */
public class DarSample extends DeviceAdminReceiver {

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

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

メインのActivity。と言ってもボタンが1個あるだけ。あとはDevicePolicyManagerを取得したり、Intentでデバイス管理を有効にしたりしている。

package jp.headcubicle;

import android.app.Activity;
import android.app.admin.DevicePolicyManager;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class LockTest extends Activity {
	
    static final int RESULT_ENABLE = 1;

    DevicePolicyManager mDevicePolicyManager;
    ComponentName mDarSample;
	
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        // DevicePolicyManagerを取得する。
        mDevicePolicyManager = (DevicePolicyManager)getSystemService(Context.DEVICE_POLICY_SERVICE);
        // ComponentNameを取得する。
        mDarSample = new ComponentName(this, DarSample.class);
        // デバイス管理を有効にする。
        Intent intent = new Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN);
        intent.putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN,
               mDarSample);
        startActivityForResult(intent, RESULT_ENABLE);

        setContentView(R.layout.main);
        
        Button lockButton = (Button) findViewById(R.id.lock_button);
        lockButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
            	// 画面ロック
            	mDevicePolicyManager.lockNow();
            }
        });
    }
    
    /** ApiDemosそのまま */
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        switch (requestCode) {
            case RESULT_ENABLE:
                if (resultCode == Activity.RESULT_OK) {
                    Log.i("DeviceAdminSample", "Administration enabled!");
                } else {
                    Log.i("DeviceAdminSample", "Administration enable FAILED!");
                }
                return;
        }
        super.onActivityResult(requestCode, resultCode, data);
    }
}

最後にレイアウト用のmain.xml。ボタンを追加しただけ。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <Button android:id="@+id/lock_button"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="lock" />
</LinearLayout>

一応、動きはするが、やっぱりよく分からない。