Kazumi项目中的小窗横屏适配与全屏切换问题解析

Kazumi项目中的小窗横屏适配与全屏切换问题解析

Kazumi 该分支仓库目前用于发布 HarmonyOS NEXT 版本 hap 包 项目地址: https://gitcode.com/gh_mirrors/kaz/Kazumi

在移动应用开发中，视频播放器的多窗口模式支持是一个常见的需求，但实现过程中往往会遇到各种技术挑战。本文将以Kazumi项目为例，深入分析小窗横屏适配和全屏切换过程中遇到的技术问题及其解决方案。

小窗横屏的技术实现

Kazumi项目最初版本未对小窗横屏模式进行专门适配，导致在小窗模式下无法正常横屏播放。这一问题在安卓系统中尤为明显，因为安卓的多窗口模式会默认禁止全屏操作。

经过技术分析，开发团队发现可以通过以下方式解决：

1. 小窗大小控制：在小窗模式下，通过精确控制窗口尺寸来实现横屏效果
2. 系统API调用：在鸿蒙系统上，使用华为原生代码进行特殊控制
3. 方向检测优化：改进OrientationBuilder的使用方式，正确处理小窗模式下的方向变化

全屏切换的异常现象

在小窗全屏播放后返回全屏模式时，Kazumi项目中出现了一个有趣的异常现象：界面会在横竖屏之间"抽搐"几次才恢复正常。经过深入调试，开发团队定位到问题根源：

1. 状态恢复问题：小窗全屏恢复时系统报告为竖屏(portrait)状态
2. 方向检测冲突：OrientationBuilder在小窗模式下获取的方向信息不准确
3. 动画过渡问题：系统在小窗和全屏间切换时的默认动画效果导致视觉异常

跨平台适配考量

针对不同平台的特性，开发团队评估了多种技术方案：

1. 安卓/HarmonyOS方案：

   • 直接控制分屏/小窗行为
   • 使用系统原生API实现更稳定的全屏控制

2. iOS方案考量：

   • 评估画中画(PiP)模式的可行性
   • 研究AVPlayer原生接口实现小窗播放
   • 注意应用被系统冻结导致的黑屏问题

用户体验优化

虽然技术上可以实现小窗横屏功能，但团队从用户体验角度进行了深入思考：

1. 使用场景分析：

   • 手机端：边看视频边聊天的需求
   • 平板端：大屏幕多任务处理的实用性更高

2. 功能取舍：

   • 权衡开发成本与用户体验收益
   • 优先保证核心播放功能的稳定性

解决方案与版本发布

经过多次测试和优化，Kazumi项目在1.5.7版本中实现了：

1. 基础的小窗横屏支持
2. 改进了全屏切换的稳定性
3. 保留了进一步优化画中画功能的扩展性

这一案例展示了视频播放器开发中常见的多窗口适配挑战，也为类似项目提供了有价值的技术参考。开发者需要根据不同平台的特性，权衡功能实现与用户体验，才能打造出真正优秀的产品。

Kazumi 该分支仓库目前用于发布 HarmonyOS NEXT 版本 hap 包 项目地址: https://gitcode.com/gh_mirrors/kaz/Kazumi