创建基础版屏幕布局，适用于单屏云手机实例。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=CreateDisplayLayoutMini&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |CreateDisplayLayoutMini |接口名称。当前 API 的名称为 `CreateDisplayLayoutMini`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1641133322660\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录 [云手机控制台](https://console.volcengine.com/ACEP/Business/5)，在已创建的业务卡片中获取。 | |DisplayLayoutId |String |是 |e03\-display |屏幕布局 ID，支持的最大长度为 64 字节，只支持大小写字母、数字、下划线（_）、中划线（\-），在同一业务下唯一，一个业务下最多可创建 100 个屏幕布局配置信息。 | |Width |Integer |是 |720 |屏幕宽度，取值范围在 [400, 2560] 区间的偶数，默认值为 `1080`，单位为 px（像素）。 | |Height |Integer |是 |1280 |屏幕高度，取值范围在 [400, 2560] 区间的偶数，默认值为 `1920`，单位为 px（像素）。 | |Density |Integer |否 |160 |屏幕像素密度，单位为 DPI（每英寸像素数），取值：`120`，`140`，`160`，`180`，`200`，`213`，`220`，`240`，`260`，`280`，`300`，`320`（默认值），`340`，`360`，`390`，`400`，`420`，`440`，`450`，`480`，`520`，`560`，`600`，`640`。 | |Fps |Integer |否 |30 |屏幕刷新率，单位为 fps（每秒帧数），取值：

* `30`

* `45`

* `60`（默认值）

* `90`

* `120` | |Extra |String |否 |API 创建 |备注信息，长度不超过 32 字节。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75713#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |DisplayLayoutId |String |e03\-display |屏幕布局 ID。 | |Width |Integer |720 |屏幕宽度。 | |Height |Integer |1080 |屏幕高度。 | |Density |Integer |160 |屏幕像素密度。 | |Fps |Integer |30 |屏幕刷新率。 | |Extra |String |API 创建 |备注信息。 | |CreateAt |Long |1698911644 |屏幕布局创建时间。 | |IsSystemConfig |Boolean |false |是否为系统屏幕布局配置。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=CreateDisplayLayoutMini&Version=2025-05-01 { "ProductId": "1641133322660***", "DisplayLayoutId": "e03-display", "Width": 720, "Height": 1280, "Density": 160, "Fps": 30, "Extra": "API 创建" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "CreateDisplayLayoutMini", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "DisplayLayoutId": "e03-display", "Width": 720, "Height": 1080, "Density": 160, "Fps": 30, "Extra": "API 创建", "CreateAt": 1698911644, "IsSystemConfig": false } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。