Language

ActivityManagerAppTaskWindowingLayer Enum

Definition

public enum ActivityManagerAppTaskWindowingLayer
type ActivityManagerAppTaskWindowingLayer = 
Inheritance
ActivityManagerAppTaskWindowingLayer

Fields

Name Value Description
Undefined 0

The windowing layer is not specified. The system will use a WINDOWING_LAYER_NORMAL_APP layer.

Android reference for android.app.ActivityManager.AppTask.WINDOWING_LAYER_UNDEFINED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

NormalApp 1

The windowing layer for normal application windows.

If an application does not explicitly request a windowing layer for its task, it is considered to be in this layer.

Requesting this layer using AppTask.requestWindowingLayer is typically done to exit a previously requested layer.

Android reference for android.app.ActivityManager.AppTask.WINDOWING_LAYER_NORMAL_APP.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Pinned 2

The windowing layer for pinned windows. These windows are typically displayed above normal application windows.

To ensure system integrity and a consistent user experience, the system imposes several restrictions on tasks using this layer. These may include, but are not limited to: Forcing the task to be completely opaque and display system decorations; Strictly limiting the number of tasks in this layer (e.g., only one at a time); Limiting the application's control over the task's size and position; Limiting the maximum window size to which the user can resize the task; Making the task non-movable programmatically (including restrictions on workarounds like resizing); Providing users with immediate settings access to disable the feature; Providing users with a way to close the window; The task may be finished by the system if it can no longer be hosted on this layer due to windowing changes; The available display modes may be limited for tasks on this layer. These may include, but are not limited to: Picture-in-Picture mode, Split-screen mode, and fullscreen

This layer might be shared with Picture-in-Picture (PiP) tasks; therefore, tasks on this layer might be dismissed when another enters PiP.

The task's window on this layer has the following requirements:; Must be opaque; Must have affordances to close the window and to allow users to disable showing and running tasks on this layer, per app; Must have a minimum size of 220dp according to the established Multi-windows CDD requirements; The task cannot change to another layer unless requested by the app with a call to AppTask.requestWindowingLayer.

Android reference for android.app.ActivityManager.AppTask.WINDOWING_LAYER_PINNED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to