<?php
	$openApiURL = "http://aiopen.etri.re.kr:8000/VideoParse";
	$accessKey = "YOUR_ACCESS_KEY";
	$filePath = "VIDEO_FILE_PATH";

	$uploadfile = file_get_contents($filePath);
	$request = array(
			"argument" => array ()
		);

	try {
		$boundary = uniqid();
		$body = '';
		$eol = "\r\n";
		$delimiter = '-------------'.$boundary;
		$body .= "--".$delimiter.$eol
			.'Content-Disposition: form-data; name="json"'.$eol.$eol
			.json_encode($request).$eol;

		$body .= "--".$delimiter.$eol
			.'Content-Disposition: form-data; name="uploadfile"; filename="'.basename($filePath).'"' . $eol
			.'Content-Transfer-Encoding: binary'.$eol;

		$body .= $eol;
		$body .= $uploadfile.$eol;

		$body .= "--" . $delimiter . "--".$eol;

		$server_output = "";
		$ch = curl_init();

		$header = array(
                               "Content-Type: multipart/form-data; boundary=" . $delimiter,"Authorization":{$accessKey}
                               "Content-Length: " . strlen($body)
		);

		curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
		curl_setopt($ch, CURLOPT_URL, $openApiURL);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
		curl_setopt($ch, CURLOPT_MAXREDIRS, 10);
		curl_setopt($ch, CURLOPT_VERBOSE, true);
		curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $body );

		$server_output = curl_exec ($ch);
		if($server_output === false) {
			echo "Error Number:".curl_errno($ch)."\n";
			echo "Error String:".curl_error($ch)."\n";
		}

		curl_close ($ch);
	} catch ( Exception $e ) {
		echo $e->getMessage ();
	}

	echo "result = " . var_dump($server_output);
?>

JSON parsing을 위해 jsoncpp 라이브러리를 사용하여 제공하고 있습니다. jsoncpp 라이브러리에 대한 자세한 설명은 https://github.com/open-source-parsers/jsoncpp 에서 확인 하실 수 있습니다.

HTTP 통신을 위해 curl 라이브러리를 사용하여 제공하고 있습니다. curl 라이브러리에 대한 자세한 설명은 https://curl.haxx.se/libcurl 에서 확인 하실 수 있습니다.

컴파일을 위해서는 아래와 같이 추가된 LIB에 대한 옵션을 추가해야 합니다.

g++ (c++파일명) (JSONCPP)/json/json.h (JSONCPP)/json/json-forwards.h (JSONCPP)/jsoncpp.cpp -I(CURL)/include -lcurl

#include <curl/curl.h>
#include <json/json.h>
#include <iostream>
#include <string>
#include <memory.h>
#include <fstream>
#include <math.h>
#include <cstdlib>
#include <filesystem>

using namespace std;
namespace fs = std::filesystem;

size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream);

int main() {
	char* openApiURL = (char*)"http://aiopen.etri.re.kr:8000/VideoParse";
	char* videoFilePath = (char*)"VIDEO_FILE_PATH";
	string accessKey = "YOUR_ACCESS_KEY";

	Json::Value request;
	Json::Value argument;

	
	request["argument"] = argument;

	CURL *curl;
	curl_slist* responseHeaders = NULL;
	curl = curl_easy_init();

	if( curl == NULL ) {
	} else {
		string body;
		long bodySize = 0L;

		// read file
		ifstream fl(videoFilePath, ios::binary | ios::ate);
		size_t fileSize = fl.tellg();
		string fileContent(fileSize, '\0');
		fl.seekg(0);
		fl.read(&fileContent[0], fileSize);
		fl.close();

		string CRLF = "\r\n";
		srand((unsigned int)time(NULL));
		string BOUNDARY = std::to_string( rand() );
		string DELIMITER = "-------------" + BOUNDARY;


		body.append("--"+DELIMITER+CRLF);
		body.append("Content-Disposition: form-data; name=\"json\""+CRLF+CRLF);
		body.append(CRLF);
		body.append(request.toStyledString()+CRLF);

		// now we add the file
		string fileName = fs::path(videoFilePath).filename();
		body.append("--"+DELIMITER+CRLF);
		body.append("Content-Disposition: form-data; name=\"uploadfile\"; filename=\""+fileName+"\""+CRLF);
		body.append("Content-Transfer-Encoding: binary"+CRLF+CRLF);

		string bodyEnd = CRLF+"--"+DELIMITER+"--"+CRLF;

		body.append(fileContent);
		body.append(bodyEnd);

		char *bodyChars = &body[0];
		bodySize = strlen(body.c_str()) + fileSize + strlen(bodyEnd.c_str());

                responseHeaders = curl_slist_append(responseHeaders, ("Content-Type: multipart/form-data; boundary="+DELIMITER).c_str());
                responseHeaders = curl_slist_append( responseHeaders , ("Authorization: " + accessKey).c_str() ) ;
		responseHeaders = curl_slist_append(responseHeaders, ("Content-Length: " + to_string(bodySize)).c_str() ) ;

		long statusCode;
		string response;
		
		curl_easy_setopt(curl, CURLOPT_URL, openApiURL);
		curl_easy_setopt(curl, CURLOPT_HTTPHEADER, responseHeaders ) ;
		curl_easy_setopt(curl, CURLOPT_POST, 1);
		curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
		curl_easy_setopt(curl, CURLOPT_MAXREDIRS, 10);
		curl_easy_setopt(curl, CURLOPT_VERBOSE, true);
		curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyChars);
		curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, bodySize);

		curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeDataFunc);
		curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

		curl_easy_perform(curl);

		curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &statusCode);
		curl_easy_cleanup(curl);
		
		cout << "[responseCode] " << statusCode << endl;
		cout << "[responBody]" << endl;
		cout << response << endl;
	}

	return 0;
}

