/osc/info
API는 카메라 및 기능에 관한 기본 정보를 반환합니다.
살펴보겠습니다
입력
- 이 명령어에는 입력이 필요하지 않습니다.
출력
이름 | 유형 | 설명 |
---|---|---|
manufacturer |
문자열 | 카메라 제조업체 |
model |
문자열 | 카메라 모델 |
serialNumber |
문자열 | 일련번호입니다. |
firmwareVersion |
문자열 | 현재 펌웨어 버전 |
supportUrl |
문자열 | 카메라 지원 웹페이지의 URL입니다. |
gps |
불리언 | 카메라에 GPS가 있으면 true입니다. |
gyro |
불리언 | 카메라에 자이로스코프가 있으면 true입니다. |
uptime |
정수 | 카메라 부팅 후 경과된 시간(초)입니다. |
api |
문자열 배열 | 지원되는 API의 목록입니다. |
endpoints |
객체 | 카메라의 엔드포인트에 대한 정보가 포함된 JSON 객체입니다. 다음 표를 참고하세요. |
apiLevel |
정수 배열 | 이 필드가 없으면 기본적으로 [1] 입니다. [1, 2]는 API 1과 API 2가 모두 지원됨을 나타내며, [2]는 API 2만 지원됨을 나타냅니다. 이 정보를 검색하고 해당 값에 기반하여 달리 구현하는 것은 개발자의 책임입니다. 이 필드는 API 수준 2에 추가되었습니다. API 2.1을 지원하는 경우에도 2를 사용하세요. |
cameraId |
문자열 | 카메라를 나타내는 고유 ID입니다. 이 필드는 API 수준 2.1에 추가되었으며 직접 업로드와 관련이 있습니다. |
_vendorSpecific |
type | 카메라에 관한 공급업체별 추가 정보 네임스페이스 충돌을 방지하기 위해 밑줄 ( _ )을 사용하여 공급업체별 키 프리픽스를 붙이세요. |
endpoints
객체
이 JSON 객체는 카메라가 엔드포인트에 사용하는 포트에 대한 정보를 제공합니다.
참고: HTTPS 엔드포인트는 선택사항입니다.
이름 | 유형 | 설명 |
---|---|---|
httpPort |
정수 | HTTP 서버의 포트입니다. (기본값: 80) |
httpUpdatesPort |
정수 | HTTP를 통해 업데이트를 수신하는 포트 |
httpsPort |
정수 | (선택사항) HTTPS 서버의 포트입니다. (기본값 443) |
httpsUpdatesPort |
정수 | (선택사항) HTTPS를 통해 업데이트를 수신하는 포트입니다. |
오류
- 이 명령어는 오류를 반환하지 않습니다.
예 |
|
---|---|
요청 | GET /osc/info HTTP/1.1 Host: [camera ip address]:[httpPort] Accept: application/json X-XSRF-Protected: 1 |
응답 (API 2) | HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8 Content-Length: {CONTENT_LENGTH} X-Content-Type-Options: nosniff { "manufacturer": "AAA", "model": "BBB", "serialNumber": "CCC", "firmwareVersion": "DDD", "supportUrl": "EEE", "endpoints": { "httpPort": 80, "httpUpdatesPort": 10080, ... }, "gps": true, "gyro": false, "uptime": 600, "api": [ "/osc/info", "/osc/state", "/osc/checkForUpdates", "/osc/commands/execute", "/osc/commands/status" ], "apiLevel": [1, 2] } |
응답 (API 1) | HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8 Content-Length: {CONTENT_LENGTH} X-Content-Type-Options: nosniff { "manufacturer": "AAA", "model": "BBB", "serialNumber": "CCC", "firmwareVersion": "DDD", "supportUrl": "EEE", "endpoints": { "httpPort": 80, "httpUpdatesPort": 10080, ... }, "gps": true, "gyro": false, "uptime": 600, "api": [ "/osc/info", "/osc/state", "/osc/checkForUpdates", "/osc/commands/execute", "/osc/commands/status" ] } |