hmos-multidevice-natural-orientation

name	hmos-multidevice-natural-orientation
description	Handle HarmonyOS device natural orientation, screen rotation, and window orientation adaptation across multiple device form factors. Use when the task involves setPreferredOrientation, rotation, orientation, natural orientation, tri-fold G-state, follow_desktop, video landscape/portrait switching, short video adaptive rotation, or multi-device orientation strategy.

设备自然方向与屏幕旋转适配

技能定义

字段	内容
skill_id	device-natural-orientation
skill_name	设备自然方向适配
one_line_purpose	为自然竖屏、自然横屏和特殊折叠态提供统一方向判定与更新策略。
device_scope	phone / tablet / pc / 2in1 / tri-fold / foldable
problem_scope	屏幕旋转(rotation)、屏幕方向(display orientation)、窗口方向(window orientation)、自然方向差异、传感器旋转检测、多设备方向映射、三折叠 G 态方向、视频横竖屏切换、短视频自适应旋转
not_in_scope	与方向无关的纯布局问题、web视觉翻转的场景、折叠屏折痕避让（属 device-avoid-areas）、交互输入方式适配（属 interaction-methods）、硬件能力检测（属 hardware-access）
primary_outputs	primary_scene, device_constraints, code_touchpoints, implementation_notes, fix_plan, verification_matrix

核心约束

1. 先区分屏幕旋转(rotation)、屏幕方向(display orientation)和窗口方向(window orientation)，三者含义和用途不同，不可混用
2. 控制应用显示方向必须通过窗口侧 setPreferredOrientation() 设置旋转策略，不能通过屏幕属性设置
3. 涉及多设备适配时，必须明确目标设备的自然方向类型：自然竖屏(rotation=0 为 PORTRAIT)、自然横屏(rotation=0 为 LANDSCAPE)、三折叠 G 态(rotation=0 为 LANDSCAPE_INVERTED)