size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream) {
	size_t realsize = size * nmemb;
	string temp(static_cast<const char*>(ptr), realsize);
	stream.append(temp);
	return realsize;
}

python 3.0을 기준으로 작성되었습니다.

HTTP 통신을 위해 urllib3 라이브러리를 사용하여 제공하고 있습니다. Python 3.0 이하의 버전에서 예제를 실행하기 위해서는 별도로 urllib3의 설치가 필요합니다. 설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다.
urllib3 라이브러리에 대한 자세한 설명은 https://urllib3.readthedocs.io/en/latest/ 에서 확인 하실 수 있습니다.

#-*- coding:utf-8 -*-
  import urllib3
  import json
  import os
  
  openApiURL = "http://aiopen.etri.re.kr:8000/VideoParse"
  accessKey = "YOUR_ACCESS_KEY"
  videoFilePath = "VIDEO_FILE_PATH"
  
  file = open(videoFilePath,'rb')
  fileContent = file.read()
  file.close();
  
  requestJson = {	
    "argument": {}
  }
  
  http = urllib3.PoolManager()
  response = http.request(
    "POST",
    openApiURL,
    headers={"Content-Type": "application/json; charset=UTF-8", "Authorization" :  accessKey},
    fields={
      'json': json.dumps(requestJson),
      'uploadfile': (os.path.basename(file.name), fileContent)
    }
  )
  
  print("[responseCode] " + str(response.status))
  print("[responBody]")
  print(response.data)

var fs = require('fs');
var path = require("path");

var openApiURL = 'http://aiopen.etri.re.kr:8000/VideoParse';
var accessKey = 'YOUR_ACCESS_KEY';
var videoFilePath = 'VIDEO_FILE_PATH';
var videoData;

var videoData = fs.readFileSync(videoFilePath);

var requestJson = {
	'argument': {}
};

var BOUNDARY = Math.random() * Date.now();
var DELIMITER = "-------------" + BOUNDARY;
var CRLF = "\r\n";

// request json data
var data = "--" + DELIMITER + CRLF;
data += "Content-Disposition: form-data; name=\"json\""+CRLF+CRLF;
data += JSON.stringify(requestJson)+CRLF;

// request file data
data += "--" + DELIMITER + CRLF;
data += "Content-Disposition: form-data; name=\"uploadfile\"; filename=\""+path.basename(videoFilePath)+"\""+CRLF;
data += "Content-Transfer-Encoding: binary"+CRLF+CRLF

var payload = Buffer.concat([
	new Buffer(data),
	new Buffer(videoData, 'binary'),
	new Buffer(CRLF+"--"+DELIMITER+"--"+CRLF)
]);

var request = require('request');
var options = {
	url: openApiURL,
	body: payload,
	headers: {"Content-Type": "multipart/form-data; boundary=" + DELIMITER,'Authorization':access_key}
};

request.post(options, function (error, response, body) {
	console.log('responseCode = ' + response.statusCode);
	console.log('responseBody = ' + body);
});

장면 분할 API는 동영상의 장면 분할 요청 결과를 JSON 형태의 Text 데이터로 반환합니다.

다음은 정상적인 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:50783
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "request_id": "reserved field",
    "result": 0,
    "return_type": "com.google.gson.internal.LinkedTreeMap",
    "return_object": {
        "file_id": {비디오 파일 파일 ID}
    }
}

다음은 오류가 발생한 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "request_id": "reserved field",
    "result": -1,
    "reason": {오류 메시지}
}

분석된 결과는 다음과 같은 내용이 포함되어 있습니다.

장면 분할 API는 동영상의 장면 분할 분석 결과를 JSON 형태의 Text 데이터로 반환합니다.

다음은 정상적인 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "result": [{
        "num": {처리 번호},
        "code": {결과 코드},
        "msg": {결과 메시지},
        "frame": {구분된 프레임 정보},
        "time": {구분된 시간 정보}
    }]
}

다음은 오류가 발생한 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Respone Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Respone Body]
{
    "request_id": "reserved field",
    "result": -1,
    "reason": {오류 메시지}
}

분석된 결과는 다음과 같은 내용이 포함되어 있습니다.

장면 분할이 제대로 이루어지지 않았을 경우에는 장면 분할 결과 대신 오류 메시지가 반환됩니다.

장면 분할 API의 오류 코드 목록은 다음과 같습니다.