State

/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 [유형](선택사항) 카메라에 관한 공급업체별 추가 상태입니다. 네임스페이스 충돌을 방지하기 위해 밑줄 ( _)로 접두사를 추가합니다.

오류

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

예
요청 
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
    }
}