PUXELHUE
English
  • 简体中文
  • English
  1. 6. 场景
PUXELHUE
English
  • 简体中文
  • English
  • API使用说明
  • 1 鉴权
    • 1.1 用户登录
      POST
    • 1.2 读取节点公开信息
      GET
  • 2 设备
    • 2.1 读取节点信息
      GET
    • 2.2 执行系统恢复出厂
      PUT
    • 2.3 设置切换特效
      PUT
    • 2.4 设置swap
      PUT
    • 2.5 读取节点监测状态
      GET
  • 3 接口
    • 3.1 读取详细信息列表
      GET
    • 3.2 设置输出定位
      PUT
    • 3.3 设置画质
      PUT
  • 4 屏幕
    • 4.1 获取屏幕信息
      GET
    • 4.2 设置屏幕冻结
      PUT
    • 4.3 设置屏幕ftb
      PUT
    • 4.4 操作屏幕cut
      PUT
    • 4.5 操作屏幕take
      PUT
  • 5 图层
    • 5.1 获取图层完整信息
      GET
    • 5.2 获取图层模板列表
      GET
    • 5.4 设置图层换源信息
      PUT
    • 5.3 应用图层模板
      PUT
    • 5.5 设置图层选中信息
      PUT
  • 6. 场景
    • 6.1 获取场景详细信息列表
      GET
    • 6.2 场景创建
      POST
    • 6.3 单场景应用
      POST
    • 6.4 场景名称修改
      POST
    • 6.5 场景删除
      POST
  • 7 图库
    • 7.1 图片信息列表
  1. 6. 场景

6.3 单场景应用

开发中
POST
/v1/preset/apply

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
presetId
string 
场景guid
可选
serial
integer 
场景坑位
可选
targetRegion
integer 
要应用的区域
必需
2: PGM, 4: PVW, 0:Auto(切换器为 PVW,拼接器、控制器为 PGM)
auxiliary
object 
辅助信息
必需
keyFrame
object 
必需
加载场景时候携带的kf信息
effect
object 
场景播放特效开关
必需
switchEffect
object 
全局切换特效设置
必需
swapEnable
number 
必需
Swap配置【0:swap未启用,1:swap启用;】
screens
array [object {1}] 
可选
场景指定加载的目标屏幕列表
示例
{
    "presetId": "string",
    "serial": 0,
    "targetRegion": 0,
    "auxiliary": {
        "keyFrame": {
            "enable": 0
        },
        "effect": {
            "enable": 0
        },
        "switchEffect": {
            "time": 0,
            "type": 0,
            "wipe": {
                "image": 0,
                "symmetry": 0,
                "posX": 0,
                "posY": 0,
                "frameW": 0,
                "frameS": 0,
                "direction": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "dve": {
                "type": 0,
                "image": 0,
                "brightness": 0,
                "softness": 0,
                "directionDev": 0,
                "directionEffect": "string",
                "keySource": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                },
                "KeySourceReverse": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "stinger": {
                "playStartTime": 0,
                "mixtureTime": 0,
                "mixtureStartTime": 0,
                "matting": 0,
                "brightness": 0,
                "softness": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "dip": {
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            }
        },
        "swapEnable": 0,
        "screens": [
            {
                "guid": "string"
            }
        ]
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://prod-cn.your-api-server.com/v1/preset/apply' \
--header 'Content-Type: application/json' \
--data-raw '{
    "presetId": "string",
    "serial": 0,
    "targetRegion": 0,
    "auxiliary": {
        "keyFrame": {
            "enable": 0
        },
        "effect": {
            "enable": 0
        },
        "switchEffect": {
            "time": 0,
            "type": 0,
            "wipe": {
                "image": 0,
                "symmetry": 0,
                "posX": 0,
                "posY": 0,
                "frameW": 0,
                "frameS": 0,
                "direction": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "dve": {
                "type": 0,
                "image": 0,
                "brightness": 0,
                "softness": 0,
                "directionDev": 0,
                "directionEffect": "string",
                "keySource": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                },
                "KeySourceReverse": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "stinger": {
                "playStartTime": 0,
                "mixtureTime": 0,
                "mixtureStartTime": 0,
                "matting": 0,
                "brightness": 0,
                "softness": 0,
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            },
            "dip": {
                "source": {
                    "general": {
                        "sourceId": 0,
                        "sourceType": 0
                    }
                }
            }
        },
        "swapEnable": 0,
        "screens": [
            {
                "guid": "string"
            }
        ]
    }
}'

返回响应

🟢200成功
application/json
Body
code
number 
响应码
必需
message
string 
响应消息内容
必需
data
object 
必需
示例
{
    "code": 0,
    "message": "string",
    "data": {}
}
修改于 2025-04-22 02:49:34
上一页
6.2 场景创建
下一页
6.4 场景名称修改
Built with