# 设置屏幕方向
该能力用于设定网页在屏幕展示的方式，支持强制横屏、强制竖屏、跟随系统设置。
## 支持说明
当前能力在不同飞书客户端的版本支持情况。
是否需要鉴权 | Android | iOS | PC | 预览效果
---|---|---|---|---
不需要 | V5.15 | V5.15 | **X** | 预览
## 注意事项
- 设置屏幕方向的能力不支持 Pad 设备。
- 该能力与网页内横竖屏切换按钮（即锁定屏幕后旋转设备方向出现的按钮）功能无关。
## 使用方式
设置屏幕方向的配置基于 web-meta 能力实现，参数配置如下表所示。
- 使用前，请先了解 [web-meta](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/web-app-open-ability/web-meta) 的能力与使用方式。
- 如果不通过 web-meta 属性设定屏幕方向，则应用在默认情况下跟随系统设置。例如：
- 如果手机设备设置为自动旋转，则页面可自动旋转。
- 如果手机设备设置为锁定屏幕，则页面为竖屏。
参数名称 | 数据类型 | 是否必填 | 描述
---|---|---|---
name | String | 是 | 固定取值：orientation
content | String | 是 | 期望设定的屏幕方向。
可选值：
- `default`：iOS默认竖屏，其他端跟随系统展示方式。
- `portrait`：强制为竖屏。
- `landscape`：强制为横屏。
## 示例配置
基于 web-mete 能力的不同定义方式，设置屏幕方向的示例配置如下。
### 示例一：通过 \ 标签定义 page-meta
该配置方式仅针对当前页面生效，该配置方式仅针对当前页面生效，其中引入的 JSSDK 最新版本信息可参见[开发网页应用简介](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/introduction)。
```html
```
### 示例二：通过 URL 参数定义 page-meta
该配置方式仅针对当前页面生效。
```
https://feishu.cn/?lk_meta=%7B%22page-meta%22%3A%7B%22orientation%22%3A%22landscape%22%7D%7D
```
### 示例三：通过 URL 参数定义 view-meta
该配置方式针对整个应用生效。
```
https://feishu.cn/?lk_meta=%7B%22view-meta%22%3A%7B%22orientation%22%3A%22landscape%22%7D%7D
```