Thông tin

API /osc/info trả về thông tin cơ bản về máy ảnh và chức năng mà nó 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 camera.
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 của trang web hỗ trợ về camera.
gps Boolean Đúng nếu máy ảnh có GPS.
gyro Boolean Đúng nếu máy ảnh 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 Theo mặc định, trường này là [1] khi thiếu trường này. [1, 2] đại diện cho cả API 1 và 2 đều được hỗ trợ trong khi [2] chỉ 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ị này. Trường này được thêm vào từ 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 từ API cấp 2.1 và có liên quan đến tính năng Tải lên trực tiếp.
_vendorSpecific loại Thông tin bổ sung dành riêng cho nhà cung cấp về camera. Vui lòng thêm dấu gạch dưới ( _) vào các khoá của từng nhà cung cấp để tránh xung đột về 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 ý: Không bắt buộc phải có điểm cuối HTTPS.

Tên Loại Mô tả
httpPort Số nguyên Cổng cho máy chủ HTTP. (Mặc định là 80)
httpUpdatesPort Số nguyên Cổng để nhận nội dung cập nhật qua HTTP
httpsPort Số nguyên (Không bắt buộc) Cổng cho máy chủ HTTPs. (Mặc định là 443)
httpsUpdatesPort Số nguyên (Không bắt buộc) Cổng để nhận thông tin cập nhật qua HTTP.

Lỗi

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

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"
        ]
}