DevicePolicyManager.AddPersistentPreferredActivity 方法

[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

参数

属性

RegisterAttribute RequiresPermissionAttribute

注解

由配置文件所有者、设备所有者或权限 android.Manifest.permission#MANAGE_DEVICE_POLICY_LOCK_TASK持有者调用。 设置系统选择的默认活动以处理与给定 IntentFilter 匹配的意向，而不是显示默认消除歧义机制。 即使意向筛选器的潜在事件处理程序集和意向首选项重置，此活动也会保留默认意向处理程序。

请注意，目标应用程序仍应声明清单中的活动，API 仅将活动设置为默认活动来处理给定的意向筛选器。

如果未安装活动（不再安装），则默认消除歧义机制将接管。 安装活动时，它会自动重置为筛选器的默认意向处理程序。

请注意，调用此 API 以设置默认意向处理程序，只允许避免默认消除歧义机制。 无法配置不触发此机制（例如调用浏览器）的隐式意向，因为它们由其他配置控制。

呼叫设备管理员必须是配置文件所有者或设备所有者。 如果不是，将引发安全异常。

从 Build.VERSION_CODES#UPSIDE_DOWN_CAKE设置持久性首选活动策略后开始， PolicyUpdateReceiver#onPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult) 将通知管理员该策略是否已成功设置。 此回调将包含：ul>li 策略标识符<DevicePolicyIdentifiers#PERSISTENT_PREFERRED_ACTIVITY_POLICY li> 其他策略参数捆绑包，其中包含PolicyUpdateReceiver#EXTRA_INTENT_FILTER策略应用于 <li 的策略适用的意向筛选器：此策略与 li TargetUser>>PolicyUpdateResult相关<，即PolicyUpdateResult#RESULT_POLICY_SET如果策略已成功设置或策略未能设置的原因（例如） /ul>（如果PolicyUpdateResult#RESULT_FAILURE_CONFLICTING_ADMIN_POLICY策略已发生更改）， <><<PolicyUpdateReceiver#onPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult)将通知管理员此更改。 此回调将包含与 PolicyUpdateReceiver#onPolicySetResult 相同的参数， PolicyUpdateResult 并且将包含策略更改的原因。

注意：执行磁盘 I/O，不应在主线程上调用。

Java文档android.app.admin.DevicePolicyManager.addPersistentPreferredActivity(android.content.ComponentName, android.content.IntentFilter, android.content.ComponentName)。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。