Android端需用原生插件实现全局浮动球，因uni-app不支持SYSTEM_ALERT_WINDOW权限申请及WindowManager操作；iOS仅支持页面内fixed悬浮元素。
Android 端必须用原生插件实现全局浮动球，uni-app 本身不提供 SYSTEM_ALERT_WINDOW 权限申请能力，也不能直接操作 WindowManager；iOS 完全不支持跨应用悬浮窗，只能做页面内 position: fixed 元素。
怎么检测并跳转到 Android 悬浮窗设置页
Android 11（API 30）起，Settings.ACTION_MANAGE_OVERLAY_PERMISSION 不能靠 Intent 直接唤起，必须先调用 Settings.canDrawOverlays() 判断状态。uni-app 的 uni.openSetting() 对这个权限完全无效，它只处理 WRITE_EXTERNAL_STORAGE 这类普通权限。
正确做法是封装原生插件，在插件里写 Java 判断逻辑：
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !Settings.canDrawOverlays(context)) {
Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);
intent.setData(Uri.parse("package:" + context.getPackageName()));
activity.startActivityForResult(intent, 1001);
}
插件导出的 JS 方法建议命名为 checkPermission() 和 requestPermission()，不要在 H5 页面里自己拼 Intent —— plus.android.importClass('android.provider.Settings') 在部分厂商系统（如小米、OPPO）上会因反射限制失败。
为什么 Ba-FloatWindow 插件初始化后悬浮球不显示
常见原因不是代码没跑，而是以下几点被忽略：
-
desktopShow:true必须显式设置，否则默认只在 App 前台显示 - 图标路径要放在
nativeplugins/Ba-FloatWindow/android/res/drawable-xxhdpi/下，且iconPath参数值不带扩展名（例如填"music_icon"，对应文件是music_icon.png） - 每次改图标或插件配置后，必须重新制作自定义调试基座，热更新不生效
- 真机测试前确认 manifest.json 已声明：
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"></uses-permission>
如果插件返回 res.code !== 0，优先检查 floatWindow.initIcon() 是否在 onLaunch 后调用，且传入的 xRatio/yRatio 值在 0–1 范围内（超出会导致坐标计算异常，球体“消失”）。
悬浮球点击穿透或拖动卡顿怎么办
核心是窗口标志位和事件分发没配对。即使权限通过、视图渲染成功，也会出现点不动、背景页一起响应等问题。
关键参数必须设置：
-
type要设为TYPE_APPLICATION_OVERLAY（Android 8.0+），不能用已废弃的TYPE_PHONE -
flags至少包含FLAG_NOT_FOCUSABLE+FLAG_LAYOUT_NO_LIMITS+FLAG_WATCH_OUTSIDE_TOUCH，缺一不可 - 触摸事件透传依赖
FLAG_NOT_TOUCH_MODAL，否则会拦截底层所有 touch
Ba-FloatWindow 默认已处理这些，但如果你自研插件，别漏掉 wmParams.flags |= WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL；另外，拖动卡顿常因未启用硬件加速，插件内部需对 SurfaceView 或 TextureView 调用 setLayerType(LAYER_TYPE_HARDWARE, null)。
真正麻烦的不是首次弹出，而是 App 退到后台后悬浮球是否持续存活、点击能否拉起前台 —— 这涉及保活策略和厂商白名单，不同机型行为差异极大，不能只测一台真机就认为“通了”。
