HarmonyOS ArkTS 横竖屏设置

最新推荐文章于 2025-05-13 21:00:00 发布

原创

最新推荐文章于 2025-05-13 21:00:00 发布 · 2.3k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #arkts

一、全局横竖屏设置，在module.json5下，对当前UIAbility配置orientation，如下：

{
  "module": {
    "name": "entry",
    "type": "entry",
    ...
    "abilities": [
      {
        "name": "EntryAbility",
        ...
        "orientation": "auto_rotation",
        ...
      }
    ]
  }
}

orientation属性列表如下：

orientation属性	描述
unspecified	未指定方向，由系统自动判断显示方向
landscape	横屏
portrait	竖屏
landscape_inverted

最低0.47元/天解锁文章

200万优质内容无限畅学

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

Jay丶Xu

关注关注

13
点赞
踩
5

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

HarmonyOS鸿蒙开发指南:基于ArkTS开发折叠屏示例代码集

sybh的博客

01-11

1468

交互不中断示例代码、横竖屏旋转适配示例代码、字体/图标适配示例代码、图片/视频/弹出框适配示例代码、运营类图片/视频、其他控件适配示例代码

【鸿蒙性能优化】横竖屏切换开发实践

CTrup的博客

09-09

1321

在旋转过程绘制中，由于生成文字缓存非常耗时图形所以会把文字转成图片，但是如果该页面上的文字使用了零宽字符，会导致每个字符被转成图片，会带来额外的绘制负载。具体的实现逻辑在windowUtil中，在调用屏幕旋转方向时，可以通过windowStage拿到对应的window实例，并设置旋转setPreferredOrientation。如果当前旋转页面存在一些图片，未经合理的裁剪，图片过大，可以对图片设置AutoResize属性，使图片裁剪到合适的大小进行绘制。以下是简化后的示例代码，可直接运行参考使用。

参与评论您还未登录，请先登录后发表或查看评论

鸿蒙开发之设置横竖屏

Lu_Ca的博客

03-04

1382

我的需求是APP大部分是竖屏显示，在某个页面需要显示横屏。直接上答案。

【HarmonyOS】ArkTS开发应用的横竖屏切换

最新发布

沙师弟专栏

05-13

1293

本文详细介绍了在鸿蒙ArkTS框架下实现横竖屏切换的两种方案：静态配置与动态调整。静态配置通过修改module.json5文件中的orientation属性，实现基础方向锁定，支持多种方向枚举值。动态调整则通过setPreferredOrientation方法，在运行时感知设备旋转并智能适配，适用于需要根据用户操作或系统状态动态调整方向的场景，如视频播放页面。文章还提供了具体的代码示例和实现原理，帮助开发者在实际项目中灵活应用这两种方案，提升用户体验。

基于原生能力的横竖屏旋转适配

hongxiaomeng的博客

06-07

492

42.HarmonyOS鸿蒙系统 App(ArkUI)实现横屏竖屏自适应

Txwtech笛克特科

03-31

2237

HarmonyOS鸿蒙系统 App(ArkUI)实现横屏竖屏自适应作为响应式设计的核心，在移动设备上应用十分广泛。媒体查询可根据不同设备类型或同设备不同状态修改应用的样式。

鸿蒙Harmony arkTS Stage开发设备横屏竖屏监听事件

yakie的专栏

11-29

1621

具体需求是正常竖屏时候，显示正常的组件，然后有24行，正好显示完全，如果横屏则行数太多显示不全，这时候需要把组件加入到一个Scroll里面，然后设置小行高，满足每一行行高不至于太小。这里MyCustComponent是我自定义页面，有24行Text，横屏时候高度放大2倍，可以在Scroll里面滚动。鸿蒙开发，遇到设备需要根据横屏竖屏不同状态来显示不同界面。

HarmonyOS ArkTS中视频播放Video组件实现竖屏到横屏切换

独行猫a 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS)

12-18

864

Video组件是ArkTS中用于播放视频的内置组件，它支持多种功能，包括自动播放、静音、循环播放等。通过Video组件，开发者可以方便地在应用中集成视频播放功能。接下来，我们定义一个组件，并在组件中使用Video@Component@State videoSrc: string = 'http://staticvip.iyuba.cn/video/small/202412/1009544_c.mp4' // 使用时请替换为实际视频加载网址// 获取视频播放参数});

HarmonyOS开发实战指南：横竖屏开发实践

DMZDAMS的博客

07-14

3306

在开发时，部分应用需要提供全屏按钮，让用户选择开启横竖屏播放，另外我们也需要考虑系统是否开启了方向锁定，在方向锁定的情况下，用户只能通过手动横屏来实现全屏，而在方向没有锁定下，用户将设备横向的情况下，应用需要自动切换到横屏进行播放。

