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