상태

/osc/state API는 카메라의 state 특성을 반환합니다. 이 API와 info API의 차이점은, state에는 카메라 상태를 나타내는 변경 가능 값이 포함되지만(예: batteryLevel), info 에는 카메라의 정적 특성만 포함됩니다(예: manufacturer 또는 firmwareVersion)과 같이 자주 변경되지 않는 특성).

입력

  • 이 명령은 입력을 받지 않습니다.

출력

이름 유형 설명
fingerprint 문자열 현재 카메라 상태의 지문(고유 식별자).
state 객체 다양한 카메라 상태의 상태를 포함하는 JSON 객체. 다음 표를 참조하세요.

state 객체

이 JSON 객체는 다양한 카메라 상태에 대한 정보를 제공합니다. 네임스페이스 충돌을 예방하기 위해 밑줄(_)로 접두사를 붙여야 하는 새로운 사용자 지정 상태를 제조업체가 제공할 수 있습니다.

이름 유형 설명
sessionId 문자열 현재 세션의 ID. 이 필드는 API 레벨 2 전용입니다.
batteryLevel 숫자 남은 배터리를 부동 소수점 값으로 표현합니다. 예: 0.5
storageChanged 부울 새로운 유형의 스토리지(예: SD 카드 또는 USB 드라이브)가 삽입/제거될 경우 true입니다. 이 필드는 API 레벨 2 전용입니다.
storageUri 문자열 여러 가지 스토리지를 구별하는 고유 식별자입니다. 스토리지가 변경되었는지 알려주는 데 사용합니다. 이 필드는 API 레벨 2에서 추가되었습니다.
_vendorSpecific [유형](optional) 카메라에 대한 공급업체별 추가 상태. 네임스페이스 충돌을 예방하기 위해 밑줄(\_)로 접두사를 붙입니다.

오류

  • 이 명령은 오류를 반환하지 않습니다.

예시
요청 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
응답 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "fingerprint": "12EGA33",
    "state": {
        "sessionId": "12ABC3",
        "batteryLevel": 0.5,
        "storageChanged": false
    }
}