hmos-window-smart-orientation
Installation
SKILL.md
窗口旋转策略接入技能(hmos-window-smart-orientation)
本技能覆盖鸿蒙(HarmonyOS/OpenHarmony)应用窗口旋转策略的接入与适配,基于 Stage 模型 + ArkTS(@ohos.window),核心突出智感旋转能力。
智感旋转(核心能力,优先阅读)
智感旋转是系统级方向感知增强能力:搭载 OpenHarmony 7.0.0 及以上版本 且支持智感传感器的设备,用户通过 设置 > 系统 > 智感旋转 开启开关后,应用最终显示方向由重力传感器和智感传感器共同作用决定,方向跟随更精准自然。
应用侧接入要点(零新增 API,一套代码全设备覆盖):
- 无需调用任何新接口。应用只要设置自动旋转类策略(
AUTO_ROTATION系列 7 种 /USER_ROTATION系列 4 种)、FOLLOW_DESKTOP(跟随桌面)或未显式设置的默认UNSPECIFIED(系统判定),在支持智感旋转的设备上即自动获得智感旋转体验;在不支持的设备上自动回退为纯重力传感器旋转。 - 使用固定方向策略(
PORTRAIT/LANDSCAPE等)的应用不参与智感旋转,如需体验智感能力必须改用自动旋转类策略(存量项目的扫描与改造流程见 migrate-to-smart-rotation.md)。 - 交互规则:系统旋转锁定开关打开时,
*_RESTRICTED类策略既不跟随重力传感器,也不跟随智感传感器;非 RESTRICTED 的AUTO_ROTATION系列不受旋转锁定开关控制。 - 智感旋转与普通旋转共用同一套生效条件:仅主窗口、前台全屏生效,分屏/智慧多窗悬浮窗/自由多窗/后台场景被系统忽略,无传感器设备(TV 等)不生效。