일반 사항

JSON(JavaScript Object Notation)은 데이터 교환에 이용되는 경량 형식으로, JavaScript 언어의 일부를 기반으로 합니다. 즉, 개체가 JavaScript에서 빌드됩니다.

JSON 소개

JSON은 두 가지 구조를 기반으로 구축되었습니다.

• 이름/값 쌍의 컬렉션: 다양한 언어에서 개체, 레코드, 구조체, 사전, 해시 테이블, 키 지정 목록 또는 연관 배열로 구현됩니다.
• 정렬된 값 목록: 대부분의 언어에서 배열, 벡터, 목록 또는 시퀀스로 구현됩니다.

다음은 JSON 데이터의 예입니다.

{
     "firstName": "John",
     "lastName": "Smith",
     "address": {
         "streetAddress": "21 2nd Street",
         "city": "New York",
         "state": "NY",
         "postalCode": 10021
     },
     "phoneNumbers": [
         "212 555-1234",
         "646 555-4567"
     ]
 }

JSON이 이벤트 마스터 프로세서와 상호 작용하는 방식

JSON은 JSON RPC(REST 기반)를 사용하여 E2, S3-4K 및 EX와 같은 이벤트 마스터 프로세서와 상호 작용합니다. JSON-RPC는 JSON에 인코딩된 원격 프로시저 호출 프로토콜입니다.

JSON-RPC는 이 프로토콜을 구현하는 서버로 요청을 보내는 방식으로 작동합니다. 이 경우 클라이언트는 일반적으로 원격 시스템의 단일 메서드를 호출하는 소프트웨어입니다. 다중 입력 매개 변수를 배열 또는 개체로 원격 메서드에 전달할 수 있지만 메서드 자체는 여러 출력 데이터를 반환할 수도 있습니다.

이벤트 마스터 프로세서에서 작업을 수행하도록 정의된 JSON RPC가 있습니다. 사용자는 응용 프로그램 또는 오픈 소스 응용 프로그램을 통해 JSON 요청을 보내야 합니다.

이러한 응용 프로그램은 이벤트 마스터 프로세서가 실행 중인 IP와 고정 포트 9999(이벤트 마스터 프로세서의 웹 서버가 포트 9999에서 실행되고 있음)에서 요청을 보내야 합니다.

웹 응용 프로그램에서 JSON 사용

웹 응용 프로그램에서 JSON API를 사용하려면 메뉴 탐색 표시줄에서 설정 아이콘을 선택하고 웹 앱 대시보드에서 JSONRPC API를 선택합니다.

JSON API

다음은 이벤트 마스터 프로세서를 제어하기 위해 정의된 몇 가지 JSON API입니다. 마스터/슬레이브 이벤트 마스터 설정이 있는 경우, JSON을 마스터 장치로 전송해야 합니다. 모든 요청에 대해 이 섹션에서는 RPC 호출에 전달되거나 사용되는 매개 변수를 설명합니다. params 개체가 비어 있으면 API에 매개 변수가 필요하지 않음을 의미합니다.

참고: 요청은 대소문자를 구분합니다.

allTrans

• 정의:

  • "allTrans" 명령을 실행합니다.

• 요청:

  • 매개 변수: {} - 매개 변수가 필요하지 않습니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{}, "method":"allTrans", "id":"1234", "jsonrpc":"2.0"}

cut

• 정의:

  • "Cut" 명령을 실행합니다.

• 요청:

  • 매개 변수: {} - 매개 변수가 필요하지 않습니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{}, "method":"cut", "id":"1234", "jsonrpc":"2.0"}

resetFrameSettings

• 정의:

  • 다른 옵션으로 이벤트 마스터 프로세서의 모든 재설정 유형을 노출합니다.

• 요청:

  • 매개 변수: {"reset":x},

    "x"는 0 – 5일 수 있습니다

    • 0: 소프트 리셋
    • 1: 공장 초기 설정
    • 2: 공장 초기 설정(IP 저장)
    • 3: 공장 초기 설정(IP/EDID 저장)
    • 4: 공장 초기 설정(VPID 저장).
    • 5: 전원 끄기.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{"reset": 0}, "method":"resetFrameSettings", "id":"1234", "jsonrpc":"2.0"}

powerStatus

• 정의:

  • 이벤트 마스터 프로세서의 전원 플러그 상태를 쿼리합니다. (이벤트 마스터 프로세서에 1개 또는 2개의 전원 슬롯이 있을 수 있습니다.)

• 요청:

  • 매개 변수: {} - 매개 변수가 필요하지 않습니다.

