Android APIs
public abstract class

RestrictionsReceiver

extends BroadcastReceiver
java.lang.Object
   ↳ android.content.BroadcastReceiver
     ↳ android.service.restrictions.RestrictionsReceiver

Class Overview

Abstract implementation of a Restrictions Provider BroadcastReceiver. To implement a Restrictions Provider, extend from this class and implement the abstract methods. Export this receiver in the manifest. A profile owner device admin can then register this component as a Restrictions Provider using setRestrictionsProvider(ComponentName, ComponentName).

The function of a Restrictions Provider is to transport permission requests from apps on this device to an administrator (most likely on a remote device or computer) and deliver back responses. The response should be sent back to the app via notifyPermissionResponse(String, PersistableBundle).

Summary

Public Constructors
RestrictionsReceiver()
Public Methods
void onReceive(Context context, Intent intent)
Intercept standard Restrictions Provider broadcasts.
abstract void onRequestPermission(Context context, String packageName, String requestType, String requestId, PersistableBundle request)
An asynchronous permission request made by an application for an operation that requires authorization by a local or remote administrator other than the user.
[Expand]
Inherited Methods
From class android.content.BroadcastReceiver
From class java.lang.Object

Public Constructors

public RestrictionsReceiver ()

Added in API level 21

Public Methods

public void onReceive (Context context, Intent intent)

Added in API level 21

Intercept standard Restrictions Provider broadcasts. Implementations should not override this method; it is better to implement the convenience callbacks for each action.

Parameters
context The Context in which the receiver is running.
intent The Intent being received.

public abstract void onRequestPermission (Context context, String packageName, String requestType, String requestId, PersistableBundle request)

Added in API level 21

An asynchronous permission request made by an application for an operation that requires authorization by a local or remote administrator other than the user. The Restrictions Provider should transfer the request to the administrator and deliver back a response, when available. The calling application is aware that the response could take an indefinite amount of time.

If the request bundle contains the key REQUEST_KEY_NEW_REQUEST, then a new request must be sent. Otherwise the provider can look up any previous response to the same requestId and return the cached response.

Parameters
packageName the application requesting permission.
requestType the type of request, which determines the content and presentation of the request data.
request the request data bundle containing at a minimum a request id.