Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

裝置管理總覽

裝置管理員淘汰作業。自 Android 9 (API 級別 28) 起，裝置管理員叫用某些管理政策時，系統會將這些政策標示為已淘汰。建議您現在就開始為這項異動做好準備。如要瞭解詳情及查看遷移選項，請參閱「裝置管理員淘汰」。

Android 提供 Android Device Administration API，支援企業應用程式。Device Administration API 提供系統層級的裝置管理功能。這些 API 可讓您建立具備安全意識的應用程式，在企業環境中非常實用，IT 專業人員需要對員工裝置進行豐富的控制。舉例來說，內建的 Android 電子郵件應用程式已運用這些 API 改善 Exchange 支援。Exchange 管理員可以透過電子郵件應用程式，在所有裝置上強制執行密碼政策，包括英數字元密碼或數字 PIN 碼。管理員也可以從遠端清除遺失或遭竊手機的資料 (即恢復原廠設定)。Exchange 使用者可以同步處理電子郵件和日曆資料。

本文適用於想為 Android 裝置開發企業解決方案的開發人員。本文將討論 Device Administration API 提供的各種功能，為採用 Android 系統的員工裝置提供更強大的安全性。

注意：如要瞭解如何建構 Android for Work 部署作業的工作政策控制器，請參閱「建構裝置政策控制器」。

無頭裝置擁有者模式

Android 14 (API 級別 34) 推出無頭系統使用者模式 (UserManager.isHeadlessSystemUserMode 傳回 true 的裝置)。在無頭系統使用者模式中，系統使用者是背景使用者，並依賴其他前景使用者與使用者互動。Android 14 也推出無頭裝置擁有者關聯模式，可為設定裝置擁有者的系統使用者以外的所有關聯使用者新增設定檔擁有者。

在設定無頭系統使用者 (系統使用者在背景執行) 的裝置上，只有全域範圍的裝置政策 (適用於所有使用者的政策) 會套用至前景使用者。詳情請參閱 addUserRestriction。

Android 裝置製造商可參閱 source.android.com 發布的指南。

Device Administration API 總覽

以下列舉幾種可能使用 Device Administration API 的應用程式類型：

電子郵件用戶端。
可遠端清除資料的安全防護應用程式。
裝置管理服務和應用程式。

運作方式

您可以使用 Device Administration API 編寫裝置管理應用程式，讓使用者安裝在裝置上。裝置管理應用程式會強制執行所需政策。運作方式如下：

系統管理員會編寫裝置管理應用程式，強制執行遠端/本機裝置安全性政策。這些政策可以硬式編碼到應用程式中，也可以由應用程式從第三方伺服器動態擷取。
應用程式會安裝在使用者的裝置上。Android 目前沒有自動佈建解決方案。sysadmin 可透過下列幾種方式，將應用程式發布給使用者：
- Google Play
- 啟用從其他商店安裝的功能。
- 透過其他方式發布應用程式，例如電子郵件或網站。
系統會提示使用者啟用裝置管理應用程式。提示的方式和時機取決於應用程式的實作方式。
使用者啟用裝置管理應用程式後，就必須遵守其政策。遵守這些政策通常會帶來好處，例如可存取機密系統和資料。

如果使用者未啟用裝置管理應用程式，該應用程式仍會保留在裝置上，但處於停用狀態。使用者不會受到政策規範，但相對地也無法享有應用程式的任何好處，例如可能無法同步處理資料。

如果使用者未遵守政策 (例如設定違反規範的密碼)，應用程式可自行決定如何處理。不過，這通常會導致使用者無法同步資料。

如果裝置嘗試連線至需要 Device Administration API 不支援政策的伺服器，系統將不允許連線。Device Administration API 目前不允許部分佈建。換句話說，如果裝置 (例如舊版裝置) 不支援所有指定政策，就無法連線。

如果裝置包含多個已啟用的管理應用程式，系統會強制執行最嚴格的政策。無法指定特定管理應用程式。