• 응답:

  • 응답: {FrameId1 :{ PwrStatus1, PwrStatus2},{FrameId2 :{ PwrStatus1, PwrStatus2}

    PwrStatus1은 프레임 ID FrameId1, FrameId2를 사용하여 이벤트 마스터 프로세서에서 첫 번째 슬롯의 전원 상태를 제공합니다.

    PwrStatus2는 프레임 ID FrameId1, FrameId2를 사용하여 이벤트 마스터 프로세서에서 두 번째 슬롯의 전원 상태를 제공합니다.

    • 0: 전원 공급 장치 모듈이 없습니다.
    • 1: 전원 공급 장치 모듈이 있지만 전원 케이블이 없습니다.
    • 2: 전원 공급 장치 모듈이 있고 케이블이 연결되어 있지만 DC 전류가 없습니다.
    • 3: 전원 공급 장치 모듈이 있고 모든 것이 정상입니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{}, "method":"powerStatus", "id":"1234", "jsonrpc":"2.0"}

listPresets

• 정의:

  • 특정 대상 또는 시스템에 있는 사전 설정 목록을 쿼리합니다.

• 요청:

  • 매개 변수: {"ScreenDest":x , "AuxDest":x},

    "x"에는 다음이 가능합니다.

    • – 2: 이 유형의 대상은 포함하지 마십시오. (매개 변수로 전달된 경우, 특정 ID보다 우선합니다.)
    • – 1: 무시하십시오(모든 사전 설정). (매개 변수로 전달된 경우, 특정 ID보다 우선합니다.)
    • 0–999: 이 특정 ID 또는 ID 배열이 있는 대상과 함께 사전 설정을 보려는 경우 예: "ScreenDestination":[{"id": 2}, {"id": 3}]

• 응답:

  • 응답: 배열: [{"id": 0, "Name": "Preset3.00", "LockMode": 0, "presetSno":

    3.00}, {"id": 1, "Name": "Preset4.00", "LockMode": 0, "presetSno": 4.00}]

    • 응답에는 사전 설정의 배열이 포함됩니다. 위 응답에는 모든 사전 설정의 ID, 이름, 잠금 모드 사전 설정 일련 번호가 포함됩니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{"ScreenDest": 0}, "method":"listPresets", "id":"1234", "jsonrpc":"2.0"}

listDestinationsForPreset

• 정의:

  • 사전 설정의 내용을 나열합니다.

• 요청:

  • 매개 변수: {"id":x },

    "x"에는 다음이 가능합니다.

    • – 1: 모든 사전 설정을 나열합니다.
    • 0–999: 특정 사전 설정만 나열합니다.

• 응답:

  • 응답: 배열: [{"id": 0, "Name": "Preset3.00", "LockMode": 0, "presetSno":

    3.00, "ScreenDest":[{"id": 0}, {"id": 3}],"AuxDest":[{"id": 0},

    {"id": 1}]}]

    • 응답에는 사전 설정의 배열이 포함됩니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • { "params":{"id": 0}, "method":"listDestinationsForPreset", "id":"1234",

    "jsonrpc":"2.0"}

savePreset

• 정의:

  • 이벤트 마스터 프로세서에 사전 설정을 생성합니다.

• 요청:

  • 매개 변수: {"presetName": "NewPreset", "ScreenDestination":[{"id": 2}, {"id": 3}],

    "AuxDestination":[{"id": 1}, {"id": 2}]}

    • "presetName"—저장할 사전 설정의 이름입니다.
    • ScreenDestinations—사전 설정을 생성할 ScreenDest ID입니다.
    • AuxDestinations - 사전 설정을 생성할 Auxest ID입니다.
    • ScreenDestination, AuxDestinations는 선택적 매개 변수입니다. 사용자가 제공하지 않은 경우, 사전 설정이 선택한 대상에 대해 저장됩니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"presetName": "NewPreset"}, "method":"savePreset", "id":"1234",

    "jsonrpc":"2.0"}

  • {"params": {"presetName": "NewPreset", "ScreenDestination":

    {"id": 0},"AuxDestination":{"id": 0}}, "method":"savePreset", "id":"1234",

    "jsonrpc":"2.0"}

  이름 바꾸기, 활성화 및 삭제에 대해 동일한 사전 설정과 관련된 핵심 사항:

  • "id"—사전 설정의 ID입니다.

  • "presetSno"—사전 설정의 일련 번호입니다. 필요한 경우 사용자가 부동 소수점 숫자를 제공할 수 있습니다. 예: "presetSno": 1.01, "presetSno": 1.00, "presetSno": 1, "presetSno": 1.1, "presetSno": 1.10.

    1.1과 1.10 또는 1.00과 1은 동일합니다.

  • "presetName"—사전 설정의 이름입니다.

renamePreset

