更新记录

1.0.0（2025-11-10）

1.首次发布

平台兼容性

鸿蒙屏幕方向控制插件

介绍

本插件是一个专为鸿蒙平台设计的UTS插件，用于控制设备屏幕的方向。支持横屏、竖屏切换以及多种方向模式。

功能说明

• 支持设置屏幕方向为竖屏、横屏或自动旋转
• 提供7种方向模式配置选项
• 专为鸿蒙平台优化

使用方法

1. 导入插件

import { setOrientation } from '@/uni_modules/tsw-harmonyApi-uts'

2. 调用方法

// 设置屏幕方向
setOrientation(orientation: number)

3. 参数说明

orientation参数值及含义：

• 0: 定义方向模式，由系统判定
• 1: 竖屏
• 2: 横屏
• 3: 反向竖屏
• 4: 反向横屏
• 5: 跟随传感器自动旋转，可以旋转到竖屏、横屏、反向竖屏、反向横屏四个方向
• 6: 跟随传感器自动竖向旋转，可以旋转到竖屏、反向竖屏，无法旋转到横屏、反向横屏

在Vue页面中使用示例

<template>
  <view class="content">
    <button @click="setPortrait">竖屏</button>
    <button @click="setLandscape">横屏</button>
    <button @click="setAutoRotate">自动旋转</button>
  </view>
</template>

<script>
import { setOrientation } from '@/uni_modules/tsw-harmonyApi-uts'

export default {
  methods: {
    setPortrait() {
      // 设置为竖屏
      setOrientation(1)
    },
    setLandscape() {
      // 设置为横屏
      setOrientation(2)
    },
    setAutoRotate() {
      // 设置为自动旋转
      setOrientation(5)
    }
  }
}
</script>

注意事项

1. 本插件仅支持鸿蒙平台
2. 使用前请确保已正确安装插件
3. 部分设备可能因系统设置限制无法改变屏幕方向

相关链接

• HarmonyOS官方文档