camera.setOptions

Đặt giá trị cho các thuộc tính cụ thể; ví dụ: bật/tắt GPS, ngày và giờ, ISO, cân bằng trắng, tốc độ màn trập, độ trễ khi ngủ/tắt nguồn, v.v. Lệnh này đã được sửa đổi trong API cấp 2.

Các tham số

  • sessionId: Giá trị nhận dạng phiên duy nhất của chuỗi loại, lấy được bằng lệnh camera.startSession. Trường này không còn được dùng trong API cấp 2.
  • options:Các cặp thuộc tính JSON <key, value> cần đặt. Giá trị có thể là bất kỳ loại nào sau đây: String, String Array, Number, Number Array, Boolean, Object, Object Array. Xem Tuỳ chọn.

Kết quả

  • Lệnh này không trả về kết quả.

Lỗi

  • missingParameter: Thiếu một hoặc nhiều tham số bắt buộc; ví dụ: options không được chỉ định.
  • invalidParameterName: Một hoặc nhiều tuỳ chọn tham số đầu vào hoặc tên tuỳ chọn không được nhận dạng hoặc không được hỗ trợ, chẳng hạn như mã này sẽ được trả về nếu một tuỳ chọn (ví dụ: captureInterval) từ API cấp 2 được sử dụng khi clientVersion trong Options là 1.
  • invalidParameterValue: Một hoặc nhiều tham số đầu vào hoặc tên tuỳ chọn được nhận dạng, nhưng giá trị của thông số đó không hợp lệ; ví dụ: loại dữ liệu không chính xác.

I/O lệnh
Command Input (API cấp 1) 
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
Đầu ra của lệnh (API cấp 1) 
none
Đầu ra của lệnh (Lỗi) (API cấp 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
Command Input (API cấp 2) 
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
Đầu ra của lệnh (API cấp 2) 
none
Đầu ra của lệnh (Lỗi) (API cấp 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}