鸿蒙(HarmonyOS)实战开发篇——横竖屏切换开发实践

lc748258的博客

09-28

1608

执行进入全屏时首先需要通过display获取当前的显示方向，并根据当前显示方向，执行对应的屏幕旋转逻辑。

【HarmonyOS 鸿蒙实战开发】视频横竖屏切换及进度条热区拖动案例

CTrup的博客

12-20

713

本示例介绍了 @ohos.multimedia.media 组件和 @ohos.window 接口以及使用触摸热区实现视频横竖屏切换及进度条热区拖动的功能。该场景多用于横竖屏视频等媒体播放。

（已解决）横屏app，页面崩溃问题，细节，细节，细节

听君一席话，胜读十年书

03-21

327

（已解决）横屏app，页面崩溃问题，细节，细节，细节 1、现象：手机小米10，点击activity A，页面直接崩溃。AndroidManifest.xml中Activity。android:screenOrientation属性。2、原因：activity A 没有添加。

鸿蒙应用开发学习：ArkTs将应用设置为全屏显示并隐藏状态栏

bahamutj的博客

01-13

3755

近期学习鸿蒙应用开发，跟着教程做了一个小鱼动画应用，之前解决了应用默认是竖屏，而这个小鱼动画应用是横屏的问题。这次通过实现应用全屏显示并隐藏手机状态栏，来解决页面返回中的按钮与状态栏重叠而导致按钮不能正常响应点击事件的问题。

【FAQ】【ARK UI】HarmonyOS ETS 横竖屏适配

华为开发者联盟

08-10

1217

HarmonyOS ETS 横竖屏适配

手把手教你使用 ArkTS 中的 canvas 实现签名板功能

HarmonyOSDev的博客

12-20

1221

● 实现签名板的第一个功能就是旋转屏幕。旋转屏幕在各种框架中都有不一样的方式，比如：在 H5 端，我们一般是使用 CSS 中的 transform 属性中的 rotate()方法来强制将网页横屏，然后实现一系列功能● 在嵌套第三方 APP 中，我们一般是调用对应的 SDK 提供的方法，即可实现旋转屏幕● .....实现方式还有很多，各有千秋，相信 HarmonyOS 也会提供对应 API 方法来设置旋转屏幕。

DAYU200_横竖屏切换的修改【坚果派】

坚果的博客

10-17

3073

修改最后一个字段[默认是0或1，表示竖屏]的值为：【2或4，表示横屏】，然后再推回去，重启就行了。

【鸿蒙学习必备】OpenHarmony 开发语言（ArkTS）常见问题汇总（建议收藏）

爱码小哥

04-10

2169

适用于：OpenHarmony 3.2 Beta5 API 9解决措施@Builder装饰的方法中使用了自定义组件，那么该方法每次被调用时，对应的自定义组件均会重新创建，普通方法中不使用@builder装饰，无法容纳自定义组件。适用于：OpenHarmony 3.2 Beta5 API 9解决措施定义个callback函数的样例，示例如下：定义回调函数// 页面中定义个2个参数,空返回的callback函数在使用时进行初始化赋值// callback函数初始化}}鸿蒙开发咨询、解答、项目实战。

arkts横竖屏幕切换

12-28

### ArkTS 实现横竖屏幕切换在 OpenHarmony 开发环境中，通过 `context.setDisplayOrientation` 接口可以设置应用界面的方向。此方法接受两个参数：一个是枚举类型的显示方向，另一个是回调函数，在操作完成后调用[^2]。下面是一个简单的示例来展示如何利用 ArkTS 进行横屏和竖屏之间的切换： ```typescript // 导入必要的模块 import window from '@ohos.window'; function toggleScreenOrientation() { let currentOrientation = window.getDisplayOrientation(); // 获取当前的屏幕方向 const orientationToSet = (currentOrientation === window.DisplayOrientation.PORTRAIT) ? window.DisplayOrientation.LANDSCAPE : window.DisplayOrientation.PORTRAIT; context.setDisplayOrientation(orientationToSet, (err) => { // 使用 callback 形式的 setDisplayOrientation 方法 if (!err) { console.log('成功切换到 ' + (orientationToSet ? "横向模式" : "纵向模式")); } else { console.error('切换失败'); } }); } ``` 上述代码定义了一个名为 `toggleScreenOrientation` 的函数，它会获取设备当前的屏幕方向并将其反转——如果现在是垂直方向则变为水平方向；反之亦然。之后调用了带有异步回调机制的 `setDisplayOrientation()` 函数以完成实际的变化过程。对于更复杂的场景，比如多媒体播放器中的全屏功能，则可能涉及到更多的逻辑处理以及 UI 组件的状态管理等问题。此时除了基本的方向控制外还需要考虑其他因素如用户体验等[^3]。