hmos-multidevice-natural-orientation

Call setPreferredOrientation on the main window instance obtained via windowStage.getMainWindowSync(), passing a window.Orientation enum such as PORTRAIT or AUTO_ROTATION_RESTRICTED. Always save the previous orientation on page entry and restore it on exit, since the setting is window-level global state.

Do not use deviceInfo.deviceType to detect foldables, because foldables return 'phone' just like bar phones. Use display.isFoldable() and display.getFoldStatus() instead, and skip forced portrait when the device is in expanded or half-folded state.

HarmonyOS ignores rotation strategies in split-screen, floating window, and free-window modes by system design; the call fails silently without errors. Adapt layouts responsively using windowSizeChange listeners and breakpoint APIs instead of trying to control orientation.

Display rotation is the physical screen's clockwise angle (0-3) read from the display module, while window orientation is the rotation strategy developers set via setPreferredOrientation. The mapping between them depends on each device's natural orientation, so they cannot be used interchangeably.

The px2vp conversion depends on DPI, so raising display size scaling lowers computed vp values and can drop the minimum dimension below the 348vp rotation threshold. Use physical pixels or system breakpoint APIs for the threshold check instead, since px values are unaffected by DPI scaling.

Set USER_ROTATION_LANDSCAPE when entering fullscreen and restore the saved orientation on exit, pairing every setPreferredOrientation call. For short-video adaptive rotation, the adaptive_video third-party library handles device breakpoints and video aspect ratios automatically.