Skip to content

Get a sync device ​

GET /clip/v2/resource/sync/sync_uuid

Get a sync device by UUID to read its current settings and associated synchronization area.

Example response

json
{
  "code": 0,
  "data": {
    "arr": [],
    "obj": {
      "ability": 0,
      "area_id": "",
      "area_name": "",
      "brightness": 0,
      "color_config": 1,
      "color_config_1": [
        {
          "position_x": 0,
          "position_y": 0,
          "x": 39914,
          "y": 20037
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 35106,
          "y": 23392
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 30699,
          "y": 25918
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 26911,
          "y": 28294
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 21508,
          "y": 33694
        }
      ],
      "color_config_2": [
        {
          "position_x": 0,
          "position_y": 0,
          "x": 22549,
          "y": 20601
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 26568,
          "y": 23298
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 18270,
          "y": 21550
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 9864,
          "y": 16510
        }
      ],
      "color_config_3": [
        {
          "position_x": 0,
          "position_y": 0,
          "x": 14023,
          "y": 17723
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 17431,
          "y": 21480
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 20999,
          "y": 26121
        }
      ],
      "color_config_4": [
        {
          "position_x": 0,
          "position_y": 0,
          "x": 9672,
          "y": 6607
        },
        {
          "position_x": 0,
          "position_y": 0,
          "x": 37190,
          "y": 23165
        }
      ],
      "frequency": 0,
      "id": "5075D324-2DE0-4C08-AC1B-FB07B1C447A9",
      "mode": 0,
      "name": "",
      "on": 0,
      "source": 0,
      "stop_action": 0,
      "type": "sync"
    }
  },
  "msg": "success"
}

Responses ​

Status codeMeaning
200OK

Response fields ​

HTTP 200 OK

FieldTypeRequiredDescription
codeintegerYesStatus code
msgstringYesMessage
dataobjectYesResponse payload.
data.objobjectYesReturned resource.
data.obj.idstringYesSync device ID
data.obj.typestringYesAlways sync.
data.obj.namestringYesName
data.obj.abilityintegerYesCapabilities. Reserved.
data.obj.onintegerYesOn/off state. 0: off; 1: on.
data.obj.brightnessintegerYesBrightness, from 1 to 100.
data.obj.sourceintegerYesInput source. 0: HDMI1; 1: HDMI2.
data.obj.modeintegerYesMode. 0: video; 1: music; 2: game.
data.obj.frequencyintegerYesIntensity. 0: low; 1: medium; 2: high; 3: maximum.
data.obj.stop_actionintegerYesStop action. 0 keeps the current state; 2 turns the lights off.
data.obj.color_configintegerYesSelects the active preset: 1 uses color_config_1, 2 uses color_config_2, and so on.
data.obj.color_config_1object[]YesConfiguration 1
data.obj.color_config_1[].xintegerYesX coordinate
data.obj.color_config_1[].yintegerYesY coordinate
data.obj.color_config_2object[]YesConfiguration 2
data.obj.color_config_2[].xintegerYesX coordinate
data.obj.color_config_2[].yintegerYesY coordinate
data.obj.color_config_3object[]YesConfiguration 3
data.obj.color_config_3[].xintegerYesX coordinate
data.obj.color_config_3[].yintegerYesY coordinate
data.obj.color_config_4object[]YesConfiguration 4
data.obj.color_config_4[].xintegerYesX coordinate
data.obj.color_config_4[].yintegerYesY coordinate
data.obj.area_idstringYesID of the associated synchronization area.
data.obj.area_namestringYesName of the associated synchronization area.