OSC API 規格的 API 級別 1 著重於圖片類型,API 級別 2 則新增影片支援。我們建議相機製造商視需要定義自訂指令及/或擴充標準指令的參數組合。這些指令稱為供應商指令和供應商參數。
供應商專屬命令和參數的名稱必須為英數字元,前面加上底線 ( _ )。
供應商專屬功能可能會在四個位置顯示,如下所示:
- /osc/info API 的輸出內容
- /osc/state API 的輸出內容
- OSC API 規格,/osc/commands/execute 的指令
- 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" } |