API /osc/info
trả về thông tin cơ bản về máy ảnh và chức năng mà máy ảnh hỗ trợ.
Đầ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ả |
---|---|---|
manufacturer |
Chuỗi | Nhà sản xuất máy ảnh. |
model |
Chuỗi | Kiểu máy ảnh. |
serialNumber |
Chuỗi | Số sê-ri. |
firmwareVersion |
Chuỗi | Phiên bản chương trình cơ sở hiện tại. |
supportUrl |
Chuỗi | URL cho trang web hỗ trợ của máy ảnh. |
gps |
Boolean | Đúng nếu máy ảnh có GPS. |
gyro |
Boolean | Đúng nếu camera có Con quay hồi chuyển. |
uptime |
Số nguyên | Số giây kể từ khi khởi động máy ảnh. |
api |
Mảng chuỗi | Danh sách API được hỗ trợ. |
endpoints |
Đối tượng | Đối tượng JSON chứa thông tin về các điểm cuối của máy ảnh. Xem bảng tiếp theo. |
apiLevel |
Mảng số nguyên | Giá trị mặc định là [1] khi thiếu trường này. [1, 2] đại diện cho cả API 1 và 2 được hỗ trợ trong khi [2] chỉ biểu thị API 2 được hỗ trợ. Nhà phát triển có trách nhiệm truy xuất thông tin này và triển khai theo cách khác dựa trên giá trị. Trường này đã được thêm vào API cấp 2. Vui lòng sử dụng 2 nếu bạn hỗ trợ API 2.1. |
cameraId |
Chuỗi | Mã nhận dạng duy nhất đại diện cho máy ảnh. Trường này đã được thêm vào API cấp 2.1 và có liên quan đến hoạt động Tải lên trực tiếp. |
_vendorSpecific |
loại | Thông tin bổ sung về máy ảnh theo từng nhà cung cấp. Vui lòng thêm tiền tố dấu gạch dưới ( _ ) vào khoá của nhà cung cấp để tránh xung đột không gian tên. |
endpoints
đối tượng
Đối tượng JSON này cung cấp thông tin về các cổng mà máy ảnh sử dụng cho các điểm cuối.
Lưu ý: Bạn không bắt buộc phải sử dụng điểm cuối HTTPS.
Tên | Loại | Nội dung mô tả |
---|---|---|
httpPort |
Số nguyên | Cổng dành cho máy chủ HTTP. (Mặc định là 80) |
httpUpdatesPort |
Số nguyên | Chuyển để nhận thông tin cập nhật qua HTTP |
httpsPort |
Số nguyên | (Không bắt buộc) Cổng dành cho máy chủ HTTP. (Mặc định 443) |
httpsUpdatesPort |
Số nguyên | (Không bắt buộc) Chuyển để nhận thông tin cập nhật qua HTTP. |
Lỗi
- Lệnh này không trả về lỗi.
Ví dụ: |
|
---|---|
Yêu cầu | GET /osc/info HTTP/1.1 Host: [camera ip address]:[httpPort] Accept: application/json X-XSRF-Protected: 1 |
Phản hồi (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] } |
Phản hồi (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" ] } |