iPi Automation Add-on

Overview

iPi Integration Add-on allows to control iPi Recorder and iPi Mocap Studio from external application by sending JSON commands via Windows dll. It can be used for:

• Using iPi Recorder and iPi Mocap Studio as a part of third-party solution
• Automation of repeatable tasks
• Automation of custom workflow

Note: iPi Integration Add-on requires separate license key, which you need to activate in iPi Mocap Studio. 30-days free trial provided.

License and Trial

iPi Integration Add-on requires separate license key, which you need to activate in iPi Mocap Studio. You can order your license here, or activate 30-days free trial. Follow the steps below to start working with iPi Integration Add-on

1. Switch to Integration tab.
2. Press Activate button
3. Press Start 30-days Free Trial Period or Enter Integration License Key and follow further on-screen instructions

   

Note: To use iPi Integration Add-on with iPi Recorder, you have to install iPi Mocap Studio on the same computer and activate iPi Integration Add-on following the instructions above.

Command Syntax Reference

Commands are strings based on JSON syntax. The response is also JSON string.

SYNOPSIS

// Request
{
    "command":<command_name_string>,
    ["arguments":<arguments_list_json_string>]
}
 
// Response
{
    "success":true|false,
    ["result":<result_json_string>]
}

iPi Recorder Commands

General Commands

get-app-info

get-app-info command returns the name of application and its version.

SYNOPSIS

// Request
{
    "command":"get-app-info"
}
 
// Response
{
    "success":true|false,
    "result":
    {
        "appName":<application_name_string>,
        "appVersion":<application_version_string>
    }
}

EXAMPLES

// Request
{
    "command":"get-app-info"
}
 
// Response
{
    "success":true,
    "result":
    {
        "appName":"iPi Recorder 3",
        "appVersion":"99.876.543.210"
    }
}

Recording Commands

set-recorder-props

set-recorder-props command sets properties for setup, background and recroding stages.

#	Parameter Name	Type	Required	Allowed Values	Description
Arguments
1.	colorCompression	string	optional	"none" "background compression" "jpeg"	Setting RGB video compression mode
2.	globalDeviceProps	JSON object	optional		Device-specific list of properties visible in “SHARED SETTINGS” section of “SETUP” stage

EXAMPLES

// Request
{
    "command":"set-recorder-props",
    "arguments":
    {
        "colorCompression":"jpeg",
	"globalDeviceProps":
        {
	    "PlayStation Eye: Darkening for calibration":"None"
        },
    "hideBackgroundWhenRecording":true,
    "recordingStartDelay":0,
    "videoMode":"640x480 color @ 50Hz"
    }
}
 
// Response
{
    "success":true
}