uni-app怎么做App内的全局浮动球 uni-app悬浮窗权限与布局方案【实战】-uni-app-PHP中文网

Android端需用原生插件实现全局浮动球，因uni-app不支持SYSTEM_ALERT_WINDOW权限申请及WindowManager操作；iOS仅支持页面内fixed悬浮元素。

uni-app怎么做app内的全局浮动球 uni-app悬浮窗权限与布局方案【实战】

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 已声明：

如果插件返回 res.code !== 0，优先检查 floatWindow.initIcon() 是否在 onLaunch 后调用，且传入的 xRatio/yRatio 值在 0–1 范围内（超出会导致坐标计算异常，球体“消失”）。

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

悬浮球点击穿透或拖动卡顿怎么办

核心是窗口标志位和事件分发没配对。即使权限通过、视图渲染成功，也会出现点不动、背景页一起响应等问题。

关键参数必须设置：

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 退到后台后悬浮球是否持续存活、点击能否拉起前台 —— 这涉及保活策略和厂商白名单，不同机型行为差异极大，不能只测一台真机就认为“通了”。