• 정의:

  • 이벤트 마스터 프로세서에서 사전 설정의 이름을 바꿉니다. 사용자는 사전 설정의 이름을 ID, 사전 설정 일련 번호 또는 사전 설정 이름으로 바꿀 수 있습니다.
  • 매개 변수 중 하나를 전송하여 사전 설정의 이름을 변경합니다.

• 요청 매개 변수:

  • 매개 변수: {"id": x, "newPresetName": "NewPresetName"}
  • 매개 변수: {"presetSno": x.y, "newPresetName": "NewPresetName"}

  • 매개 변수: {"presetName": "OldPresetName", "newPresetName": "NewPresetName"}

    • "newPresetName"—설정할 새 사전 설정의 이름입니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 0, "newPresetName": " newPresetName "},

    "method":"renamePreset", "id":"1234", "jsonrpc":"2.0"}

  • {"params": {"presetName": "NewPreset", "newPresetName": "NewPresetName"},

    "method":"renamePreset", "id":"1234", "jsonrpc":"2.0"}

  • {"params": {"presetSno": 1.00, "newPresetName": " newPresetName "},

    "method":"renamePreset", "id":"1234", "jsonrpc":"2.0"}

activatePreset

• 정의:

  • 이벤트 마스터 프로세서에서 사전 설정을 호출합니다. 사용자는 ID, 사전 설정 일련 번호 또는 사전 설정 이름으로 사전 설정을 호출할 수 있습니다.
  • 매개 변수 중 하나를 전송하여 사전 설정을 호출합니다.

• 요청 매개 변수:

  • 매개 변수: {"id": x, "type": x}
  • 매개 변수: {"presetSno": x.y, "type": x}

  • 매개 변수: {"presetName": "PresetName"}

    • "type"—미리 보기에서 호출하려면 0(기본값), 프로그램에서 호출하려면 1입니다.

      이것은 필수 매개 변수는 아니지만 사용자가 프로그램에서 사전 설정을 호출하려는 경우 지정해야 합니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 0, "type": 0}, "method":"activatePreset",

    "id":"1234", "jsonrpc":"2.0"} //Recall in preview with id 0.

  • {"params": {"presetName": "abc" }, "method":"activatePreset",

    "id":"1234", "jsonrpc":"2.0"} //Recall in preview with preset name "abc".

  • {"params": {"presetSno": 1.00, "type": 1}, "method":"activatePreset",

    "id":"1234", "jsonrpc":"2.0"} //Recall in program with presetSno 1.

recallNextPreset

• 정의:

  • 이벤트 마스터 프로세서에서 다음 사전 설정을 호출합니다.

    매개 변수가 필요하지 않습니다.

  • 사용자가 적어도 하나 이상의 사전 설정을 호출했는지 확인합니다. 웹 앱은 호출된 마지막 사전 설정에서 다음 사전 설정을 호출합니다.

• 요청:

  • 매개 변수: {}

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)
  • 마지막으로 호출된 사전 설정이 없거나 목록에 다음 사전 설정이 없는 경우 오류가 표시됩니다.

• 예:

  • {"params": {}, "method":"recallNextPreset", "id":"1234", "jsonrpc":"2.0"}

deletePreset

• 정의:

  • 이벤트 마스터 프로세서에서 사전 설정을 삭제합니다.

    사용자는 ID, 사전 설정 일련 번호 또는 사전 설정 이름과 함께 사전 설정을 삭제할 수 있습니다.

  • 매개 변수 중 하나를 전송하여 사전 설정을 삭제합니다.

• 요청:

  • 매개 변수: {"id": x}
  • 매개 변수: {"presetSno": x.y}
  • 매개 변수: {"presetName": "PresetName"}

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 1}, "method":"deletePreset", "id":"1234", "jsonrpc":"2.0"}
  • {"params": {"presetSno": 1.00}, "method":"deletePreset", "id":"1234", "jsonrpc":"2.0"}

  • {"params": {"presetName": "Preset 5.00"}, "method":"deletePreset",

    "id":"1234", "jsonrpc":"2.0"}

listDestinations

• 정의:

  • 이 API는 계층, 출력, ID, 크기, 이름 등의 속성을 가진 모든 대상을 나열합니다.

• 요청:

  • 매개 변수: {"type": x}

    • 0—모든 대상을 표시합니다.

      형식 매개 변수의 기본값은 0입니다.

    • 1—화면 대상만 해당합니다.
    • 2—보조 대상만 해당합니다.

