悬浮窗层级详解：权限适配与适配限制指南

2023-11-14 15:21:01

悬浮窗，作为一种在其他应用程序之上叠加显示的 UI 元素，在移动应用开发中得到了广泛应用。然而，在 Android 系统中，悬浮窗的层级管理却是一门需要仔细考量的技术。不同的层级设置会导致不同的权限要求和显示效果，因此开发者需要对悬浮窗层级有深入的了解，才能合理适配不同场景的需求。

Android 系统中的悬浮窗层级由 WindowManager.LayoutParams 中的 type 属性决定。type 属性取值范围如下：

TYPE_PHONE (2002) ：置于所有其他应用程序和系统窗口之上，需要 SYSTEM_ALERT_WINDOW 权限。
TYPE_SYSTEM_ALERT (2003) ：置于所有其他应用程序窗口之上，但低于系统窗口，需要 SYSTEM_ALERT_WINDOW 权限。
TYPE_SYSTEM_OVERLAY (2004) ：置于所有其他应用程序和系统窗口之下，无需权限。
TYPE_APPLICATION (2005) ：置于本应用程序的所有其他窗口之上，无需权限。
TYPE_APPLICATION_SUB_PANEL (2006) ：置于本应用程序的其他子窗口之上，无需权限。
TYPE_APPLICATION_ATTACHED_DIALOG (2007) ：置于本应用程序的其他 Dialog 窗口之上，无需权限。
TYPE_APPLICATION_MEDIA (2008) ：置于本应用程序的所有其他媒体窗口之上，无需权限。
TYPE_APPLICATION_MEDIA_OVERLAY (2009) ：置于本应用程序的所有其他媒体窗口之上，但低于其他应用程序窗口，无需权限。

不同的层级设置需要不同的权限，具体对应关系如下：

TYPE_PHONE、TYPE_SYSTEM_ALERT ：需要 SYSTEM_ALERT_WINDOW 权限。
TYPE_SYSTEM_OVERLAY ：无需权限。
TYPE_APPLICATION、TYPE_APPLICATION_SUB_PANEL、TYPE_APPLICATION_ATTACHED_DIALOG、TYPE_APPLICATION_MEDIA、TYPE_APPLICATION_MEDIA_OVERLAY ：无需权限。

注意： 从 Android 6.0（API 23）开始，SYSTEM_ALERT_WINDOW 权限需要在清单文件中显式声明。

在实际使用中，悬浮窗层级的设置还受到以下限制：

为了合理适配悬浮窗层级，开发者需要考虑以下原则：

根据功能需求选择合适层级 ：需要显示在其他应用之上的悬浮窗，可以使用 TYPE_SYSTEM_ALERT 或 TYPE_PHONE 层级；不需要覆盖其他应用的悬浮窗，可以使用 TYPE_SYSTEM_OVERLAY 层级。
合理处理权限 ：需要 SYSTEM_ALERT_WINDOW 权限的悬浮窗，需要在清单文件中显式声明该权限。
避免层级嵌套 ：悬浮窗层级不能嵌套，因此需要根据实际情况选择最合适的层级。
考虑系统行为影响 ：某些层级可能会受到系统行为的影响，开发者需要提前了解并采取相应措施。
测试不同设备 ：不同的设备可能对悬浮窗层级有限制，开发者需要在不同设备上进行测试以确保兼容性。