OSC API 사양의 API 레벨 1은 이미지 유형에 초점을 맞추고 API 레벨 2에서는 비디오 지원이 추가되었습니다. 카메라 제조사는 사용자 지정 명령을 정의하거나 필요에 따라 표준 매개변수 세트를 확장하는 것이 좋습니다. 이를 업체 명령 및 업체 매개변수라고 부릅니다.
업체 특정 명령 및 매개변수의 이름은 밑줄(_)이 접두사로 붙은 영숫자여야 합니다.
업체 특정 기능은 다음과 같은 네 장소에서 발생할 수 있습니다.
- /osc/info API의 출력
- /osc/state API의 출력
- /osc/commands/execute의 OSC API 사양, 명령
- OSC API 사양, 명령 매개변수(예:
setOptions
및getOptions
명령의 매개변수).
예시 | |
---|---|
요청(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" } |