Tiểu bang

API /osc/state trả về các thuộc tính state của máy ảnh. Điểm khác biệt giữa API này và API info là state chứa các giá trị có thể thay đổi thể hiện trạng thái của máy ảnh (ví dụ: batteryLevel), trong khi info chỉ chứa các thuộc tính tĩnh của máy ảnh (ví dụ: manufacturer hoặc các thuộc tính không thường xuyên thay đổi như firmwareVersion)).

Đầu vào

  • Lệnh này không nhận dữ liệu đầu vào.

Đầu ra

Tên Loại Mô tả
fingerprint Chuỗi Vân tay (giá trị nhận dạng duy nhất) của trạng thái camera hiện tại.
state Đối tượng Đối tượng JSON chứa trạng thái của nhiều trạng thái máy ảnh. Xem bảng tiếp theo.

state đối tượng

Đối tượng JSON này cung cấp trạng thái của nhiều trạng thái máy ảnh. Nhà sản xuất có thể cung cấp các trạng thái mới, tuỳ chỉnh và các trạng thái này phải có tiền tố là dấu gạch dưới ( _ ) để tránh xung đột giữa các không gian tên.

Tên Loại Mô tả
sessionId Chuỗi Mã của phiên hiện tại. Trường này không còn được dùng trong API cấp 2.
batteryLevel Số Được biểu thị dưới dạng giá trị dấu phẩy động của mức pin còn lại, ví dụ: 0,5
storageChanged Boolean Đúng nếu bạn đã cắm/tháo loại bộ nhớ mới (ví dụ: thẻ SD hoặc ổ USB). Trường này không còn được dùng trong API cấp 2.
storageUri Chuỗi Giá trị nhận dạng duy nhất để phân biệt các bộ nhớ. Được dùng để biết bộ nhớ đã thay đổi hay chưa. Trường này đã được thêm vào API cấp 2.
_vendorSpecific [loại](không bắt buộc) Trạng thái bổ sung cụ thể của nhà cung cấp về máy ảnh. Đặt tiền tố bằng dấu gạch dưới ( _ ) để tránh xung đột không gian tên.

Lỗi

  • Lệnh này không trả về lỗi.

Ví dụ:
Yêu cầu 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Đáp 
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
    }
}