如要解除安裝現有的裝置管理員應用程式，使用者必須先取消註冊應用程式的管理員身分。

政策

在企業環境中，員工裝置通常必須遵守一組嚴格的政策，規範裝置的使用方式。Device Administration API 支援表 1 列出的政策。請注意，Device Administration API 目前僅支援螢幕鎖定密碼：

表 1. Device Administration API 支援的政策。

政策	說明
已啟用密碼	要求裝置詢問 PIN 碼或密碼。
密碼長度下限	設定密碼長度。例如，您可以要求 PIN 碼或密碼至少要有六個字元。
必須使用英數字元密碼	要求密碼必須由英文字母和數字組成。可能包含符號字元。
必須使用複雜密碼	密碼必須至少包含一個字母、一個數字和一個特殊符號。在 Android 3.0 中推出。
密碼須包含的最低英文字母數量	所有或特定管理員的密碼須包含的最低英文字母數量。Android 3.0 推出。
密碼須包含的小寫英文字母數量下限	所有或特定管理員的密碼須包含的小寫英文字母數量下限。Android 3.0 推出。
密碼須包含的非英文字母字元數量下限	所有或特定管理員的密碼須包含的最低非英文字母字元數量。Android 3.0 推出。
密碼須包含的最低數字數量	所有或特定管理員的密碼須包含的最低數字數量。Android 3.0 推出。
密碼須包含的最低符號數量	所有或特定管理員的密碼須包含的符號數量下限。Android 3.0 推出。
密碼須包含的大寫英文字母數量下限	所有或特定管理員密碼須包含的大寫英文字母數量下限。Android 3.0 推出。
密碼到期時間	密碼到期時間，以裝置管理員設定到期時間後的毫秒數表示。Android 3.0 推出。
密碼記錄限制	這項政策可禁止使用者重複使用最近 n 個不重複密碼。這項政策通常會與 `setPasswordExpirationTimeout()` 搭配使用，強制使用者在指定時間過後更新密碼。Android 3.0 推出。
密碼輸入錯誤次數上限	指定使用者在裝置抹除資料前，可以輸入錯誤密碼的次數。Device Administration API 也允許管理員從遠端將裝置恢復原廠設定。即使裝置遺失或遭竊，資料也安全無虞。
閒置時間鎖定上限	設定使用者最後一次輕觸螢幕或按下按鈕後，裝置鎖定螢幕前的時間長度。發生這種情況時，使用者必須再次輸入 PIN 碼或密碼，才能使用裝置及存取資料。值必須介於 1 到 60 分鐘之間。
必須加密儲存空間	指定儲存空間應加密 (如果裝置支援)。Android 3.0 推出。
停用攝影機	指定應停用相機。請注意，這不一定是永久停用。系統可根據情境、時間等因素，動態啟用/停用相機。Android 4.0 推出。

其他功能

除了支援上表列出的政策外，Device Administration API 還可讓您執行下列操作：

提示使用者設定新密碼。
立即鎖定裝置。
抹除裝置資料 (也就是將裝置恢復原廠設定)。

範例應用程式

本頁使用的範例是以裝置管理 API 範例為基礎，該範例包含在 SDK 範例中 (可透過 Android SDK Manager 取得)，並位於系統中的 <sdk_root>/ApiDemos/app/src/main/java/com/example/android/apis/app/DeviceAdminSample.java。

範例應用程式提供裝置管理功能的示範。它會向使用者顯示使用者介面，讓他們啟用裝置管理應用程式。啟用應用程式後，他們可以使用使用者介面中的按鈕執行下列操作：

