文档中心

云手机

屏幕布局管理

创建基础版屏幕布局 CreateDisplayLayoutMini

创建基础版屏幕布局 CreateDisplayLayoutMini

创建基础版屏幕布局，适用于单屏云手机实例。

请求说明

请求方式：POST

请求地址：https://open.volcengineapi.com?Action=CreateDisplayLayoutMini&Version=2025-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	CreateDisplayLayoutMini	接口名称。当前 API 的名称为 CreateDisplayLayoutMini。
Version	String	是	2025-05-01	接口版本。当前 API 的版本为 2025-05-01。

Body

参数	类型	是否必选	示例值	描述
ProductId	String	是	1641133322660***	业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录云手机控制台，在已创建的业务卡片中获取。
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 字节。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
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	是否为系统屏幕布局配置。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.09.24 18:52:34

这个页面对您有帮助吗？

有用

有用

无用

无用