DevicePolicyManager.AddPersistentPreferredActivity Méthode

[Android.Runtime.Register("addPersistentPreferredActivity", "(Landroid/content/ComponentName;Landroid/content/IntentFilter;Landroid/content/ComponentName;)V", "GetAddPersistentPreferredActivity_Landroid_content_ComponentName_Landroid_content_IntentFilter_Landroid_content_ComponentName_Handler")]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")]
public virtual void AddPersistentPreferredActivity(Android.Content.ComponentName? admin, Android.Content.IntentFilter? filter, Android.Content.ComponentName activity);

[<Android.Runtime.Register("addPersistentPreferredActivity", "(Landroid/content/ComponentName;Landroid/content/IntentFilter;Landroid/content/ComponentName;)V", "GetAddPersistentPreferredActivity_Landroid_content_ComponentName_Landroid_content_IntentFilter_Landroid_content_ComponentName_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK_TASK")>]
abstract member AddPersistentPreferredActivity : Android.Content.ComponentName * Android.Content.IntentFilter * Android.Content.ComponentName -> unit
override this.AddPersistentPreferredActivity : Android.Content.ComponentName * Android.Content.IntentFilter * Android.Content.ComponentName -> unit

Paramètres

Attributs

RegisterAttribute RequiresPermissionAttribute

Remarques

Appelé par un propriétaire de profil ou propriétaire de l’appareil ou titulaire de l’autorisation android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK. pour définir une activité par défaut que le système sélectionne pour gérer les intentions qui correspondent à l’élément donné IntentFilter au lieu d’afficher le mécanisme d’ambiguïté par défaut. Cette activité reste le gestionnaire d’intentions par défaut, même si l’ensemble de gestionnaires d’événements potentiels pour le filtre d’intention change et si les préférences d’intention sont réinitialisées.

Notez que l’application cible doit toujours déclarer l’activité dans le manifeste, l’API définit simplement l’activité comme étant la valeur par défaut pour gérer le filtre d’intention donné.

Le mécanisme d’ambiguïté par défaut prend le relais si l’activité n’est plus installée (plus). Lorsque l’activité est (re)installée, elle est automatiquement réinitialisée en tant que gestionnaire d’intentions par défaut pour le filtre.

Notez que l’appel de cette API pour définir un gestionnaire d’intentions par défaut permet uniquement d’éviter le mécanisme d’ambiguïté par défaut. Les intentions implicites qui ne déclenchent pas ce mécanisme (comme l’appel du navigateur) ne peuvent pas être configurées, car elles sont contrôlées par d’autres configurations.

L’administrateur de l’appareil appelant doit être propriétaire de profil ou propriétaire de l’appareil. Si ce n’est pas le cas, une exception de sécurité est levée.

À partir de Build.VERSION_CODES#UPSIDE_DOWN_CAKE, une fois la stratégie d’activité préférée persistante définie, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) informera l’administrateur si la stratégie a été correctement définie ou non. Ce rappel contient : ul>li L’identificateur<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY de stratégie li> L’offre groupée params de stratégie supplémentaire, qui contient PolicyUpdateReceiver#EXTRA_INTENT_FILTER le filtre d’intention que la stratégie s’applique à <li> La TargetUser stratégie est liée à <li>, PolicyUpdateResultce qui sera PolicyUpdateResult#RESULT_POLICY_SET si la stratégie a été correctement définie ou la raison pour laquelle la stratégie n’a pas pu être définie (par exemplePolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY) </ul> Si une modification a été apportée à la stratégie,><<PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) informera l’administrateur de cette modification. Ce rappel contient les mêmes paramètres que PolicyUpdateReceiver#onPolicySetResult et la PolicyUpdateResult raison pour laquelle la stratégie a changé.

REMARQUE : exécute les E/S de disque et ne doit pas être appelée sur le thread principal.

Java documentation pour android.app.admin.DevicePolicyManager.addPersistentPreferredActivity(android.content.ComponentName, android.content.IntentFilter, android.content.ComponentName).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.