camera.setOptions

Consente di impostare valori relativi a proprietà specificate, ad esempio attivazione/disattivazione GPS, data e ora, ISO, bilanciamento del bianco, tempo di esposizione, ritardo di sospensione/spegnimento e così via. Questo comando è stato modificato nel livello API 2.

Parametri

  • sessionId: identificatore di sessione univoco di tipo stringa, ottenuto utilizzando il comando camera.startSession. Questo campo è stato ritirato nel livello API 2.
  • options:coppie JSON <key, value> delle proprietà da impostare. Il valore può essere uno dei seguenti tipi: String, String Array, Number, Number Array, Boolean, Object, Object Array. Vedi Opzioni.

Risultati

  • Questo comando non restituisce alcun risultato.

Errori

  • missingParameter: mancano uno o più parametri obbligatori. Ad esempio, options non è specificato.
  • invalidParameterName: il nome o l'opzione di uno o più parametri di input non sono riconosciuti o non sono supportati. Ad esempio, questo codice deve essere restituito se viene utilizzata un'opzione (ad es. captureInterval) dal livello API 2 quando clientVersion in Options è 1.
  • invalidParameterValue: sono stati riconosciuti uno o più parametri di input o il nome di un'opzione, ma il relativo valore non è valido. Ad esempio, un tipo di dati non è corretto.

I/O comando

Input dei comandi (livello API 1)
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
Output comando (livello API 1)
none
Output comando (errore) (livello API 1)
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
Input dei comandi (livello API 2)
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
Output comando (livello API 2)
none
Output comando (errore) (livello API 2)
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}