更新记录

1.0.2（2026-03-29）

修改成异步返回

1.0.1（2026-03-29）

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

1.0.0（2026-03-29）

ios旋转屏幕

平台兼容性

uni-app(4.87)

uni-app x(4.85)

dui-rotate

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

在页面中引入

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

类型见 uni_modules/dui-rotate/utssdk/interface.uts（SetScreenOrientationOptions、SetScreenOrientationCallbacks 等）。

API（异步回调）

设置朝向均在主线程异步完成，通过 success / fail / complete 获知结果（与常见 uni API 习惯一致）。

SetScreenOrientationOptions

• mode：portrait、landscape、reverse-portrait、reverse-landscape、sensor、sensor-portrait、sensor-landscape、full-sensor、user、nosensor
• success(res)：res.errMsg 一般为 'ok'，res.mode 为本次请求的 mode
• fail(err)：err.errMsg、err.errCode、err.mode
• complete(res)：无论成功失败都会调用；参数与 success 的 res 或 fail 的 err 同结构（需自行用 errCode 等区分）

错误码 errCode

说明：成功表示已提交旋转请求（Android 已调用 setRequestedOrientation；iOS 已走几何更新或 legacy 路径），不保证系统最终动画与硬件状态与预期完全一致。iOS 16+ 在约 120ms 内若未收到几何错误则视为成功。

工程配置（iOS）

pages.json → globalStyle 建议 "pageOrientation": "auto"，否则 iPhone 可能仅竖屏。详见 启动界面方向。

uvue 示例

<script setup lang="uts">
import { setAppScreenOrientation } from '@/uni_modules/dui-rotate'

function lockLandscape() {
  setAppScreenOrientation({
    mode: 'landscape',
    success: (res) => {
      console.log('ok', res.mode, res.errMsg)
    },
    fail: (err) => {
      console.log('fail', err.errCode, err.errMsg)
    },
    complete: (res) => {
      console.log('complete')
    }
  })
}
</script>

参考文档

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