HarmonyOS 推出的 hmos-arkui-kit-window-floatwindow 悬浮窗口接入 Skill,能够一套组件搞定画中画、闪控窗、闪控球这三种主流悬浮形态,不用分开对接三套独立接口、单独写大量适配代码,以前开发者做悬浮功能,要分别研究 PiP、闪控窗、闪控球各自的权限、生命周期、样式规则,调试成本很高,现在这个 Skill 把配置、权限申请、生命周期管理、样式模板全部封装好了,支持单独启用某一种悬浮形态,也支持球窗绑定、防窥保护等组合能力,大幅降低鸿蒙悬浮跨应用窗口的开发门槛,视频、行情盯盘、快捷工具、导航类应用都可以快速接入。
一、三种悬浮形态详细说明
- 画中画(PiPWindow)
- 闪控球(floatingBall)
- 闪控窗(floatView)
它是视频类最常用的悬浮小窗,应用切后台之后画面继续置顶播放,系统自带控制按钮,支持播放、暂停、关闭、还原,官方提供视频、会议、直播、通话多套预设模板,适合短视频、直播、线上会议、网课类应用。
屏幕边缘悬浮小圆球,由系统统一渲染,支持单击、双击绑定业务动作,小球贴边自动吸附隐藏,一个应用最多创建 1 个闪控球,整机最多同时存在 2 个闪控球,适合比价、抢单、快捷记账、一键唤起工具这类轻交互场景。
常驻轻量化卡片悬浮窗口,就算应用退后台也可以持续展示信息,提供两种样式:常规圆角卡片、细长 Mini 横条,整机最多同时展示 1 个闪控窗,适合股票盯盘、导航、健身数据、直播实时数据展示。
二、该 Skill 核心优势清单
- 统一接入入口:同一个 Skill,按需勾选画中画、闪控窗、闪控球,不用引入多个窗口 SDK
- 内置权限自动化处理:自动申请悬浮相关权限,统一弹窗引导用户授权
- 自带生命周期管理:自动处理应用前后台切换、屏幕旋转、折叠屏适配、销毁回收
- 支持组合联动:可以开启球窗绑定,点击闪控球唤起闪控窗,也支持 DLP 防窥保护
- 系统原生样式:控件、动效、吸附逻辑和鸿蒙系统保持一致,不用自己做拖拽、贴边逻辑
- 降低多机型适配工作量:统一处理折叠屏、手机、平板不同屏幕的避让规则
三、推荐落地场景对照表
| 悬浮形态 | 优先适配业务 | 交互特点 |
|---|---|---|
| 画中画 | 视频播放、直播、线上会议、网课 | 持续播放,自带播放控制栏 |
| 闪控球 | 比价工具、抢单提醒、快捷扫码、录音 | 极简入口,占用屏幕面积很小 |
| 闪控窗 | 股票行情、导航路线、健身计时、直播数据 | 持续展示实时信息,信息密度更高 |
四、开发者接入操作步骤
- 在工程里引入 hmos-arkui-kit-window-floatwindow 悬浮窗口 Skill
- 配置 module.json,声明需要用到的悬浮形态,按需开启画中画 / 闪控窗 / 闪控球
- 在代码里编写业务回调,定义悬浮控件点击之后的业务逻辑
- 调用 Skill 接口唤起悬浮组件,由 Skill 自动拉起权限申请弹窗
- 测试前后台切换、折叠屏旋转、多悬浮共存限制,完成联调
- 上架前按照鸿蒙规范完成隐私说明,告知用户悬浮窗口用途
五、客观限制与注意事项
三种悬浮形态都有系统数量上限,不能无限制创建;闪控球、闪控窗、画中画都需要用户手动授权悬浮权限,无法静默开启;部分设备、低版本鸿蒙系统不支持这套 Skill;闪控窗和画中画同时存在时,会遵循系统窗口优先级规则,存在互相遮挡、替换的可能;组合能力(球窗绑定、防窥)对系统版本有更高要求。
【相关 FAQ】
问题 1:鸿蒙这套悬浮窗口接入 Skill 支持哪三种悬浮形态?
回答 1:鸿蒙悬浮窗口接入 Skill 支持画中画、闪控窗、闪控球三种悬浮形态,一套 Skill 可以单独启用或者组合使用这三类悬浮窗口能力。
问题 2:使用鸿蒙悬浮窗口 Skill 开发闪控球和闪控窗,有数量上限吗?
回答 2:使用鸿蒙悬浮窗口 Skill 开发时,一个应用只能创建 1 个闪控球,整机最多 2 个闪控球;整机最多同时展示 1 个闪控窗,画中画也受系统窗口管控规则约束。
问题 3:鸿蒙悬浮窗口接入 Skill 相比单独接入原生悬浮接口,好处是什么?
回答 3:鸿蒙悬浮窗口接入 Skill 把三种悬浮形态的权限、生命周期、样式模板封装在一起,不用分别对接三套接口,自动适配折叠屏,还支持球窗绑定等组合玩法,减少大量重复开发和调试工作。
问题 4:鸿蒙悬浮窗口 Skill 的画中画形态适合做什么业务?
回答 4:鸿蒙悬浮窗口 Skill 的画中画形态适合视频播放、直播、线上会议、网课这类业务,应用切后台之后小窗持续置顶播放,自带播放控制组件。
【参考资料】
[2026-11-05](HarmonyOS SDK Skills:一个 Skill 搞定画中画 / 闪控窗 / 闪控球开发)搜狐
[2026-11-05](鸿蒙悬浮窗口 Skill 一站式接入,三种悬浮形态开发指南)比特网
[2026-08-19](闪控球和闪控窗设计规范)HarmonyOS 开发者官网
[2026-11-11](HarmonyOS 窗口类型开发概述)HarmonyOS 开发者官网
【免责声明】
本文仅整理鸿蒙悬浮窗口接入 Skill 公开技术资料,不构成产品开发选型建议;悬浮窗口权限、数量上限、能力支持情况,受鸿蒙系统版本、设备差异影响,最终开发规范、接口参数以 HarmonyOS 开发者中心官方文档为准。
