Camera.getOptions

แสดงการตั้งค่าปัจจุบันสำหรับพร็อพเพอร์ตี้ที่ขอ มีการแก้ไขคำสั่งนี้ใน API ระดับ 2

พารามิเตอร์

  • sessionId: ตัวระบุเซสชันที่ไม่ซ้ำกันของสตริงประเภทที่ได้รับโดยใช้คำสั่ง camera.startSession ช่องนี้เลิกใช้งานแล้วใน API ระดับ 2
  • optionNames: อาร์เรย์สตริงของชื่อพร็อพเพอร์ตี้ที่จะแสดง

ผลลัพธ์

  • options: JSON <key, value> ของพร็อพเพอร์ตี้ที่ขอ ค่าอาจเป็นประเภทใดก็ได้ต่อไปนี้ String, String Array, Number, Number Array, Boolean, Object, Object Array ดูตัวเลือก

ข้อผิดพลาด

  • missingParameters: ไม่มีพารามิเตอร์ที่จำเป็นอย่างน้อย 1 รายการ เช่น ไม่ได้ระบุ optionNames
  • invalidParametersName: ชื่อพารามิเตอร์หรือชื่อตัวเลือกอินพุตอย่างน้อย 1 รายการที่ไม่รู้จักหรือไม่รองรับ เช่น ระบบควรแสดงผลโค้ดนี้หากใช้ตัวเลือก (เช่น captureInterval) จาก API ระดับ 2 เมื่อ clientVersion ใน Options เท่ากับ 1
  • invalidParametersValue: ระบบรู้จักชื่อพารามิเตอร์อินพุต แต่ค่าอย่างน้อย 1 ค่าไม่ถูกต้อง เช่น sessionId ไม่มีอยู่ ไม่ทำงาน หรือประเภทข้อมูลไม่ถูกต้อง เราเลิกใช้งานรหัสข้อผิดพลาดนี้ใน API ระดับ 2 แล้ว เนื่องจากชื่อตัวเลือกไม่ถูกต้อง ระบบควรแสดง invalidParameterName

คำสั่ง I/O

การป้อนข้อมูลด้วยคำสั่ง (API ระดับ 1)
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
เอาต์พุตคำสั่ง (API ระดับ 1)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
เอาต์พุตคำสั่ง (ข้อผิดพลาด) (API ระดับ 1)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
การป้อนข้อมูลด้วยคำสั่ง (API ระดับ 2)
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
เอาต์พุตคำสั่ง (API ระดับ 2)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
เอาต์พุตคำสั่ง (ข้อผิดพลาด) (API ระดับ 2)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}