Video Commands

If you are ingesting any live source (SDI, HDMI, NDI, USB, etc.) into Captivate, these video commands will return lists and allow you to manipulate any live source in the switcher.

closeVideoIn

get

Close a video device by named port. NOTE: This call uses "video" as the field name, not "videoIn.".

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

videostringOptional

Name of the video device to open.

Responses
200
successful operation
application/json
get
GET /api/command/closeVideoIn HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "closeVideoIn",
    "reply": "closeVideoIn",
    "success": true
  }
}

getAllVideoIns

get

Returns a list of all video devices available for input.

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

verbosestringOptional

set to 1 for more information

Responses
200
successful operation
application/json
get
GET /api/command/getAllVideoIns HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "getAllVideoIns",
    "count": "23",
    "reply": "getAllVideoIns",
    "success": true,
    "videoIns": [
      "NDI Video"
    ]
  }
}

getOpenedVideoIns

get

Get a list of all opened video devices..

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

Responses
200
successful operation
application/json
get
GET /api/command/getOpenedVideoIns HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "getOpenedVideoIns",
    "reply": "getOpenedVideoIns",
    "success": true,
    "videoIns": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ]
  }
}

getVideoInIcon

get

Retrieve an encoded png of the specified stream in the width and height requested.

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

widthstringRequired

required width in pixels

heightstringRequired

required height in pixels

videostringOptional

The name of the video input to query.

Responses
200
successful operation
application/json
get
GET /api/command/getVideoInIcon HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "getVideoInIcon",
    "error": "missing width or height or video attributes",
    "reply": "getVideoInIcon",
    "success": true
  }
}

getVideoInInfo

get

Returns a set of all video devices available and their status.

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

videoInstringOptional

The name of the video input to query.

Responses
200
successful operation
application/json
get
GET /api/command/getVideoInInfo HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "getVideoInInfo",
    "reply": "getVideoInInfo",
    "success": true,
    "videoIns": [
      {
        "add": "0",
        "audio": "0",
        "config": "BB86C477-373F-49D9-AA4B-CE86A0E883F1",
        "name": "NDI Video",
        "setup": "0",
        "type": "Mac",
        "video": "1"
      }
    ]
  }
}

openVideoIn

get

Open a video device by named port. NOTE: This call uses "video" as the field name, not "videoIn.".

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

videostringOptional

Name of the video device to open.

Responses
200
successful operation
application/json
get
GET /api/command/openVideoIn HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "openVideoIn",
    "reply": "openVideoIn",
    "success": true
  }
}

switchVideoIn

get

Make a specific video device active in the switcher..

Query parameters
requestIdstringOptional

optional id to track this command, will be returned in the response

channelstringOptional

A specific channel index must be specified.

videostringOptional

Name of the video device to open.

Responses
200
successful operation
application/json
get
GET /api/command/switchVideoIn HTTP/1.1
Host: 127.0.0.1:9022
Accept: */*
{
  "result": {
    "command": "switchVideoIn",
    "reply": "switchVideoIn",
    "success": true
  }
}

Last updated