RestrictionsManager 類別

定義

[Android.Runtime.Register("android/content/RestrictionsManager", DoNotGenerateAcw=true)]
public class RestrictionsManager : Java.Lang.Object

[<Android.Runtime.Register("android/content/RestrictionsManager", DoNotGenerateAcw=true)>]
type RestrictionsManager = class
    inherit Object

繼承

Object

JavaObject

Object

RestrictionsManager

屬性

RegisterAttribute

備註

提供一種機制，讓應用程式查詢管理使用者實體所施加的限制。 應用程式也可以向本地或遠端裝置管理員發送權限請求，以覆蓋預設的應用程式專屬限制或其他需要管理員明確授權的操作。

應用程式可以透過清單中指定的 XML 檔案揭露一組限制。

如果使用者有啟用的限制提供者，除了靜態限制外，還可以提出動態請求。 動態請求是應用程式專屬的，可以透過預先定義的請求類型來表達。

限制管理器會將動態請求轉發給活躍的限制提供者。 限制提供者可透過呼叫 #notifyPermissionResponse(String, PersistableBundle)回應回應，當收到裝置或使用者管理員的回應時。 回應會透過受保護的廣播 #ACTION_PERMISSION_RESPONSE_RECEIVED回傳給應用程式。

靜態限制由 XML 檔案指定，XML檔案由清單中的元資料屬性參考。 這讓應用程式以及任何網頁管理主控台都能讀取 apk 中可用的限制清單。

XML 格式的語法如下：

<?xml version="1.0" encoding="utf-8"?>
            <restrictions xmlns:android="http://schemas.android.com/apk/res/android" >
                <restriction
                    android:key="string"
                    android:title="string resource"
                    android:restrictionType=["bool" | "string" | "integer"
                                                    | "choice" | "multi-select" | "hidden"
                                                    | "bundle" | "bundle_array"]
                    android:description="string resource"
                    android:entries="string-array resource"
                    android:entryValues="string-array resource"
                    android:defaultValue="reference" >
                        <restriction ... />
                        ...
                </restriction>
                <restriction ... />
                ...
            </restrictions>

每個限制的屬性取決於限制類型。

<UL><LI>key，title且restrictionType是強制的。</li><li>entries 和 entryValues 若是 restrictionType 或 choicemulti-select則是必填。</li><li>defaultValue 是可選的，其類型取決於 restrictionType</li><>hidden li 類型必須有 adefaultValue，且不會顯示給管理員。 它可以用來傳遞無法修改的資料，例如版本碼。</li><li>description 是用來更詳細描述限制，指的是管理數值的管理者，如果標題本身還不夠。</li></ul>

只有類型 和 bundle 的bundle_array限制可以包含一個或多個巢狀限制元素。

在你的清單 application 區塊中，新增 meta-data 標籤，指向如下所示的限制 XML 檔案：

<application ... >
                <meta-data android:name="android.content.APP_RESTRICTIONS"
                              android:resource="@xml/app_restrictions" />
                ...
            </application>

Java 文件 android.content.RestrictionsManager。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。