• 응답:

  • 응답: 배열: {"ScreenDestination":[{"id": 0, "Name": "Dest1", "HSize": 3840,

    "VSize": 1080, "Layers": 1,"DestOutMapColl":[{"id": 0"DestOutMap":[{"id":

    0, "Name": "Out1", "HPos": 0, "VPos": 0, "HSize": 1920, "VSize":1080,

    "Freeze": 0},{"id": 1, "Name": "Out2", "HPos": 1920, "VPos": 0,

    "HSize": 1920, "VSize":1080, "Freeze": 1}]}]}],"AuxDestination":

    [{"id": 0, "AuxStreamMode": 4}, {"id": 1, "AuxStreamMode": 4}]}"

  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"type": 0}, "method":"listDestinations", "id":"1234", "jsonrpc":"2.0"}

listSources

• 정의:

  • 이 API는 모든 입력 소스를 속성과 함께 나열합니다.

• 요청:

  • 매개 변수: {"type": x}

    • 0—모든 입력 소스를 표시합니다.

      형식 매개 변수의 기본값은 0입니다.

    • 1—배경 소스만

• 응답:

  • 응답: 배열: {"id": 0, "Name": "InSource1", "HSize": 3840, "VSize": 1080,

    "SrcType": 0, "InputCfgIndex": -1, "StillIndex": 0, "DestIndex": -1,

    "UserKeyIndex": -1, "Mode3D": 0, "Freeze": 1, "Capacity": 2,

    "InputCfgVideoStatus": 4}

    SRC 유형: 0 = 입력, 1 = StillStore

    InputCfgVideoStatus: 입력 비디오 상태

    • 0 = 유효하지 않음, 동기화되었지만 획득/잠글 수 없음
    • 1 = 유효함, 비디오 정상
    • 2 = MismatchFormat, 입력 cfg와 커넥터 간 형식 불일치
    • 3 = OutOfRange, 커넥터 용량이 너무 낮아 형식 가져올 수 없음
    • 4 = NoSync, 비디오 없음
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"type": 0}, "method":"listSources", "id":"1234", "jsonrpc":"2.0"}

listContent

• 정의:

  • 이 API는 화면 대상의 콘텐츠를 보여줍니다.

• 요청:

  • 매개 변수: {"id": x}

    • "id"—스크린 대상 인덱스입니다.

• 응답:

  • 응답: { "id": 0, "Name": "ScreenDest1""BGLyr":[{"id": 0, "LastBGSourceIndex":

    0, "BGShowMatte":0, "BGColor":[{"id":0, "Red":0, "Green":0, "Blue":0}]},

    {"id": 1, "LastBGSourceIndex": 0, "BGShowMatte":0, "BGColor":[{"id":0,

    "Red":0, "Green":0, "Blue":0}]}],(0 = PGM Background, 1 = PVW Background)

    "Layers":[{"id": 0, "LastSrcIdx": 0, "HPos": 0, "VPos": 0, "HSize": 400,

    "VSize": 300, "PvwMode": 0, "PgmMode": 0, "Freeze": 0, "FlexZOrder":

    0,"LayerTrans":[{"id": 0, "TransTime": 30, "TransPos": 0}, {"id": 1,

    "TransTime": 30, "TransPos": 0}] , "3D": "Yes", "Freeze": 0, "Capacity":

    2}]}]}

    • id—화면 대상의 인덱스입니다.
    • Name—ScreenDestination의 이름입니다.

    • BGLyr—배경 계층 인덱스, 배경의 마지막 소스 인덱스입니다.

      "id":0은 프로그램의 배경에 영향을 줍니다. "id":1은 미리 보기의 배경에 영향을 줍니다.

    • LastBGSoureIndex — 배경을 드롭하지 않은 경우 -1이고, 삭제한 경우 스크린 대상에 마지막으로 드롭한 배경의 인덱스입니다.
    • BGShowMatte—BG가 매트인지 여부를 나타냅니다.
    • BGColor—배경색입니다.
    • Layers—화면 대상의 계층을 해당 속성과 함께 나열합니다.
    • Transition—화면 대상의 이 속성에는 전환 시간이 포함됩니다(미리 보기에서 프로그램으로 이동하는 데 걸리는 시간).
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 0}, "method":"listContent", "id":"1234", "jsonrpc":"2.0"}

activateCue

• 정의:

  • 이 API는 큐를 재생/일시 중지/중지하는 옵션을 제공합니다.
  • 사용자는 ID, 일련 번호 또는 이름으로 큐를 호출할 수 있습니다.

