camera.startCapture

Bắt đầu quay video hoặc chụp ảnh ngắt quãng tuỳ thuộc vào giá trị của captureMode trong Tuỳ chọn. Lệnh này đã được thêm vào API cấp 2.

Các tham số

  • Lệnh này không có tham số trong nội dung yêu cầu. Việc chụp ảnh theo khoảng thời gian hay quay video được xác định bằng tuỳ chọn captureMode. Đối với chụp ngắt quãng, việc đó có phải là chụp kết thúc mở hay không phụ thuộc vào việc captureNumber bằng hay lớn hơn 0. Bạn cần đặt captureMode, captureInterval và captureNumber trước khi chụp khoảng thời gian. Bạn chỉ cần đặt captureMode thành "video" trước khi quay video, và bạn chỉ có thể dừng việc này bằng lệnh camera.stopCapture.

Kết quả

  • Quay video kết thúc (khi captureMode == "video" hoặc captureNumber == 0)
    • Không có kết quả.
  • Chụp khoảng thời gian không mở:
    • fileUrls: Danh sách các URL tuyệt đối, trỏ đến các tệp hình ảnh để chụp khoảng thời gian. Xin lưu ý rằng lệnh này không trả về fileUrls ngay lập tức vì quá trình chụp cần captureNumber để hoàn tất. Bạn có thể nhận được tiến trình của lệnh bằng cách thăm dò máy ảnh theo định kỳ. Ví dụ: cuộc thăm dò sau thời lượng ước tính (time = captureInterval * (captureNumber - 1)) bằng cách sử dụng API /osc/commands/status và fileUrls là kết quả được trả về khi lệnh kết thúc. Nếu lệnh không hoàn tất thành công (ví dụ: chỉ chụp 3 trong số hình ảnh trước khi máy ảnh hết pin) hoặc máy ảnh bị ngắt kết nối với điện thoại ở giữa, nhưng lệnh này vẫn kết thúc thành công, thì ứng dụng sẽ có thể lấy hình ảnh bằng cách sử dụng camera.listFiles sau khi kết nối mới được thiết lập giữa ứng dụng và máy ảnh.

Lỗi

  • disabledCommand: Lệnh hiện đang tắt; ví dụ: máy ảnh đang quay video hoặc quay ngắt quãng.
  • invalidParameterName: Tên tham số không nhận dạng được; ví dụ: sessionId không nhận dạng được.

I/O lệnh
Nhập lệnh 
none
Đầu ra của lệnh 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Kết quả của lệnh (Lỗi) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}