DevicePolicyManager.AddPersistentPreferredActivity Método

[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

Parâmetros

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Chamado por um proprietário de perfil ou proprietário do dispositivo ou titular da permissão android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK. para definir uma atividade padrão que o sistema seleciona para lidar com intenções que correspondem às determinadas IntentFilter em vez de mostrar o mecanismo de desambiguação padrão. Essa atividade continuará sendo o manipulador de intenção padrão mesmo se o conjunto de manipuladores de eventos potenciais para o filtro de intenção for alterado e se as preferências de intenção forem redefinidas.

Observe que o aplicativo de destino ainda deve declarar a atividade no manifesto, a API apenas define a atividade como a padrão para lidar com o filtro de intenção especificado.

O mecanismo de desambiguação padrão assumirá se a atividade não estiver mais instalada (). Quando a atividade é (re)instalada, ela é automaticamente redefinida como manipulador de intenção padrão para o filtro.

Observe que chamar essa API para definir um manipulador de intenção padrão só permite evitar o mecanismo de desambiguação padrão. Intenções implícitas que não disparam esse mecanismo (como invocar o navegador) não podem ser configuradas, pois são controladas por outras configurações.

O administrador do dispositivo de chamada deve ser um proprietário de perfil ou proprietário do dispositivo. Se não estiver, uma exceção de segurança será gerada.

A partir de, depois que Build.VERSION_CODES#UPSIDE_DOWN_CAKEa política de atividade preferencial persistente tiver sido definida, PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) notificará o administrador sobre se a política foi definida com êxito ou não. Esse retorno de chamada conterá: <ul<>li> O identificador DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY<de política li> O pacote de params de política adicional, que contém PolicyUpdateReceiver#EXTRA_INTENT_FILTER o filtro de intenção que a política aplica a <li> O TargetUser que essa política se relaciona com <li>, PolicyUpdateResultque será PolicyUpdateResult#RESULT_POLICY_SET se a política foi definida com êxito ou o motivo pelo qual a política não foi definida (por exemploPolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY) </ul> Se houve uma alteração na política, PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult) notificará o administrador dessa alteração. Esse retorno de chamada conterá os mesmos parâmetros que PolicyUpdateReceiver#onPolicySetResult e conterá o PolicyUpdateResult motivo pelo qual a política foi alterada.

OBSERVAÇÃO: Executa e/S de disco e não deve ser chamado no thread principal.

Java documentação para android.app.admin.DevicePolicyManager.addPersistentPreferredActivity(android.content.ComponentName, android.content.IntentFilter, android.content.ComponentName).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.