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 mục Tuỳ chọn. Lệnh này đã được thêm vào từ API cấp 2.

Tham số

  • Lệnh này không có tham số trong nội dung yêu cầu. Có phải là ảnh ngắt quãng không quay hoặc quay video được xác định theo 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 captureNumber bằng hoặc lớn hơn 0. captureMode, captureInterval và Bạn cần đặt captureNumber trước khi chụp ngắt quãng. Chỉ cần đặt captureMode thành "video" trước video chụp mà chỉ có thể dừng bằng lệnh camera.stopCapture.

Kết quả

  • Chụp kết thúc mở (khi CaptureMode == "video" hoặc CaptureNumber == 0)
    • Không có kết quả.
  • Chụp ngắt quãng không kết thúc mở:
    • fileUrls: Danh sách các URL tuyệt đối, trỏ đến 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 kể từ khi ảnh chụp captureNumber để hoàn tất. Tiến trình của lệnh có thể là bằng cách thăm dò camera định kỳ. Ví dụ: cuộc thăm dò ý kiến 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ỉ có 3 trong số hình ảnh được được chụp trước khi máy ảnh hết pin) hoặc máy ảnh bị ngắt kết nối từ điện thoại khách ở giữa, nhưng lệnh vẫn kết thúc thành công, khách hàng có thể lấy được hình ảnh bằng cách sử dụng camera.listFiles khi thiết lập kết nối mới giữa ứng dụng và camera.

Lỗi

  • disabledCommand: Lệnh hiện đang tắt; ví dụ: máy ảnh nằm ở giữa cảnh quay video hoặc chụp ngắt quãng.
  • không hợp lệ Tham số: Tên tham số không nhận dạng được; ví dụ: Không nhận dạng được sessionId.

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