语言

ActivityManager.AppTask.RequestWindowingLayer 方法

定义

请求此任务的开窗层。

[Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)]
public virtual void RequestWindowingLayer(int layer, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver callback);
[<Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)>]
abstract member RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

参数

layer
Int32

将 WindowingLayer 任务移动到的项。

executor
IExecutor

用于调用回调的函数 Executor 。

callback
IOutcomeReceiver

用于接收请求结果的回调。

特性

注解

请求此任务的开窗层。 这可用于影响活动窗口相对于其他窗口的 Z 排序。

如果可能,任务将移动到请求的层。 当请求获得批准或拒绝时,将调用回调。 如果被拒绝,回调将收到一条异常,其中包含可通过 Exception.getMessage(访问的描述性消息)。

如果由于系统状态而拒绝请求,则回调将收到AppTask.WINDOWING_LAYER_REQUEST_REJECTED。 如果授予请求,回调将收到AppTask.WINDOWING_LAYER_REQUEST_GRANTED。

为了确保系统完整性和一致的用户体验,系统可能会对请求特定层的任务施加限制。 有关请求固定层时的影响,请参阅AppTask.WINDOWING_LAYER_PINNED。

如果请求AppTask.WINDOWING_LAYER_PINNED,则必须允许AppOpsManager.OPSTR_PICTURE_IN_PICTURE,并且必须授予Manifest.permission.USE_PINNED_WINDOWING_LAYER权限。

如果请求因开发人员错误(如缺少权限或无效参数)而失败,则使用描述错误的异常调用 OutcomeReceiver.onError。

Android 参考。android.app.ActivityManager.AppTask.requestWindowingLayer

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于