H Series OpenAPI Instructions
Home
ChineseVersion
Home
ChineseVersion
  1. Layers
  • Instructions
  • Error Codes
  • Change History
  • Devices
    • Read Device Detailed Information
      POST
    • Read Device Card Information
      POST
    • Read Device IP
      POST
  • Homepage
    • Read System Initialization Status
      POST
    • Read Video Server Address
      POST
  • Screen
    • Set Screen Gamma
      POST
    • Display Screen ID
      POST
    • Set Screen Brightness
      POST
    • Save Screen Brightness
      POST
    • Add Screens
      POST
    • Delete Screens
      POST
    • Read Screen Detailed Information
      POST
    • Query Screen List
      POST
    • Screen FTB
      POST
    • Set BKG
      POST
    • Set Freezing
      POST
    • Read Screen Not in Live Mode
      POST
    • Set 3D Effect
      POST
    • Set Screen Layout Information
      POST
    • Set Image OSD
      POST
    • Set Text OSD
      POST
    • Delete Multiple Screens
      POST
    • Rename Screens
      POST
  • Inputs
    • Read Input List
    • Read Detailed Information of Specified Inputs
    • Set Cropping
    • Delete
    • Edit Cropping
    • Set Resolutions
    • Set Timing
    • Create Input Groups
    • Sort Input Groups
    • Edit Groups
    • Delete Groups
    • Delete Input Sources by Groups
    • Import EDID
    • Rename
    • Create Signal Source Playlists
    • Read Signal Source Playlists
    • Edit Signal Source Playlist Information
    • Enable Signal Source Playlists
    • Delete Signal Source Playlists
  • Outputs
    • Set Image Quality
    • Set Gamma
    • Set Output Locating
    • Rename
    • Set Timing for 4K Output Card
    • Read Detailed Information
    • Read Output List
    • Se Output Timing
    • Set Output Resolutions
    • Set Areas Loaded by All-in-One Cards
  • Layers
    • Set Stream Pulling Rules for IPC Sources Only
      POST
    • Add Layers
      POST
    • Delete Layers
      POST
    • Read Layer List
      POST
    • Read Layer Details
      POST
    • Set Layer Basic Information
      POST
    • Read Layer Z-order
      POST
    • Set Layer Information
      POST
    • Clear Layers
      POST
    • Set Layer Z-order
      POST
    • Lock Layers
      POST
    • Change Layer Source Information
      POST
    • Freeze Layers
      POST
    • Open Layer Layouts
      POST
  • Presets
    • Create Presets
    • Delete Presets
    • Set Basic Information of Specified Presets
    • Load Presets
    • Read Detailed Information of Specified Presets
    • Clear Presets
    • Get Preset Group List
    • Create Preset Groups
    • Delete Preset Groups
    • Get Preset Group Enumeration
    • Play Preset Playlist
    • Read All Presets
    • Read Preset Playlist
    • Read Current Played Preset
    • Edit Preset Groups
    • Overwrite Presets
  • BKG
    • Create BKG
    • Delete BKG
    • Get BKG Detailed Information
    • Comprehensive Query
  • IPC
    • IPC Source List
    • Read Specified Data in IPC Source List
    • IP Camera List
    • Obtain IPC Source Channel List
    • Obtain Details of IPC Source Channel List
    • Details of IPC Mosaic Source Channel Data
    • Add IPC Sources
    • Delete IPC Sources
    • Rename IPC Sources
    • Change IPC Source Channels
    • Add IPC Source Channels
    • Delete IPC Source Channels
    • IPC Source Slot List
    • IPC Sources and Channels
    • Check IPC Source Names
    • IPC Source Group List
    • Create IPC Source Groups
    • Delete IPC Source Groups
    • Change IPC Groups
    • Delete IPC Source Group Nodes
    • IPC Mosaic Source List
    • Create IPC Mosaic Source Templates
    • Update IPC Mosaic Source Templates
    • Delete IPC Mosaic Source Templates
    • Apply IPC Mosaic Source Templates
    • Rename IPC Mosaic Sources
  1. Layers

Add Layers

POST
/open/api/layer/create
"audioStatus": 
    isAvailable: Whether the layer audio is available.
    isOpen: Whether the layer audio is played.