• 요청:

  • 매개 변수: {"id": 1, "type": x}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"}

    • id – 큐의 인덱스입니다.
    • type – (기본값은 재생임). "x"의 가능한 값: 0 — 재생. 형식 매개 변수의 기본값은 0입니다. 1 — 일시 중지, 2 – 중지
  • 매개 변수: {"cueName": "Cue1", "type": x}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"}
  • 매개 변수: {"cueSerialNo": 1.00, "type": x}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"}

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 1}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"} //Play – no parame or type 0
  • {"params": {"type": 1}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"} //Pause – type 1
  • {"params": {"type": 2}, "method":"activateCue", "id":"1234", "jsonrpc":"2.0"} //Stop – type 2

activateDestGroup

• 정의:

  • 이벤트 마스터 프로세서에서 DestGroup을 호출합니다. 사용자는 ID, DestGroup 일련 번호 또는 DestGroup 이름으로 DestGroup을 호출할 수 있습니다.
  • 매개 변수 중 하나를 전송하여 DestGroup을 호출합니다.

• 요청:

  • 매개 변수: {"id": x}
  • 매개 변수: {"destGrpSno": x.y}
  • 매개 변수: {"destGrName": "GroupName"}

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 0}, "method":"activateDestGroup", "id":"1234", "jsonrpc":"2.0"}
  • {"params": {"destGrpName": "abc" }, "method":"activateDestGroup", "id":"1234", "jsonrpc":"2.0"}
  • {"params": {"destGrpSno": 1.00}, "method":"activateDestGroup", "id":"1234", "jsonrpc":"2.0"}

listCues

• 정의:

  • 이 API에는 모든 큐가 나열됩니다.

• 요청:

  • 매개 변수: {}, "method":"listCues", "id":"1234", "jsonrpc":"2.0"}

• 응답:

  • 응답: 큐 개체의 배열입니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {}, "method":"listCues", "id":"1234", "jsonrpc":"2.0"}

3dControl

• 정의:

  • 이 API는 3D 컨트롤을 수정하는 옵션을 제공합니다.

• 요청:

  • 매개 변수: {"id" : id, "type": x, "syncSource": y, "syncInvert": z}

    • id — 입력 구성의 인덱스입니다.
    • type — "x"는 다음과 같을 수 있습니다: 0 — 유형 꺼짐. 형식 매개 변수의 기본값은 0입니다. 1 — 유형 시퀀스
    • syncSource — "y"는 다음과 같을 수 있습니다: mini-Din 1, 2 – mini-Din 2, 3 – mini-Din 3, 4 – mini-Din 4. 기본값은 1입니다.
    • syncInvert — "z"는 다음과 같을 수 있습니다: 0 — 입력 꺼짐. 0은 syncInvert의 기본값입니다. 1 — 유형 역전.
    • 재설정하려면 "id"를 제외한 다른 매개 변수를 제공하지 마십시오.

• 응답:

  • 응답: {"id": 0, "Name": "InSource1", "HSize": 3840, "VSize": 1080,

    "Src-Type": 0, "InputCfgIndex": -1, "StillIndex": 0, "DestIndex": -1,

    "UserKeyIndex": -1, "Mode3D": 0, "Freeze": 1, "Capacity": 2,

    "InputCfgVideoStatus": 4}

  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 1, "type": 0, "syncSource": 1, "syncInvert": 0},

    "method":"3dControl", "id":"1234", "jsonrpc":"2.0"}

changeContent

• 정의:

  • 이 API는 배경 및 여기에 있는 계층을 넣어 화면 대상의 콘텐츠를 변경합니다.

• 요청:

  • 매개 변수: {"id":0,"BGLyr":[{"id":0,"LastBGSourceIndex":0,"BGShowMatte":0,

    "BGColor":[{"id":0,"Red":0,"Green":0,"Blue":0}]},{"id":1,

    "LastBGSourceIndex":0,"BGShowMatte":0,"BGColor":

    [{"id":0,"Red":0,"Green":0,"Blue":0}]}],"Layers":

    [{"id":0,"LastSrcIdx":0,"Window":{"HPos":0,"VPos":0,"HSize":400,"VSize":300},

    "Source":{"HPos":0,"VPos":0,"HSize":1920,"VSize":1080}, "Mask":

    { "Left":0.01, "Right":10.1, "Top":0.0,"Bottom":0.0},"PvwMode":1,"PgmMode":0,

    "Freeze":0,"PgmZOrder":0,"PvwZOrder":0}]}

    • id—스크린 대상의 인덱스입니다.

    • BGLyr—배경 계층 인덱스, 배경의 마지막 소스 인덱스입니다.

      "id":0은 프로그램의 배경에 영향을 줍니다. "id":1은 미리 보기의 배경에 영향을 줍니다.

    • Layers—레이어 정보.
    • Window—레이어 창 크기.
    • Source—소스 정보 및 크기.
    • Mask—레이어의 보이는 부분을 자릅니다.
    • PvwMode—콘텐츠를 미리 보려면 1을 설정합니다. (기본값)
    • PgmMode—프로그램에 콘텐츠를 포함하려면 1을 설정합니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{"id":0,"BGLyr":[{"id":0,"LastBGSourceIndex":0,"BGShowMatte":0,

    "BGColor":[{"id":0,"Red":0,"Green":0,"Blue":0}]},{"id":1,

    "LastBGSourceIndex":0,"BGShowMatte":0,"BGColor":[{"id":0,"Red":0,

    "Green":0,"Blue":0}]}],"Layers":[{"id":0,"LastSrcIdx":0,

    "Window":{"HPos":0,"VPos":0,"HSize":400,"VSize":300},

    "Source":{"HPos":0,"VPos":0,"HSize":1920,"VSize":1080},

    "Mask":{ "Left":0.01, "Right":10.1, "Top":0.0,"Bottom":0.0},

    "PvwMode":1,"PgmMode":0,"Freeze":0,"PgmZOrder":0,"PvwZOrder":0}]},

    "method":"changeContent", "id":"1234", "jsonrpc":"2.0"}.

  • {"params":{"id":0, "TestPattern" :5 }, "method":"changeContent", "id":"1234", "jsonrpc":"2.0"}

