camera.getOptions

Menampilkan setelan saat ini untuk properti yang diminta. Perintah ini diubah di API level 2.

Parameter

  • sessionId: ID sesi unik dari string jenis yang diperoleh menggunakan perintah camera.startSession. Kolom ini tidak digunakan lagi pada API level 2.
  • optionNames: Array String nama properti yang akan ditampilkan.

Hasil

  • options: Pasangan <key, value> JSON dari properti yang diminta. Nilainya dapat berupa salah satu jenis berikut: String, String Array, Number, Number Array, Boolean, Object, Object Array. Lihat Opsi.

Error

  • missingParameter: Satu atau beberapa parameter yang diperlukan tidak ada; misalnya, optionNames tidak ditentukan.
  • invalidParameterName: Satu atau beberapa nama parameter input atau nama opsi tidak dikenal atau tidak didukung, misalnya, kode ini harus ditampilkan jika opsi (misalnya, captureInterval) dari API level 2 digunakan saat clientVersion dalam Options adalah 1.
  • invalidParameterValue: Nama parameter input dikenali, tetapi satu atau beberapa nilai tidak valid; misalnya, sessionId tidak ada, tidak aktif, atau jenis datanya salah. Kode error ini tidak digunakan lagi pada API level 2 karena jika nama opsi apa pun tidak valid, invalidParameterName harus ditampilkan.

Perintah I/O

Input Perintah (API level 1)
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Output Perintah (API level 1)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Output Perintah (Error) (API level 1)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
Input Perintah (API level 2)
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Output Perintah (API level 2)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Output Perintah (Error) (API level 2)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}