文档首页/数据可视化 DLV/API参考/API/大屏管理接口/查询大屏详细信息
更新时间：2025-11-14 GMT+08:00
查看PDF
分享

查询大屏详细信息

功能介绍

获取某一个大屏的详细信息。

URI

  • URI格式 
    GET /v1/{project_id}/screens/{screen_id}?workspaceId={}
  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    项目编号，获取方法请参见获取项目ID。

    screen_id

    是

    String

    大屏ID，获取方法请参见查询大屏列表。

    workspaceId

    是

    String

    工作空间ID，长度为32个字符，获取方法请参见获取workspaceId

响应消息

参数说明：如表2所示。
表2 响应参数

参数

参数类型

描述

id

String

大屏ID

name

String

大屏名称

alias

String

大屏别名

description

String

大屏的描述信息

status

Integer

大屏状态：0-created，1- deleted，2-shared

projectId

String

项目编号，即project_id

createUser

String

大屏的创建者

createDate

Integer

大屏的创建时间戳

updateUser

String

大屏的更新者

updateDate

Integer

大屏的更新时间戳

templateId

String

基于模板创建大屏的模板ID

snapshotId

String

大屏快照的ID

share

String

大屏分享的UUID标识

thumbnail

String

大屏缩略图的访问地址

config

config object

大屏的配置内容

表3 config数据结构

参数

参数类型

描述

scenes

Array of scene objects

场景信息

config

Array of config objects

配置详情

表4 scene

参数

参数类型

描述

name

String

场景名称

layers

Array of layer objects

分层

表5 layer

参数

参数类型

描述

id

String

分层的ID

name

String

分层的名称。

coms

Array

组件列表

表6 config

参数

参数类型

描述

id

String

大屏配置唯一标识

screenId

String

大屏ID

grid

Integer

栅格间距，单位为像素

backgroundImage

String

背景图片OBS链接

backgroundColor

String

背景颜色

width

Integer

屏幕宽度，单位为像素

height

Integer

屏幕高度，单位为像素

whLinkage

Integer

大屏宽度和高度联动配置状态；0：关闭；1：开启

comList

String

组件列表

screenshot

String

封面图

display

Integer

缩放方式：

  • 1：按宽度等比缩放铺满
  • 2：按高度等比缩放铺满
  • 3：等比缩放自适应
  • 4：全屏拉铺满

watermarkFlag

Integer

是否有水印

rulerLines

rulerLines object

坐标

variables

variables object

交互信息

workspaceId

String

工作空间ID。

表7 rulerLines

参数

参数类型

描述

h

String

水平标尺线坐标，单位为像素

v

String

垂直标尺线坐标，单位为像素

show

Boolean

是否显示，true：显示，false：不显示

表8 variables

参数

参数类型

描述

publishersView

String

发送组件交互参数列表

subscribersView

String

接收组件交互参数列表

示例

查询大屏ID为ff80808167813a360167819d5b640045的详细信息。

  • 请求示例 
    GET https://{dlv_endpoint}/v1/{project_id}/screens/ff80808167813a360167819d5b640045?workspaceId={86ce107974ce4f93b618acb232863027}

  • 成功响应示例 
    {
    "id": "ff80808167813a360167819d5b640045",
    "name": "screen_01",
    "alias": "test_screen_01",
    "description": "for test",
    "status": 2,
    "projectId": "abcdefghijk0123456",
    "createUser": "a1b2c2d3e4f5g6h5j6k6",
    "createDate": 1544067832676,
    "updateUser": null,
    "updateDate": null,
    "templateId": "32546212564",
    "snapshotId": null,
    "share": "f7c9a336e6c74ca5883a60af882d92de",
    "thumbnail": null,
    "config": {
        "scenes": [
            {
                "name": "场景1",
                "layers": [
                    {
                        "id": "ff80808167813a360167819d5b640047",
                        "name": "层1",
                        "coms": []
                    }
                ]
            }
        ],
        "config": {
            "id": "ff80808167813a360167819d5b650048",
            "screenId": "ff80808167813a360167819d5b640045",
            "grid": null,
            "backgroundImage": "",
            "backgroundColor": null,
            "width": 1920,
            "height": 1080,
            "whLinkage": null,
            "comList": "",
            "screenshot": null,
            "display": 1,
            "watermarkFlag": null,
            "rulerLines": null,
            "variables": null
        }
    }
}

  • 失败响应示例 
    {
    "errors": [
        {
            "error_code": "1004",
            "error_msg": "The operation with the resource entity occur some error."
        }
    ]
}

状态码

状态码请参见状态码。

父主题：大屏管理接口