freezeDestSource

• 정의:

  • 이 API는 소스를 고정/고정 해제합니다.

• 요청:

  • 매개 변수: {"type": x, "id": y, "screengroup": z ,"mode": 0/1}

    type—소스 유형

    • 0—입력 소스.
    • 1—배경 소스.
    • 2—ScreenDestination.
    • 3—AuxDestination.
  • id—소스의 인덱스입니다.
  • Screengroup—향후 예비용. 항상 0으로 설정하십시오.
  • Mode—0: 고정 해제, 1: 고정.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"type": 0, "id": 0, "screengroup": 0 ,"mode": 1},

    "method":"freezeDestSource", "id":"1234", "jsonrpc":"2.0"}

listStill

• 정의:

  • 이 API는 id, Name, H/V size, LockMode, StillState, PngState, File size와 같은 속성을 가진 모든 스틸 이미지를 나열합니다.

• 요청:

  • 매개 변수: {}

• 응답:

  • 응답: 배열: [{"id":0,"Name":"StillStore1",

    "LockMode":0,"HSize":{"Min":0,"Max":99999,"$t":1920},"VSize":{"Min":0,

    "Max":99999,"$t":1080},"StillState":{"Min":0,"Max":4,"$t":3},"PngState":

    {"Min":0,"Max":2,"$t":0},"FileSize":{"Min":0,"Max":100000,"$t":9331.2}}]

    • id—스틸 이미지 저장소의 인덱스입니다.
    • Name—스틸 이미지 저장소의 이름입니다.
    • LockMode—향후 사용하기 위한 용도입니다. 항상 0으로 설정하십시오.
    • H/V size—수평 및 수직 크기, 최소, 최대 및 현재 값 현재 값을 표시합니다.
    • StillState—스틸 이미지가 현재 캡처 중인지 여부, 또는 삭제 중인지 여부를 사용자에게 알려줍니다.
    • PngState—스틸 이미지의 "PNG"는 스틸 이미지에 대해 캡처하는 축소판 그림 용도입니다.
    • FileSize—생성되는 파일의 크기(KB)입니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {}, "method":"listStill", "id":"1234", "jsonrpc":"2.0"}

deleteStill

• 정의:

  • 이 API는 스틸 이미지를 삭제합니다.

• 요청:

  • 매개 변수: {"id": x}

    • id—스틸 이미지의 인덱스입니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{"id": 0}, "method":"deleteStill", "id":"1234", "jsonrpc":"2.0"}

takeStill

• 정의:

  • 이 API는 스틸 이미지를 생성/덮어씁니다.

• 요청:

  • 매개 변수: { "type": x, "id": y, "file": z}

    • type—입력 소스의 경우 0, BG 소스의 경우 1입니다.
    • Id—소스의 인덱스입니다. 대상의 소스 ID가 제공된 경우 스틸 이미지가 생성되지 않고 오류가 표시됩니다.
    • File—스틸 이미지 파일 ID입니다. "file" : 5를 전달하면 StillStore6이 만들어집니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{"type":0 , "id": 1, "file": 5}, "method":"takeStill", "id":"1234",

    "jsonrpc":"2.0"}

    • 입력 소스 ID 1에서 StillStore6으로 스틸 이미지가 만들어집니다.

getFrameSettings

• 정의:

  • 이 API는 모든 프레임 정보를 포함한 시스템 정보를 표시합니다.

• 요청:

  • 매개 변수: {}

