Thông tin

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