camera.setOptions

Đặt giá trị cho các thuộc tính được chỉ định; ví dụ: bật/tắt GPS, ngày & thời gian, 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.

Tham số

  • sessionId: Giá trị nhận dạng phiên duy nhất của chuỗi loại, thu đượ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. Chiến lược phát hành đĩa đơn 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ả nào.

Lỗi

  • ThiếuTham số: Thiếu một hoặc nhiều tham số bắt buộc; với ví dụ: options không được chỉ định.
  • IllegalParameterName: Một hoặc nhiều lựa chọn về tham số đầu vào tên không xác định hoặc không được hỗ trợ, ví dụ: 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 lựa chọn được nhận dạng, nhưng giá trị của tham số này không hợp lệ; ví dụ: loại dữ liệu không chính xác.

Lệnh I/O
Đầu vào lệnh (API cấp 1) 
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
Đầu ra lệnh (API cấp 1) 
none
Kết quả lệnh (Lỗi) (API cấp 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
Đầu vào lệnh (API cấp 2) 
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
Đầu ra lệnh (API cấp 2) 
none
Kết quả lệnh (Lỗi) (API cấp 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}