【鸿蒙南向开发】OpenHarmony如何切换横竖屏？

鸿蒙横竖屏切换

最新推荐文章于 2025-09-23 16:50:16 发布

原创

最新推荐文章于 2025-09-23 16:50:16 发布 · 1.1k 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #android #鸿蒙 #前端

前言

在日常开发中，大多APP可能根据实际情况直接将APP的界面方向固定，或竖屏或横屏。但在使用过程中，我们还是会遇到横竖屏切换的功能需求，可能是通过物理重力感应触发，也有可能是用户手动触发。所以本文主要带大家了解在OpenAtom OpenHarmony（以下简称“OpenHarmony”）应用开发的过程中，如何在Stage模型和FA模型下使用对应的接口去完成横竖屏的切换。
本文中OpenHarmony版本为3.2 Beta4，API版本为9。开发板为DAYU200。

FA模型

FA模型下，setDisplayOrientation和setDisplayOrientation是切换横竖屏的接口。

文档：

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-inner-app-context.md#contextsetdisplayorientation7

context.setDisplayOrientation
setDisplayOrientation(orientation: bundle.DisplayOrientation, callback: AsyncCallback): void
设置当前能力的显示方向（callback形式）。

系统能力：
SystemCapability.Ability.AbilityRuntime.Core

参数：
在这里插入图片描述

示例：

import featureAbility from '@ohos.ability.featureAbility';
import bundle from '@ohos.bundle';
//FA模型下获取context
var context = featureAbility.getContext();
var orientation = bundle.DisplayOrientation.UNSPECIFIED;
context.setDisplayOrientation(orientation, (err) => {
    console.info("setDisplayOrientation err: " + JSON.stringify(err));
});

完整代码

import bundle from '@ohos.bundle';
import featureAbility from '@ohos.ability.featureAbility';
@Entry
@Component
struct Index {
  @State message: string = '横竖屏切换 '
  @State portrait: boolean = true

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(30)
          .fontWeight(FontWeight.Bold).onClick(() => {
          var context = featureAbility.getContext();
          if (this.portrait) {

            // 横屏
            var orientation = bundle.DisplayOrientation.LANDSCAPE;
            context.setDisplayOrientation(orientation, (err) => {
              this.portrait = !this.portrait
              console.info("setDisplayOrientation err: " + JSON.stringify(err));
            });
          } else {
            //竖屏
            var orientation = bu