設定密碼強度。
指定使用者密碼的需求條件，例如長度下限、必須包含的數字字元數量下限等。
設定密碼。如果密碼不符合指定政策，系統會傳回錯誤。
設定密碼輸入錯誤幾次後，系統會抹除裝置資料 (即恢復原廠設定)。
設定密碼從現在起多久後到期。
設定密碼記錄長度 (length 是指記錄中儲存的舊密碼數量)。這可防止使用者重複使用最近 n 個密碼。
指定應加密儲存區域 (如果裝置支援)。
設定裝置鎖定前的最長閒置時間。
立即鎖定裝置。
抹除裝置資料 (即恢復原廠設定)。
停用相機。

圖 1. 範例應用程式的螢幕截圖

開發裝置管理應用程式

系統管理員可以使用 Device Administration API 編寫應用程式，強制執行遠端/本機裝置安全性政策。本節將摘要說明建立裝置管理應用程式的步驟。

建立資訊清單

如要使用 Device Administration API，應用程式資訊清單必須包含下列內容：

DeviceAdminReceiver 的子類別，包含下列項目：
- BIND_DEVICE_ADMIN 權限。
- 回應 ACTION_DEVICE_ADMIN_ENABLED 意圖的能力，在資訊清單中表示為意圖篩選器。
中繼資料中使用的安全性政策宣告。

以下是裝置管理範例資訊清單的摘錄：

<activity android:name=".app.DeviceAdminSample"
            android:label="@string/activity_sample_device_admin">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.SAMPLE_CODE" />
    </intent-filter>
</activity>
<receiver android:name=".app.DeviceAdminSample$DeviceAdminSampleReceiver"
        android:label="@string/sample_device_admin"
        android:description="@string/sample_device_admin_description"
        android:permission="android.permission.BIND_DEVICE_ADMIN">
    <meta-data android:name="android.app.device_admin"
            android:resource="@xml/device_admin_sample" />
    <intent-filter>
        <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
    </intent-filter>
</receiver>

請注意：

下列屬性是指範例應用程式中位於 ApiDemos/res/values/strings.xml 的字串資源。如要進一步瞭解資源，請參閱「應用程式資源」。
- android:label="@string/activity_sample_device_admin" 是指使用者可理解的活動標籤。
- android:label="@string/sample_device_admin" 是指使用者可理解的權限標籤。
- android:description="@string/sample_device_admin_description" 是指使用者可理解的權限說明。說明通常比標籤更長，也更詳細。
android:permission="android.permission.BIND_DEVICE_ADMIN" 是 DeviceAdminReceiver 子類別必須具備的權限，可確保只有系統能與接收器互動 (任何應用程式都無法取得這項權限)。這可防止其他應用程式濫用裝置管理應用程式。
android.app.action.DEVICE_ADMIN_ENABLED 是 DeviceAdminReceiver 子類別必須處理的主要動作，才能管理裝置。當使用者啟用裝置管理應用程式時，系統會將此設定為接收器。您的程式碼通常會在 onEnabled() 中處理此作業。如要支援，接收器也必須要求 BIND_DEVICE_ADMIN 權限，以免其他應用程式濫用。
使用者啟用裝置管理應用程式後，接收器就會獲得權限，可執行動作來回應特定系統事件的廣播。當適當事件發生時，應用程式可以強制執行政策。舉例來說，如果使用者嘗試設定不符合政策規定的新密碼，應用程式可以提示使用者選擇符合規定的其他密碼。
發布應用程式後，請避免變更接收器名稱。如果資訊清單中的名稱有所變更，當使用者更新應用程式時，裝置管理員會遭到停用。詳情請參閱 <receiver>。
android:resource="@xml/device_admin_sample" 宣告中繼資料使用的安全性政策。中繼資料會提供裝置管理員專屬的其他資訊，由 DeviceAdminInfo 類別剖析。device_admin_sample.xml 的內容如下：

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

設計裝置管理應用程式時，您不需要納入所有政策，只要納入與應用程式相關的政策即可。

如要進一步瞭解資訊清單檔案，請參閱 Android 開發人員指南。

導入程式碼

Device Administration API 包含下列類別：

