关于openharmony:OpenHarmony如何切换横竖屏

前言

在日常开发中，大多 APP 可能依据理论状况间接将 APP 的界面方向固定，或竖屏或横屏。但在应用过程中，咱们还是会遇到横竖屏切换的性能需要，可能是通过物理重力感应触发，也有可能是用户手动触发。所以本文次要带大家理解在 OpenAtom OpenHarmony（以下简称“OpenHarmony”）利用开发的过程中，如何在 Stage 模型和 FA 模型下应用对应的接口去实现横竖屏的切换。

本文中 OpenHarmony 版本为 3.2 Beta4，API 版本为 9。开发板为 DAYU200。

FA 模型

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

文档：https://gitee.com/openharmony…

context.setDisplayOrientation
setDisplayOrientation(orientation:bundle.DisplayOrientation, callback: AsyncCallback<void>): 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 = bundle.DisplayOrientation.PORTRAIT;
            context.setDisplayOrientation(orientation, (err) => {
              this.portrait = !this.portrait
              console.info("setDisplayOrientation err:" + JSON.stringify(err));
            });      
          }
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

Stage 模型

从 API 9 开始，能够应用 setPreferredOrientation 来切换横竖屏。

文档：https://gitee.com/openharmony…

在 Stage 模型中，应用到的次要是 Window(窗口)。在设置横竖屏切换的时候，须要先应用 getLastWindow()、createWindow()、findWindow() 中的任一办法获取到 Window 实例，再通过此实例调用对应的办法，本文应用的是 getLastWindow。

Window.getLastWindow
getLastWindow(ctx: BaseContext): Promise<Window>
获取以后利用内最初显示的窗口，应用 Promise 异步回调。
零碎能力：SystemCapability.WindowManager.WindowManager.Core

参数：

返回值：

错误码：以下错误码的具体介绍请参见窗口错误码。

let windowClass = null;
try {let promise = window.getLastWindow(this.context);
    promise.then((data)=> {
        windowClass = data;
        console.info('Succeeded in obtaining the top window. Data:' + JSON.stringify(data));
    }).catch((err)=>{console.error('Failed to obtain the top window. Cause:' + JSON.stringify(err));
    });
} catch (exception) {console.error('Failed to obtain the top window. Cause:' + JSON.stringify(exception));
}

而后就能够应用 setPreferredOrientation 属性。

setPreferredOrientation

setPreferredOrientation(orientation: Orientation): Promise<void>

设置窗口的显示方向属性，应用 Promise 异步回调。

零碎能力：SystemCapability.WindowManager.WindowManager.Core

参数：

返回值：

错误码：以下错误码的具体介绍请参见窗口错误码。

let orientation = window.Orientation.AUTO_ROTATION;
try {let promise = windowClass.setPreferredOrientation(orientation);
    promise.then(()=> {console.info('Succeeded in setting the window orientation.');
    }).catch((err)=>{console.error('Failed to set the window orientation. Cause:' + JSON.stringify(err));
    });
} catch (exception) {console.error('Failed to set window orientation. Cause:' + JSON.stringify(exception));
}

总结

本文带大家应用对应的接口，在 Stage 模型和 FA 模型下实现了横竖屏的切换。其中还波及到了上下文的获取：Stage 模型用（getContext(this) as any），FA 模型（featureAbility.getContext()），大家能够在此基础上利用生命周期的回调，在适合的中央实现对应的操作。