camera.processPicture

Xử lý hình ảnh đã được chụp trước đây nhưng chưa được xử lý. Lệnh này chỉ liên quan nếu bạn hỗ trợ delayProcessing kể từ thì việc xử lý mất nhiều thời gian. Nếu bạn không hỗ trợ delayProcessing, yêu cầu cho lệnh này sẽ không thành công với mã lỗi disabledCommand. Lệnh này đã được thêm vào từ API cấp 2.

Tham số

  • previewFileUrls: Danh sách URL của hình ảnh chưa được xử lý. Nếu bạn muốn xử lý tất cả hình ảnh chưa xử lý trong máy ảnh, thì chế độ này sẽ là ["tất cả"]. Không được để trống trường này. Nếu máy ảnh gặp sự cố khi xử lý bất kỳ hình ảnh nào, máy ảnh không phản hồi kèm theo lỗi mà sẽ bỏ qua URL đó và tiếp tục với các biến thể khác và trường hợp đặc biệt có thể là previewToFinalFileUrls là được trả về dưới dạng JSONObject trống.

Kết quả

  • previewToFinalFileUrls: JSONObject của JSON <key, value=""> các cặp, trong đó mỗi khoá là URL tuyệt đối của hình ảnh xem trước và mỗi khoá là hình ảnh được xử lý cuối cùng tương ứng và có thể dùng để tải xuống ngay trong máy ảnh. Xin lưu ý rằng lệnh này tương tự với camera.takeImage và không trả về previewToFinalFileUrls ngay lập tức (ngoại trừ trường hợp góc được giải thích sau trong đoạn này) vì quá trình xử lý (bao gồm cả ghép nối trong máy ảnh) thường mất một khoảng thời gian (thay đổi từ giây đến phút) để hoàn tất. Nhận được tiến trình của lệnh bằng cách thăm dò máy ảnh định kỳ bằng cách sử dụng API /osc/commands/status và previewToFinalFileUrls là kết quả được trả về khi dùng lệnh kết thúc. Nếu mất kết nối với máy ảnh trước khi lệnh kết thúc, khách hàng có thể sử dụng listFiles để lấy URL của hình ảnh cuối cùng khi được kết nối lại với máy ảnh hoặc tạo một lệnh processImage khác, lệnh này sẽ trả về giá trị previewToFinalFileUrls ngay lập tức nếu hình ảnh đã được xử lý trước khi kết nối lại.</key,>

Lỗi

  • disabledCommand: Nếu bạn không hỗ trợ xử lý độ trễ.
  • không hợp lệ Tham số: Tên của tham số đầu vào là không nhận dạng được.
  • invalidParameterValue: Tên của thông số đầu vào là được nhận dạng, nhưng giá trị của tham số này không hợp lệ; Ví dụ: bất kỳ URL nào trong previewFileUrls không hợp lệ.

Lệnh I/O
Nhập lệnh 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
Kết quả lệnh 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
Ra lệnh (Lỗi) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}