DeviceAdminReceiver: 用於實作裝置管理元件的基礎類別。這個類別可讓您輕鬆解讀系統傳送的原始意圖動作。裝置管理應用程式必須包含 DeviceAdminReceiver 子類別。
DevicePolicyManager: 用於管理裝置強制執行政策的類別。這個類別的大多數用戶端都必須發布使用者目前啟用的 DeviceAdminReceiver。DevicePolicyManager 會管理一或多個 DeviceAdminReceiver 執行個體的政策
DeviceAdminInfo: 這個類別用於指定裝置管理員元件的中繼資料。

這些類別為功能完整的裝置管理應用程式奠定基礎。本節其餘部分將說明如何使用 DeviceAdminReceiver 和 DevicePolicyManager API 編寫裝置管理應用程式。

建立 DeviceAdminReceiver 的子類別

如要建立裝置管理應用程式，您必須建立 DeviceAdminReceiver 的子類別。DeviceAdminReceiver 類別包含一系列回呼，會在特定事件發生時觸發。

在 DeviceAdminReceiver 子類別中，範例應用程式只會顯示 Toast 通知，以回應特定事件。例如：

Kotlin

class DeviceAdminSample : DeviceAdminReceiver() {

    private fun showToast(context: Context, msg: String) {
        context.getString(R.string.admin_receiver_status, msg).let { status ->
            Toast.makeText(context, status, Toast.LENGTH_SHORT).show()
        }
    }

    override fun onEnabled(context: Context, intent: Intent) =
            showToast(context, context.getString(R.string.admin_receiver_status_enabled))

    override fun onDisableRequested(context: Context, intent: Intent): CharSequence =
            context.getString(R.string.admin_receiver_status_disable_warning)

    override fun onDisabled(context: Context, intent: Intent) =
            showToast(context, context.getString(R.string.admin_receiver_status_disabled))

    override fun onPasswordChanged(context: Context, intent: Intent, userHandle: UserHandle) =
            showToast(context, context.getString(R.string.admin_receiver_status_pw_changed))
...
}

Java

public class DeviceAdminSample extends DeviceAdminReceiver {

    void showToast(Context context, String msg) {
        String status = context.getString(R.string.admin_receiver_status, msg);
        Toast.makeText(context, status, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onEnabled(Context context, Intent intent) {
        showToast(context, context.getString(R.string.admin_receiver_status_enabled));
    }

    @Override
    public CharSequence onDisableRequested(Context context, Intent intent) {
        return context.getString(R.string.admin_receiver_status_disable_warning);
    }

    @Override
    public void onDisabled(Context context, Intent intent) {
        showToast(context, context.getString(R.string.admin_receiver_status_disabled));
    }

    @Override
    public void onPasswordChanged(Context context, Intent intent, UserHandle userHandle) {
        showToast(context, context.getString(R.string.admin_receiver_status_pw_changed));
    }
...
}

啟用應用程式

裝置管理應用程式必須處理的主要事件之一，就是使用者啟用應用程式。使用者必須明確啟用應用程式，才能強制執行政策。如果使用者選擇不啟用應用程式，應用程式仍會保留在裝置上，但不會強制執行政策，使用者也無法享有應用程式的任何好處。

當使用者執行觸發 ACTION_ADD_DEVICE_ADMIN 意圖的動作時，系統就會開始啟用應用程式。在範例應用程式中，當使用者點選「Enable Admin」核取方塊時，就會發生這種情況。

使用者點選「Enable Admin」核取方塊後，畫面會變更為提示使用者啟用裝置管理應用程式，如圖 2 所示。

圖 2. 範例應用程式：啟用應用程式

以下是使用者點選「Enable Admin」核取方塊時執行的程式碼。這會觸發 onPreferenceChange() 回呼。當使用者變更這個 Preference 的值，且即將設定和/或保留該值時，系統會叫用這個回呼。如果使用者啟用應用程式，畫面會變更，提示使用者啟用裝置管理應用程式，如圖 2 所示。否則，裝置管理應用程式會停用。

Kotlin

override fun onPreferenceChange(preference: Preference, newValue: Any): Boolean {
    if (super.onPreferenceChange(preference, newValue)) return true
    val value = newValue as Boolean
    if (preference == enableCheckbox) {
        if (value != adminActive) {
            if (value) {
                // Launch the activity to have the user enable our admin.
                val intent = Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN).apply {
                    putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN, deviceAdminSample)
                    putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION,
                            activity.getString(R.string.add_admin_extra_app_text))
                }
                startActivityForResult(intent, REQUEST_CODE_ENABLE_ADMIN)
                // return false - don't update checkbox until we're really active
                return false
            } else {
                dpm.removeActiveAdmin(deviceAdminSample)
                enableDeviceCapabilitiesArea(false)
                adminActive = false
            }
        }
    } else if (preference == disableCameraCheckbox) {
        dpm.setCameraDisabled(deviceAdminSample, value)
    }
    return true
}

