实战鸿蒙：如何实现应用悬浮窗

吐槽安卓

不知道你有没有在安卓上做过悬浮窗的需求，开发体验那个是一言难尽。

如果你要做的是系统级别的悬浮窗，就需要判断是否具备悬浮窗权限。然而这又不是一个标准的动态权限，你需要兼容各种奇葩机型的悬浮窗权限判断，下面的代码来自于某著名开源库：EasyFloat[1] 。

fun checkPermission(context: Context): Boolean =
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) when {
    RomUtils.checkIsHuaweiRom() -> huaweiPermissionCheck(context)
    RomUtils.checkIsMiuiRom() -> miuiPermissionCheck(context)
    RomUtils.checkIsOppoRom() -> oppoROMPermissionCheck(context)
    RomUtils.checkIsMeizuRom() -> meizuPermissionCheck(context)
    RomUtils.checkIs360Rom() -> qikuPermissionCheck(context)
            else -> true
} else commonROMPermissionCheck(context)
 
private fun commonROMPermissionCheck(context: Context): Boolean =
        if (RomUtils.checkIsMeizuRom()) meizuPermissionCheck(context) else {
            var result = true
            if (Build.VERSION.SDK_INT >= 23) try {
                val clazz = Settings::class.java
                val canDrawOverlays = clazz.getDeclaredMethod("canDrawOverlays", Context::class.java)
                result = canDrawOverlays.invoke(null, context) as Boolean
            } catch (e: Exception) {
                Log.e(TAG, Log.getStackTraceString(e))
            }
            result
        }

如果你要做的是应用内的全局悬浮窗，那么对不起，不支持，自己想办法。普遍的做法是在根布局 DecorView 直接塞进去。

遥遥领先

在鸿蒙上实现悬浮窗相对就要简单的多。

对于系统级别弹窗，仍然需要权限，但也不至于那么麻烦的适配。

对于应用内全局弹出，鸿蒙提供了 应用子窗口 可以直接实现。

本文主要介绍如何利用应用子窗口实现应用内全局悬浮窗。

创建应用子窗口需要先拿到窗口管理器 WindowStage 对象，在 EntryAbility.onWindowStageCreate() 回调中取。

FloatManager.init(windowStage)
 
init(windowStage: window.WindowStage) {
  this.windowStage_ = windowStage
}

然后通过 WindowStage.createSubWindow() 创建子窗口。

// 创建子窗口
showSubWindow() {
    if (this.windowStage_ == null) {
        Log.error(TAG, 'Failed to create the subwindow. Cause: windowStage_ is null');
    } else {
        this.windowStage_.createSubWindow("HarmonyWorld", (err: BusinessError, data) => {
            ...
            this.sub_windowClass = data;
            // 子窗口创建成功后，设置子窗口的位置、大小及相关属性等
            // moveWindowTo 和 resize 都可以重复调用，实现拖拽效果
            this.sub_windowClass.moveWindowTo(this.locationX, this.locationY, (err: BusinessError) => {
                ...
            });
            this.sub_windowClass.resize(this.size, this.size, (err: BusinessError) => {
                ...
            });
            // 给子窗口设置内容
            this.sub_windowClass.setUIContent("pages/float/FloatPage", (err: BusinessError) => {
                ...
                // 显示子窗口。
                (this.sub_windowClass as window.Window).showWindow((err: BusinessError) => {
                    ...
                    // 设置透明背景
                    data.setWindowBackgroundColor("#00000000")
                });
            });
        })
    }
}

这样就可以在指定位置显示指定大小的的悬浮窗了。

然后再接着完善手势拖动和点击事件。

既要监听拖动，又要监听手势，就需要通过 GestoreGroup，并把设置模式设置为 互斥识别。

@Entry
@Component
export struct FloatPage {
  private context = getContext(this) as common.UIAbilityContext
 
  build() {
    Column() {
      Image($r('app.media.mobile_dev'))
        .width('100%')
        .height('100%')
    }
    .gesture(
      GestureGroup(GestureMode.Exclusive,
        // 监听拖动
        PanGesture()
          .onActionUpdate((event: GestureEvent | undefined) => {
            if (event) {
              // 更新悬浮窗位置
              FloatManager.updateLocation(event.offsetX, event.offsetY)
            }
          }),
        // 监听点击
        TapGesture({ count: 1 })
          .onAction(() => {
             router.pushUrl(...)
          }))
    )
  }
}

在拖动手势 PanGesture 的 onActionUpdate() 回调中，可以实时拿到拖动的距离，然后通过 Window.moveWindowTo() 就可以实时更新悬浮窗的位置了。

updateLocation(offSetX: number, offsetY: number) {
    if (this.sub_windowClass != null) {
        this.locationX = this.locationX + offSetX
        this.locationY = this.locationY + offsetY
        this.sub_windowClass.moveWindowTo(this.locationX, this.locationY, (err: BusinessError) => {
            ......
        });
    }
}

在点击手势 TapGesture中，我的需求是路由到指定页面，直接调用 router.pushUrl()。看似很正常的调用，在这里确得到了意想不到的结果。

发生页面跳转的并不是预期中的应用主窗口，而是应用子窗口。

把问题抛到群里之后，得到了群友的热心解答。

每个 Window 对应自己的 UIContext，UIContext 持有自己的 Router ，所以应用主窗口和应用子窗口的 Router 是相互独立的。

那么，问题就变成了如何在子窗口中让主窗口进行路由跳转？通过 EventHub 或者 emitter 都可以。emiiter 可以跨线程，这里并不需要，EventHub 写起来更简单。我们在点击手势中发送事件：

TapGesture({ count: 1 })
  .onAction(() => {
      this.context.eventHub.emit("event_click_float")
  })

在 EntryAbility 中订阅事件：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    eventHub.on("event_click_float", () => {
      if (this.mainRouter) {
        this.mainRouter.pushUrl(...)
      }
    })
}

这里的 mainRouter 我们可以提前在主 Window 调用 loadContent() 之后获取：

windowStage.loadContent(pages/Index', (err, data) => {
  this.mainRouter = this.windowClass!.getUIContext().getRouter()
});

最后还有一个小细节，如果在拖动悬浮窗之后，再使用系统的返回手势，按照预期应该是主窗口的页面返回，但这时候焦点在子窗口，主窗口并不会响应返回手势。

我们需要在子窗口承载的 Page 页面监听 onBackPress()，并通过 EventHub 通知主窗口。

  onBackPress(): boolean | void {
    this.context.eventHub.emit("float_back")
  }

主窗口接收到通知后，调用 mainRouter.back 。

eventHub.on("clickFloat", () => {
  if (this.mainRouter) {
    this.mainRouter.back()
  }
})

应用内全局，可拖拽的悬浮窗就完成了。

代码在这里：FloatManager[2]

最后

从一位老安卓开发的视角，经历了 Google 对 Android 这么多年的缝缝补补，而鸿蒙作为一款去年才开始真正发力的操作系统，除了给用户带来良好的使用体验以外，给开发者带来良好的开发体验也是至关重要的。

希望鸿蒙可以给开发者带来更多便利的系统特性。

---

公众号历史文章无法修改，我会把鸿蒙系列文章整理到语雀知识库 https://www.yuque.com/mobiledeveloper/harmonyos ，欢迎收藏

参考资料

[1]

EasyFloat: https://github.com/princekin-f/EasyFloat/

[2]

FloatManager: https://github.com/lulululbj/HarmonyWorld/

转自：实战鸿蒙：如何实现应用悬浮窗