更新记录

1.0.1（2026-03-29）

增加获取当前屏幕是竖向时还是横向

1.0.0（2026-03-29）

ios旋转屏幕

平台兼容性

uni-app(4.87)

uni-app x(4.87)

dui-rotate

uni-app x 下通过 UTS 在 App Android / App iOS 动态切换横竖屏的插件（iOS 使用 UTS 原生混编 Swift）。

在页面中引入

import {
  setAppScreenOrientation,
  setLandscape,
  setPortrait,
  setOrientationSensor,
  getScreenOrientation
} from '@/uni_modules/dui-rotate'

API

mode 可选值：portrait、landscape、reverse-portrait、reverse-landscape、sensor、sensor-portrait、sensor-landscape、full-sensor、user、nosensor（与 Android ActivityInfo / iOS 掩码对应，部分语义在 iOS 上略有差异）。

建议在用户点击等交互里调用，避免在页面极早生命周期里调用。

uvue 示例

<script setup lang="uts">
import { setLandscape, setPortrait, setOrientationSensor, getScreenOrientation } from '@/uni_modules/dui-rotate'

function onLandscape() {
  setLandscape()
}
function onPortrait() {
  setPortrait()
}
function onSensor() {
  setOrientationSensor()
}
function onReadOrientation() {
  const o = getScreenOrientation()
  console.log('当前朝向', o)
}
</script>

参考文档

• UTS 语法
• UTS 插件
• UTS 原生混编
• Hello UTS