camera.getOptions

Trả về chế độ cài đặt hiện tại cho các tài sản được yêu cầu. 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 loại chuỗi đã nhận được bằng lệnh camera.startSession. Trường này không còn được dùng trong API cấp 2.
  • optionNames: Một Mảng chuỗi gồm các tên thuộc tính cần trả về.

Kết quả

  • options:Cặp JSON <key, value> của thuộc tính được yêu cầu. Giá trị có thể thuộc bất kỳ loại nào sau đây: String, String Array, Number, Number Array, Boolean, Object, Object Array. Xem Tuỳ chọn.

Lỗi

  • ThiếuTham số: Thiếu một hoặc nhiều tham số bắt buộc; ví dụ: optionNames không được chỉ định.
  • không hợp lệTham số: Một hoặc nhiều tên hoặc lựa chọn 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: Hệ thống nhận dạng được tên tham số đầu vào, nhưng một hoặc nhiều giá trị không hợp lệ; ví dụ: sessionId không tồn tại, không hoạt động hoặc loại dữ liệu không chính xác. Mã lỗi này không còn được dùng trong API cấp 2 kể từ khi tên tuỳ chọn bất kỳ không hợp lệ, invalidParameterName sẽ được trả về.

Lệnh I/O
Đầu vào lệnh (API cấp 1) 
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Đầu ra lệnh (API cấp 1) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Kết quả lệnh (Lỗi) (API cấp 1) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
Đầu vào lệnh (API cấp 2) 
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Đầu ra lệnh (API cấp 2) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Kết quả lệnh (Lỗi) (API cấp 2) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}