前言
在日常开发中,大多APP可能根据实际情况直接将APP的界面方向固定,或竖屏或横屏。但在使用过程中,我们还是会遇到横竖屏切换的功能需求,可能是通过物理重力感应触发,也有可能是用户手动触发。所以本文主要带大家了解在OpenAtom OpenHarmony(以下简称“OpenHarmony”)应用开发的过程中,如何在Stage模型和FA模型下使用对应的接口去完成横竖屏的切换。
本文中OpenHarmony版本为3.2 Beta4,API版本为9。开发板为DAYU200。
FA模型
FA模型下,setDisplayOrientation和setDisplayOrientation是切换横竖屏的接口。
文档:
context.setDisplayOrientation
setDisplayOrientation(orientation:bundle.DisplayOrientation, callback: AsyncCallback<void>): void
设置当前能力的显示方向(callback形式)。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
示例:
1 2 3 4 5 6 7 8 9 | 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)); }); |
完整代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 | 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来切换横竖屏。
文档:
在Stage模型中,使用到的主要是Window(窗口)。在设置横竖屏切换的时候,需要先使用getLastWindow()、createWindow()、findWindow()中的任一方法获取到Window实例,再通过此实例调用对应的方法,本文使用的是getLastWindow。
Window.getLastWindow
getLastWindow(ctx: BaseContext): Promise<Window>
获取当前应用内最后显示的窗口,使用Promise异步回调。
系统能力:SystemCapability.WindowManager.WindowManager.Core
参数:
返回值:
错误码:以下错误码的详细介绍请参见窗口错误码。
1 2 3 4 5 6 7 8 9 10 11 12 13 | 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
参数:
返回值:
错误码:以下错误码的详细介绍请参见窗口错误码。
1 2 3 4 5 6 7 8 9 10 11 12 | 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)); } |
完整代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | import Window from '@ohos.window' import common from '@ohos.app.ability.common' ; @Entry @Component struct ArkUIClubTest { private portrait: boolean = true build() { Stack() { Button( "横竖屏切换" ) .onClick(() => { this .changeOrientation() }) } .width( '100%' ) .height( '100%' ) } private changeOrientation() { let windowClass = null ; //获取上下文 //var context = getContext(this) as any // 获取上下文,使用common模块 var context = getContext( this ) as common.UIAbilityContext; let promise = Window.getLastWindow(context); promise.then((data) => { windowClass = data; if ( this .portrait) { //切换成横屏 let orientation = Window.Orientation.LANDSCAPE; windowClass.setPreferredOrientation(orientation, (err) => { }); this .portrait = ! this .portrait console.info( 'Succeeded in obtaining the top window. Data: ' + JSON.stringify(data)); } else { //切换成竖屏 let orientation = Window.Orientation.PORTRAIT; windowClass.setPreferredOrientation(orientation, (err) => { }); this .portrait = ! this .portrait 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)); }); } } |
总结
本文带大家使用对应的接口,在Stage模型和FA模型下完成了横竖屏的切换。其中还涉及到了上下文的获取:Stage模型用(getContext(this) as any),FA模型(featureAbility.getContext()),大家可以在此基础上利用生命周期的回调,在合适的地方完成对应的操作。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库
· 上周热点回顾(2.17-2.23)