업체 특정

OSC API 사양의 API 레벨 1은 이미지 유형에 초점을 맞추고 API 레벨 2에서는 비디오 지원이 추가되었습니다. 카메라 제조사는 사용자 지정 명령을 정의하거나 필요에 따라 표준 매개변수 세트를 확장하는 것이 좋습니다. 이를 업체 명령업체 매개변수라고 부릅니다.

업체 특정 명령 및 매개변수의 이름은 밑줄(_)이 접두사로 붙은 영숫자여야 합니다.

업체 특정 기능은 다음과 같은 네 장소에서 발생할 수 있습니다.

예시

요청(API 1)
POST /osc/commands/execute HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "name": "camera.setOptions",
    "parameters": {
        "sessionId": "12ABC3",
        "iso": 200,
        "exposureCompensation": -2,
        "captureMode": "_video"
    }
}
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera.setOptions",
    "state": "done"
}
요청
POST /osc/commands/execute HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "name": "camera._startRecording",
    "parameters": {
        "sessionId": "12ABC3",
        ...
    }
}
응답
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera._startRecording",
    "state": "done"
}