• 응답:

  • {"System":{"id":0,"Name":"System1","FrameCollection":{"id":0,"Frame":

    {"id":"00:0c:29:0e:86:d4","Name":"E2","Contact":"","Version":"4.2.30738",

    "OSVersion":"NA","FrameType":0,"FrameTypeName":"E2","Enet":{"DhcpMode":0,

    "DhcpModeName":"Static","IP":"10.98.0.165","StaticIP":"192.168.000.175",

    "MacAddress":"00:0c:29:0e:86:d4","StaticMask":"255.255.255.000",

    "StaticGateway":"192.168.000.001"},"SysCard":{"SlotState":2,

    "CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":80,

    "CardTypeLabel":"System","CardID":0},"Slot":[{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":70,"CardTypeLabel":"Expansion",

    "CardID":"thisissometextforid0"}},{"Card":{"CardStatusID":2,"CardStatusLabel":

    "Ready","CardTypeID":70,"CardTypeLabel":"Expansion","CardID":

    "thisissometextforid1"}},{"Card":{"CardStatusID":0,"CardStatusLabel":

    "Not Installed","CardTypeID":255,"CardTypeLabel":"Unknown","CardID":

    "Undefined"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":1,"CardTypeLabel":"SDI Input","CardID":"thisissometextforid211"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":3,"CardID":

    "thisissometextforid2"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":0,"CardTypeLabel":"DVI Input","CardID":"thisissometextforid4"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":2,

    "CardTypeLabel":"HDMI/DP Input","CardID":"thisissometextforid5"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":2,

    "CardTypeLabel":"HDMI/DP Input","CardID":"thisissometextforid7"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":2,

    "CardTypeLabel":"HDMI/DP Input","CardID":"thisissometextforid8"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":2,

    "CardTypeLabel":"HDMI/DP Input","CardID":"thisissometextforid9"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":22,

    "CardTypeLabel":"HDMI Output","CardID":"CardID3"}},{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":22,"CardTypeLabel":"HDMI Output",

    "CardID":"CardID4"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":21,"CardTypeLabel":"SDI Output","CardID":"CardID415"}},

    {"Card":{"CardStatusID":2,"CardStatusLabel":"Ready","CardTypeID":40,

    "CardTypeLabel":"MVR","CardID":"CardID15"}},{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":50,"CardTypeLabel":"VPU Scaler",

    "CardID":"thisissometextforid501"}},{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":50,"CardTypeLabel":"VPU Scaler",

    "CardID":"thisissometextforid502"}},{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":50,"CardTypeLabel":"VPU Scaler",

    "CardID":"thisissometextforid503"}},{"Card":{"CardStatusID":2,

    "CardStatusLabel":"Ready","CardTypeID":50,"CardTypeLabel":"VPU Scaler",

    "CardID":"thisissometextforid504"}},{"Card":{"CardStatusID":0,

    "CardStatusLabel":"Not Installed","CardTypeID":255,"CardTypeLabel":

    "Unknown","CardID":"Undefined"}},{"Card":{"CardStatusID":2,"CardStatusLabel":

    "Ready","CardTypeID":50,"CardTypeLabel":"VPU Scaler","CardID":

    "thisissometextforid505"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":50,"CardTypeLabel":"VPU Scaler","CardID":

    "thisissometextforid506"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":50,"CardTypeLabel":"VPU Scaler","CardID":

    "thisissometextforid507"}},{"Card":{"CardStatusID":2,"CardStatusLabel":"Ready",

    "CardTypeID":50,"CardTypeLabel":"VPU Scaler","CardID":

    "thisissometextforid508"}}]}}}}}

    • System—시스템 이름 및 인덱스입니다.
    • FrameCollection—프레임 정보가 포함된 시스템의 프레임 컬렉션입니다.
    • Frame—프레임 정보를 포함합니다.
    • Id—프레임의 Mac ID입니다.
    • Name—프레임의 이름입니다.
    • Contact—연락처 정보입니다.
    • Version—프레임에 설치된 소프트웨어의 현재 버전입니다.
    • OSVersion—프레임에 설치된 현재 OS 버전입니다.
    • FrameType—0: E2, 1:S3, 2: Ex.
    • FrameTypeName—프레임 유형: E2/S3/Ex.
    • Enet—이더넷 설정입니다.
    • SysCard—시스템 카드 정보입니다.
    • Slot—입력/출력/확장 카드 정보 목록입니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params":{}, "method":"getFrameSettings", "id":"1234", "jsonrpc":"2.0"}

listAuxContent

• 정의:

  • 이 API는 보조 대상 정보를 표시합니다.

• 요청:

  • 매개 변수: {"id" : x}

    • id—보조 대상의 인덱스입니다.

