camera.getOptions

Restituisce le impostazioni attuali per le proprietà richieste. Questo comando è stato modificato nel livello API 2.

Parametri

  • sessionId: identificatore di sessione univoco della stringa di tipo ottenuta utilizzando il comando camera.startSession. Questo campo è stato ritirato nel livello API 2.
  • optionNames: un array di stringhe di nomi di proprietà da restituire.

Risultati

  • options: <key, value> coppie JSON delle proprietà richieste. Il valore può essere uno dei seguenti tipi: String, String Array, Number, Number Array, Boolean, Object e Object Array. Consulta Opzioni.

Errori

  • missingParameter: mancano uno o più parametri obbligatori. ad esempio optionNames non è specificato.
  • invalidParameterName:uno o più nomi o opzioni di parametro di input nome non riconosciuto o non supportato, ad esempio questo codice deve essere restituito (ad es. captureInterval) del livello API 2 viene utilizzata quando clientVersion in Options è 1.
  • invalidParameterValue: i nomi dei parametri di input vengono riconosciuti, ma uno o più valori non sono validi; ad esempio sessionId non esiste, non è attivo o il tipo di dati non è corretto. Questo codice di errore è stato ritirato in Livello API 2 da quando un nome di opzione non è valido, invalidParameterName da restituire.

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