Java

@Override
public boolean onPreferenceChange(Preference preference, Object newValue) {
    if (super.onPreferenceChange(preference, newValue)) {
        return true;
    }
    boolean value = (Boolean) newValue;
    if (preference == enableCheckbox) {
        if (value != adminActive) {
            if (value) {
                // Launch the activity to have the user enable our admin.
                Intent intent = new Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN);
                intent.putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN, deviceAdminSample);
                intent.putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION,
                        activity.getString(R.string.add_admin_extra_app_text));
                startActivityForResult(intent, REQUEST_CODE_ENABLE_ADMIN);
                // return false - don't update checkbox until we're really active
                return false;
            } else {
                dpm.removeActiveAdmin(deviceAdminSample);
                enableDeviceCapabilitiesArea(false);
                adminActive = false;
            }
        }
    } else if (preference == disableCameraCheckbox) {
        dpm.setCameraDisabled(deviceAdminSample, value);
    }
    return true;
}

intent.putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN, mDeviceAdminSample) 行指出 mDeviceAdminSample (DeviceAdminReceiver 元件) 是目標政策。這行程式碼會叫用圖 2 所示的使用者介面，引導使用者將裝置管理員新增至系統 (或允許他們拒絕)。

當應用程式需要執行某項作業，而該作業必須在裝置管理應用程式啟用時才能執行，應用程式會確認該應用程式是否處於啟用狀態。為此，它會使用 DevicePolicyManager 方法 isAdminActive()。請注意，DevicePolicyManager 方法 isAdminActive() 會採用 DeviceAdminReceiver 元件做為引數：

Kotlin

private lateinit var dpm: DevicePolicyManager
...
private fun isActiveAdmin(): Boolean = dpm.isAdminActive(deviceAdminSample)

Java

DevicePolicyManager dpm;
...
private boolean isActiveAdmin() {
    return dpm.isAdminActive(deviceAdminSample);
}

管理政策

DevicePolicyManager 是公用類別，用於管理在裝置上強制執行的政策。DevicePolicyManager 會管理一或多個 DeviceAdminReceiver 執行個體的政策。

您可以透過下列方式取得 DevicePolicyManager 的控制代碼：

Kotlin

dpm = getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager

Java

DevicePolicyManager dpm =
    (DevicePolicyManager)getSystemService(Context.DEVICE_POLICY_SERVICE);

本節說明如何使用 DevicePolicyManager 執行管理工作：

設定密碼政策
設定裝置鎖定
抹除資料

設定密碼政策

DevicePolicyManager 包含用於設定及強制執行裝置密碼政策的 API。在 Device Administration API 中，密碼僅適用於螢幕鎖定。本節說明常見的密碼相關工作。

設定裝置密碼

這段程式碼會顯示使用者介面，提示使用者設定密碼：

Kotlin

Intent(DevicePolicyManager.ACTION_SET_NEW_PASSWORD).also { intent ->
    startActivity(intent)
}

Java

