HarmonyOS 7 闪控窗实战:先理清“系统规则”,再写代码
约束不是“注意事项”,是启动前必须通过的检查项
官方文档的“约束与限制”部分值得逐条读。以下几条如果没处理好,start() 会直接抛错:
-
前台启动门禁:只允许应用在前台时启动闪控窗,且需持有
ohos.permission.FLOAT_VIEW权限。后台调用start()会抛1300033。 -
单实例:同一个应用只能有一个闪控窗。重复
start()已在运行的窗口返回1300030,启动第二个返回1300033。 -
互斥:已经启动了闪控球或画中画窗口时,无法启动闪控窗,需先停止(
1300034)。 -
绑定的时机:
floatView.bind()必须在两个控制器均未启动时调用。绑定后,启动任一控制器会同时创建两个窗口,但同一时刻只展示其中一个;停止任一控制器会同时销毁两个窗口。
最后一条尤其容易被误解。很多人以为“绑定”是运行时的动态行为,实际上它是一个启动前的结构决策:你先决定这个应用要同时具备闪控窗和闪控球能力,把控制器绑好,然后再启动。绑定之后,最小化按钮的行为也会改变——未绑定时缩到侧边栏,绑定后缩成闪控球。
最小工程路径
新建 Empty Ability(ArkTS、Stage 模型),compileSdkVersion 选 26.0.0 以上。权限声明需要两个运行时权限:ohos.permission.FLOAT_VIEW(闪控窗启动)和 ohos.permission.USE_FLOAT_BALL(闪控球启动/绑定),均为 user_grant 级别。
工程结构上,建议把闪控窗的内容 UI 和控制器逻辑分开:控制器负责生命周期、权限检查、绑定/解绑;内容 UI 用独立的 @Builder 或组件承载,方便在闪控窗和闪控球两种形态之间复用或切换。闪控球本身没有复杂内容,但它作为“入口”承担的是跨应用的快捷唤起,所以业务侧需要明确:用户点击闪控球展开后,第一眼看到的是什么,决定了这个悬浮能力有没有实际价值。
踩坑小结
闪控窗的难点不在 UI,而在生命周期约束和绑定状态机。把 1300033、1300030、1300034 这几个错误码对应的前置条件写进你的启动流程检查清单,比事后调试节省大量时间。另外,模拟器和预览器不支持系统托管窗口,必须真机调试——这一点在项目排期时就要纳入考虑。
- 点赞
- 收藏
- 关注作者
评论(0)