"general": 
  name: Layer name
  isFreeze: Freeze or not
  flipType Flip type (0: Normal, 1: Flip horizontally, 2: Flip vertically, 3: Flip horizontally and vertically)

  isBackground: Whether the layer is set as the screen background.
  sizeType: 0: SL, 1: DL, 2: 4K
  type: Layer type (0: mix, 1: SL, 2: remapping)
  lock: Lock or not

"source":
  sourceType: Source type 
0: No source
1: Common input source type
IPC type: 255 or 3 (Pass 255 if the device version is earlier than V1.9.9.0. Pass either 3 or 255 if the device version is later than V1.9.9.0)
  cropId: Cropping ID (255 means that the original source is used.)
  interfaceType: Interface type
 connectCapacity: Connection capacity
  slotId: Slot ID
  name: Source name
"window":
  width: Width, unit: pixel
  height: Height, unit: pixel
  x: Horizontal initial position, unit: pixel
  y: Vertical initial position, unit: pixel
Use a common input source to open a layer.
{
    "body": {
        "screenId": 0,
        "audioStatus": {
            "isAvailable": 0,
            "isOpen": 0
        },
        "general": {
            "name": "Layer 1",
            "isFreeze": false,
            "flipType": 0,
            "isBackground": false,
            "sizeType": 0,
            "type": 1,
            "lock": 0
},
        "source": {
            "sourceType": 1,
            "inputId": 16,
            "cropId": 255,
            "interfaceType": 6,
            "connectCapacity": 2,
            "slotId": 4,
            "name": "input 5-1"
        },
        "window": {
            "width": 1920,
            "height": 1080,
            "x": 1000,
            "y": 1000
        },
        "deviceId": 0
    },
    "sign": "NTY2YjQ2MDEwMWJlOGU5ZmRmZjA0YTk3YmZhYjYwZmI=",
    "pId": "Mjcx",
  "timeStamp": "1689586062335"
}
Use a signal source playlist to open a layer.
{
    "screenId": 0,
    "audioStatus": {
        "isAvailable": 0,
        "isOpen": 0
    },
    "general": {
        "name": "Layer 1",
        "zorder": 0,
        "isFreeze": false,
        "flipType": 0,
        "isBackground": false,
        "sizeType": 0,
        "type": 1,
        "lock": 0
    },
    "source": {
        "sourceType": 6,
        "sourceId": 0,
        "name": "Signal playlist 1"
    },
    "window": {
        "width": 3840,
        "height": 2160,
       "x": 1000,
        "y": 1000
    },
    "deviceId": 0
}

Request

Body Params application/json

Example
{
    "body": {
        "screenId": 3,
        "deviceId": 0,
        "general": {
            "name": "Layer22",
            "isBackground": false,
            "isFreeze": false,
            "flipType": 1
        },
        "source": {
            "slotId": 0,
            "interfaceType": 0,
            "sourceType": 0,
            "inputId": 0,
            "cropId": 255
        },
        "window": {
            "width": 90,
            "height": 90,
            "x": 1000,
            "y": 1000
        }
    },
    "sign": "MjI0OGYzMGQwMjhlMmI4YTNmMjM2MjE3MjYzYTFkODg=",
    "pId": "1",
    "timeStamp": "1631949094265"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/api/layer/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": {
        "screenId": 3,
        "deviceId": 0,
        "general": {
            "name": "Layer22",
            "isBackground": false,
            "isFreeze": false,
            "flipType": 1
        },
        "source": {
            "slotId": 0,
            "interfaceType": 0,
            "sourceType": 0,
            "inputId": 0,
            "cropId": 255
        },
        "window": {
            "width": 90,
            "height": 90,
            "x": 1000,
            "y": 1000
        }
    },
    "sign": "MjI0OGYzMGQwMjhlMmI4YTNmMjM2MjE3MjYzYTFkODg=",
    "pId": "1",
    "timeStamp": "1631949094265"
}'

Responses

🟢200Successful
application/json
Body

Example
{
    "data": {
        "id": 0
    },
    "msg": "",
    "status": 0
}
Modified at 2025-10-23 10:17:57
Previous
Set Stream Pulling Rules for IPC Sources Only
Next
Delete Layers
Built with