Intent intent = new Intent(DevicePolicyManager.ACTION_SET_NEW_PASSWORD);
startActivity(intent);

設定密碼強度

密碼品質可以是下列其中一個 DevicePolicyManager 常數：

PASSWORD_QUALITY_ALPHABETIC: 使用者必須輸入至少包含英文字母 (或其他符號) 字元的密碼。
PASSWORD_QUALITY_ALPHANUMERIC: 使用者必須輸入至少同時包含數字和字母 (或其他符號) 字元的密碼。
PASSWORD_QUALITY_NUMERIC: 使用者必須輸入至少包含數字字元的密碼。
PASSWORD_QUALITY_COMPLEX: 使用者必須輸入至少包含一個字母、一個數字和一個特殊符號的密碼。
PASSWORD_QUALITY_SOMETHING: 政策要求設定某種密碼，但對密碼類型沒有要求。
PASSWORD_QUALITY_UNSPECIFIED: 這項政策對密碼沒有任何要求。

舉例來說，您可以按照下列方式設定密碼政策，要求使用者設定英數字元密碼：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
...
dpm.setPasswordQuality(deviceAdminSample, DevicePolicyManager.PASSWORD_QUALITY_ALPHANUMERIC)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
...
dpm.setPasswordQuality(deviceAdminSample, DevicePolicyManager.PASSWORD_QUALITY_ALPHANUMERIC);

設定密碼內容規定

自 Android 3.0 起，DevicePolicyManager 類別包含可讓您微調密碼內容的方法。舉例來說，您可以設定政策，規定密碼必須包含至少 n 個大寫字母。以下是微調密碼內容的方法：

舉例來說，下列程式碼片段規定密碼至少須包含 2 個大寫字母：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val pwMinUppercase = 2
...
dpm.setPasswordMinimumUpperCase(deviceAdminSample, pwMinUppercase)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
int pwMinUppercase = 2;
...
dpm.setPasswordMinimumUpperCase(deviceAdminSample, pwMinUppercase);

設定密碼長度下限

您可以指定密碼長度下限。例如：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val pwLength: Int = ...
...
dpm.setPasswordMinimumLength(deviceAdminSample, pwLength)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
int pwLength;
...
dpm.setPasswordMinimumLength(deviceAdminSample, pwLength);

設定密碼輸入錯誤次數上限

您可以設定裝置抹除資料 (即恢復原廠設定) 前，允許的密碼輸入錯誤次數上限。例如：

Kotlin

val dPM:DevicePolicyManager
private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val maxFailedPw: Int = ...
...
dpm.setMaximumFailedPasswordsForWipe(deviceAdminSample, maxFailedPw)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
int maxFailedPw;
 ...
dpm.setMaximumFailedPasswordsForWipe(deviceAdminSample, maxFailedPw);

設定密碼有效期限

從 Android 3.0 開始，您可以使用 setPasswordExpirationTimeout() 方法設定密碼到期時間，以裝置管理員設定到期逾時時間後的毫秒數表示。例如：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val pwExpiration: Long = ...
...
dpm.setPasswordExpirationTimeout(deviceAdminSample, pwExpiration)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
long pwExpiration;
...
dpm.setPasswordExpirationTimeout(deviceAdminSample, pwExpiration);

根據記錄限制密碼

從 Android 3.0 開始，您可以使用 setPasswordHistoryLength() 方法，限制使用者重複使用舊密碼。這個方法會採用 length 參數，指定要儲存多少組舊密碼。啟用這項政策後，使用者無法輸入與前 n 個密碼相同的新密碼。這可防止使用者重複使用相同密碼。這項政策通常會與 setPasswordExpirationTimeout() 搭配使用，強制使用者在指定時間過後更新密碼。

舉例來說，下列程式碼片段會禁止使用者重複使用最近 5 次設定的密碼：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val pwHistoryLength = 5
...
dpm.setPasswordHistoryLength(deviceAdminSample, pwHistoryLength)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
int pwHistoryLength = 5;
...
dpm.setPasswordHistoryLength(deviceAdminSample, pwHistoryLength);

