读取屏幕详细信息
POST
/open/api/screen/readDetail
| 字段 | 说明 |
|---|---|
| deviceId | 设备号 |
| screenId | 屏幕id |
| Osd | 节点数据参考 https://openapi.novastar.tech/zh/h/api-95469378 |
| OsdImage | 节点数据参考https://openapi.novastar.tech/zh/h/api-95469378 |
| Bkg | 参考 https://openapi.novastar.tech/zh/h/api-95469414 |
| Screen3D | 请参考 https://openapi.novastar.tech/zh/h/api-95469376 |
| audioOuputMode | 音频输出模式0:随路输出模式 1:固定输出模式， |
| followId | 随路模式的音频源inputid |
| layerId | 随路模式音频源的所在的图层layerid |
| inputId | 固定模式时，音频源inputid |
| isMute | 是否静音，1：静音，0：有声音 |
| volume | 音量大小，0-100 |
| imageQuality | 画质数据 "all"：亮度/对比度的整体值；"R"、"G"、"B"分别代表亮度/对比度的分量值 |
| colorTemperature | 色温 范围为2000-10000 |
| hue | 色调； |
| saturation | 饱和度； |
| interfaceId | 接口号 |
| interfaceType | 接口类型 |
| resolution | 分辨率 |
| height | 高 |
| isInterlace | |
| refresh | 刷新率 refresh是实际值x100 |
| width | 宽 |
| usedEyeCare | 屏幕使用的画质模式的护眼模式开关 |
| eyeCare | 护眼模式的开关0关闭1开启 |
| mosaic | 输出的拼接方式 |
| row | 总行数 |
| column | 总列数 |
| edgeEnable | 是否启用边缘融合 |
| edgeWidth | 边缘宽度 |
| edgeHeight | 边缘高度 |
| brightness | 屏幕亮度 值0-100 |
请求参数
Body 参数application/json
示例
{
"body":{
"screenId":2,
"deviceId":0
},
"sign":"MjI0OGYzMGQwMjhlMmI4YTNmMjM2MjE3MjYzYTFkODg=",
"pId":"1",
"timeStamp":"1631949094265"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/api/screen/readDetail' \
--header 'Content-Type: application/json' \
--data-raw '{
"body":{
"screenId":2,
"deviceId":0
},
"sign":"MjI0OGYzMGQwMjhlMmI4YTNmMjM2MjE3MjYzYTFkODg=",
"pId":"1",
"timeStamp":"1631949094265"
}'返回响应
🟢200成功
application/json
Body
示例
{
"body": {
"Bkg": {
"bkgId": 0,
"enable": 0,
"imgUrl": "/data/BKGImage/17590451345451.jpg"
},
"Freeze": {
"enable": 0
},
"Ftb": {
"enable": 1
},
"Osd": {
"deviceId": 0,
"enable": 0,
"global": {
"backgroundColor": {
"A": 0,
"B": 0,
"G": 0,
"R": 0
},
"backgroundEnable": 1,
"fontColor": {
"A": 100,
"B": 0,
"G": 0,
"R": 255
}
},
"isJudge": 0,
"position": {
"height": 540,
"width": 1920,
"x": 2285,
"y": 1115
},
"text": []
},
"OsdImage": {
"enable": 0,
"height": 300,
"image": {
"file": {
"fileLength": 4096,
"fileName": "",
"hashSum": 0,
"height": 0,
"width": 0
},
"opacity": 100
},
"isJudge": 0,
"type": 1,
"width": 1920,
"x": 1005,
"y": 1005
},
"audio": {
"audioOutputMode": 0,
"channelMode": 0,
"inputId": 255,
"inputType": 0,
"interfaceId": 255,
"isMute": 0,
"layerId": 255,
"outputChannelMode": 0,
"outputInterfaceId": 255,
"outputSlotId": 255,
"slotId": 255,
"volume": 0
},
"brightness": 100,
"deviceId": 0,
"gamma": 1,
"general": {
"createTime": "1757509392.7567859",
"name": "屏幕 1"
},
"genlock": {
"enable": 0,
"status": 0
},
"genlockPhase": {
"phaseEn": 0,
"phaseOffset": 0
},
"imageQuality": [
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 6500,
"contrast": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"eyeCare": 0,
"hue": 0,
"imageQualityMode": 0,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 5000,
"contrast": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"eyeCare": 1,
"hue": 0,
"imageQualityMode": 0,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 6500,
"contrast": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"eyeCare": 0,
"hue": 0,
"imageQualityMode": 1,
"saturation": 50
},
{
"brightness": {
"B": 35,
"G": 35,
"R": 35,
"all": 35
},
"colorTemperature": 5000,
"contrast": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"eyeCare": 1,
"hue": 0,
"imageQualityMode": 1,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 8700,
"contrast": {
"B": 55,
"G": 55,
"R": 55,
"all": 55
},
"eyeCare": 0,
"hue": 0,
"imageQualityMode": 2,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 5000,
"contrast": {
"B": 55,
"G": 55,
"R": 55,
"all": 55
},
"eyeCare": 1,
"hue": 0,
"imageQualityMode": 2,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 8700,
"contrast": {
"B": 55,
"G": 55,
"R": 55,
"all": 55
},
"eyeCare": 0,
"hue": 0,
"imageQualityMode": 3,
"saturation": 50
},
{
"brightness": {
"B": 50,
"G": 50,
"R": 50,
"all": 50
},
"colorTemperature": 5000,
"contrast": {
"B": 55,
"G": 55,
"R": 55,
"all": 55
},
"eyeCare": 1,
"hue": 0,
"imageQualityMode": 3,
"saturation": 50
}
],
"noTimeAudio": {
"audioOutputMode": 0,
"channelMode": 0,
"inputId": 255,
"inputType": 0,
"interfaceId": 255,
"isMute": 0,
"layerId": 255,
"outputChannelMode": 0,
"outputInterfaceId": 0,
"outputSlotId": 0,
"slotId": 255,
"volume": 100
},
"nonTime": 0,
"outputMode": {
"mosaic": {
"column": 1,
"edgeEnable": 0,
"edgeHeight": 0,
"edgeWidth": 0,
"row": 1
},
"offset": {
"x": 2285,
"y": 1115
},
"screenInterfaces": [
{
"connectCapacity": 0,
"cropx": 0,
"cropy": 0,
"dlId": 0,
"dotpitch": 2,
"funcCode": 0,
"height": 1080,
"interfaceId": 0,
"interfaceType": 2,
"isCardOnline": 1,
"isDL": 0,
"mirror": 0,
"modelId": 31552,
"outputId": 0,
"outputName": "output 5-1",
"resolution": {
"height": 1080,
"isInterlace": 0,
"refresh": 60,
"width": 1920
},
"rotate": 0,
"slotId": 4,
"width": 1920,
"x": 2285,
"y": 1115
}
],
"size": {
"height": 1080,
"width": 1920,
"x": 2285,
"y": 1115
}
},
"presetPoll": {
"enable": 0,
"presetGroupId": 0
},
"screen3D": {
"Emitter": 0,
"LeftFirstThenRight": 0,
"delayTimeMs": 7,
"delayTimeUs": 0,
"enable": 0,
"startPointLeftright": 960,
"startPointUpdown": 540,
"type": 0
},
"screenBrightness": -1,
"screenHDR": {
"ambientLight": 30,
"hdrEn": 0,
"hdrMode": 1,
"lowGray": 15,
"modeFlag": 4,
"peakLight": 1000
},
"screenId": 0,
"screenLayers": {
"deviceId": 0,
"screenId": 0,
"screenLayers": [
{
"audioStatus": {
"isAvailable": 0,
"isOpen": 0
},
"deviceId": 0,
"general": {
"flipType": 0,
"isBackground": false,
"isFreeze": false,
"layerId": 2,
"lock": 0,
"name": "图层 3",
"sizeType": 0,
"type": 1,
"zorder": 1
},
"isExceedingLimit": false,
"layerId": 2,
"reverseControl": {
"ip": "",
"port": 18986
},
"screenId": 0,
"source": {
"channelId": 65535,
"channelNum": 1,
"connectCapacity": 0,
"cropId": 255,
"decodeId": 255,
"decodeMode": 255,
"functionType": 0,
"hardwareType": 0,
"inputId": 10,
"interfaceType": 27,
"intfCapacity": 255,
"modelId": 31504,
"montageId": 0,
"name": "input 3-4-1",
"originalCropId": 0,
"originalInputId": 0,
"pullId": 65535,
"slotId": 2,
"sourceId": 0,
"sourceType": 1,
"streamId": 65535,
"streamIndex": 0,
"templateId": 65535,
"videoMode": 255
},
"window": {
"height": 1080,
"lockRatio": 0,
"width": 960,
"x": 3245,
"y": 1115
}
},
{
"audioStatus": {
"isAvailable": 0,
"isOpen": 0
},
"deviceId": 0,
"general": {
"flipType": 0,
"isBackground": false,
"isFreeze": false,
"layerId": 0,
"lock": 0,
"name": "图层 1",
"sizeType": 0,
"type": 1,
"zorder": 0
},
"isExceedingLimit": false,
"layerId": 0,
"reverseControl": {
"ip": "",
"port": 18986
},
"screenId": 0,
"source": {
"channelId": 65535,
"channelNum": 1,
"connectCapacity": 0,
"cropId": 255,
"decodeId": 255,
"decodeMode": 255,
"functionType": 0,
"hardwareType": 0,
"inputId": 8,
"interfaceType": 27,
"intfCapacity": 255,
"modelId": 31504,
"montageId": 0,
"name": "input 3-3-1",
"originalCropId": 0,
"originalInputId": 0,
"pullId": 65535,
"slotId": 2,
"sourceId": 0,
"sourceType": 1,
"streamId": 65535,
"streamIndex": 0,
"templateId": 65535,
"videoMode": 255
},
"window": {
"height": 1080,
"lockRatio": 0,
"width": 960,
"x": 2285,
"y": 1115
}
}
]
},
"screenType": 1,
"switchEffect": {
"PlayPGMIndex": 0,
"effectType": 0,
"switchEffect": 0,
"timeline": 4
},
"usedEyeCare": 0,
"usedImageQualityMode": 0
},
"msg": "",
"sign": "",
"status": 0
}修改于 2026-02-03 03:18:46