• 응답:

  • 응답: {"id":0,"Name":"AuxDest1","PvwLastSrcIndex":0,"PgmLastSrcIndex":0}

    • id—보조 대상의 인덱스입니다.
    • Name—보조 대상의 이름
    • PvwLastSrcIndex—미리 보기 영역의 입력/배경 소스 인덱스입니다.
    • PgmLastSrcIndex—프로그램 영역의 입력/배경 소스 인덱스입니다.
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id": 0}, "method":"listAuxContent", "id":"1234", "jsonrpc":"2.0"}

changeAuxContent

• 정의:

  • 이 API는 보조 대상의 소스를 변경합니다.

• 요청:

  • 매개 변수: {"id":x , "Name": "AuxDest1" , "PvwLastSrcIndex": y , "PgmLastSrcIndex": z}

    • id—보조 대상의 인덱스입니다.
    • Name—보조 대상의 이름 (선택적 매개 변수)
    • PvwLastSrcIndex—미리 보기 영역의 보조 대상에 설정할 입력/배경 소스 인덱스입니다.
    • PgmLastSrcIndex—프로그램 영역의 보조 대상에 설정할 입력/배경 소스 인덱스입니다.

• 응답:

  • 응답: null
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"id":0 , "Name": "AuxDest1" , "PvwLastSrcIndex": 6 ,

    "PgmLastSrcIndex": 1}, "method":"changeAuxContent", "id":"1234", "jsonrpc":"2.0"}

  • {"params":{"id":0, "TestPattern" :3 }, "method":"changeAuxContent", "id":"1234", "jsonrpc":"2.0"}

구독 및 구독 해제

JSON 기반 응용 프로그램에서 구독을 수행하면 사용자가 구독한 변경 사항이 있을 때 응용 프로그램이 실행 중인 IP 포트로 알림이 전송됩니다.

실제 알림은 다음 구조를 가진 HTTP 게시물로 비동기적으로 전송됩니다: {result: {method:

"notification",notificationType: "ScreenDestChanged",change: { add: [2],

remove: [], update: [0, 1, 2] }}}.

변경 필드에는 추가/제거 또는 업데이트된 화면의 XmlId가 포함됩니다.

참고: 이벤트 마스터 프로세서를 다시 시작하면 모든 구독이 손실되며 필요한 경우 다시 구독해야 합니다.

subscribe

• 정의:

  • 사용자는 이 API를 사용하여 이벤트 마스터 프로세서의 변경 이벤트를 구독할 수 있습니다.
  • 구독하면 API가 HTTP 게시물의 형태로 Url: http://hostname:port/에 알림을 보냅니다.

• 요청:

  • 매개 변수: {"hostname": hostname, "port": port, "notification" : notificationType[]}

    hostname—알림을 보낼 호스트 이름 또는 IP 주소입니다.

    port—알림이 게시되는 TCP 포트입니다.

    notificationTypes—사용자가 구독하려는 알림 배열입니다.

    • ScreenDestChanged
    • AUXDestChanged
    • FrameChanged
    • NativeRateChanged
    • InputCfgChanged
    • SourceChanged
    • BGSourceChanged
    • PresetChanged
    • StillChanged
    • OutputCfgChanged
    • CueChanged

• 응답:

  • 응답: {"method": "subscribe"}
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"hostname" : "192.168.247.131", "port": "3000", "notification" :

    ["ScreenDestChanged", "AUXDestChanged"]}, "method":"subscribe", "id":"1234",

    "jsonrpc":"2.0"}

unsubscribe

• 정의:

  • 사용자는 이 API를 사용하여 지정된 호스트 이름, 포트 및 알림 유형에 대한 구독을 제거할 수 있습니다.

• 요청:

  • 매개 변수: {"hostname": hostname, "port": port, "notification" : notificationType[]}

    hostname—구독을 제거할 호스트 이름 또는 IP 주소입니다.

    port—TCP 포트입니다.

    notificationTypes—사용자가 구독하려는 알림 배열입니다.

    • ScreenDestChanged
    • AUXDestChanged
    • FrameChanged
    • NativeRateChanged
    • InputCfgChanged
    • SourceChanged
    • BGSourceChanged
    • PresetChanged
    • StillChanged
    • OutputCfgChanged
    • CueChanged

• 응답:

  • 응답: {"method": "unsubscribe"}
  • 성공: (0=성공, 다른 값은 오류)

• 예:

  • {"params": {"hostname" : "192.168.247.131", "port": "3000", "notification" :

    ["ScreenDestChanged", "AUXDestChanged"]}, "method":"unsubscribe",

    "id":"1234", "jsonrpc":"2.0"}