設定裝置鎖定

您可以設定使用者閒置多久後，裝置會自動鎖定。例如：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
private val timeMs: Long = 1000L * timeout.text.toString().toLong()
...
dpm.setMaximumTimeToLock(deviceAdminSample, timeMs)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
...
long timeMs = 1000L*Long.parseLong(timeout.getText().toString());
dpm.setMaximumTimeToLock(deviceAdminSample, timeMs);

您也可以透過程式輔助方式，指示裝置立即鎖定：

Kotlin

private lateinit var dpm: DevicePolicyManager
dpm.lockNow()

Java

DevicePolicyManager dpm;
dpm.lockNow();

抹除資料

您可以使用 DevicePolicyManager 方法 wipeData() 將裝置恢復原廠設定。如果裝置遺失或遭竊，這項功能就非常實用。通常，抹除裝置的決定是基於特定條件。舉例來說，您可以使用 setMaximumFailedPasswordsForWipe() 聲明裝置應在密碼輸入失敗達特定次數後抹除資料。

抹除資料的方式如下：

Kotlin

private lateinit var dpm: DevicePolicyManager
dpm.wipeData(0)

Java

DevicePolicyManager dpm;
dpm.wipeData(0);

wipeData() 方法會將其他選項的位元遮罩做為參數。目前的值必須為 0。

停用攝影機

從 Android 4.0 開始，您可以停用相機。請注意，您不一定要永久停用。相機可根據情境、時間等動態啟用/停用。

您可以使用 setCameraDisabled() 方法，控制是否停用相機。舉例來說，以下程式碼片段會根據核取方塊設定，啟用或停用攝影機：

Kotlin

private lateinit var disableCameraCheckbox: CheckBoxPreference
private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
...
dpm.setCameraDisabled(deviceAdminSample, mDisableCameraCheckbox.isChecked)

Java

private CheckBoxPreference disableCameraCheckbox;
DevicePolicyManager dpm;
ComponentName deviceAdminSample;
...
dpm.setCameraDisabled(deviceAdminSample, mDisableCameraCheckbox.isChecked());

儲存空間加密

自 Android 3.0 起，您可以使用 setStorageEncryption() 方法設定政策，要求對支援的儲存空間區域進行加密。

例如：

Kotlin

private lateinit var dpm: DevicePolicyManager
private lateinit var deviceAdminSample: ComponentName
...
dpm.setStorageEncryption(deviceAdminSample, true)

Java

DevicePolicyManager dpm;
ComponentName deviceAdminSample;
...
dpm.setStorageEncryption(deviceAdminSample, true);

如需啟用儲存空間加密功能的已完成樣本，請參閱 Device Administration API 範例。

其他程式碼範例

Android AppRestrictionEnforcer 和 DeviceOwner 範例進一步示範了本頁面提及的 API 使用方式。

裝置管理總覽 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

無頭裝置擁有者模式

Device Administration API 總覽

運作方式

政策

其他功能

範例應用程式

開發裝置管理應用程式

建立資訊清單

導入程式碼

建立 DeviceAdminReceiver 的子類別

Kotlin

Java

啟用應用程式

Kotlin

Java

Kotlin

Java

管理政策

Kotlin

Java

設定密碼政策

設定裝置密碼

Kotlin

Java

設定密碼強度

Kotlin

Java

設定密碼內容規定

Kotlin

Java

設定密碼長度下限

Kotlin

Java

設定密碼輸入錯誤次數上限

Kotlin

Java

設定密碼有效期限

Kotlin

Java

根據記錄限制密碼

Kotlin

Java

設定裝置鎖定

Kotlin

Java

Kotlin

Java

抹除資料

Kotlin

Java

停用攝影機

Kotlin

Java

儲存空間加密

Kotlin

Java

其他程式碼範例

裝置管理總覽