camera.getOptions

Affiche les paramètres actuels des propriétés demandées. Cette commande a été modifiée au niveau d'API 2.

Paramètres

  • sessionId::identifiant de session unique du type de chaîne obtenu à l'aide de la commande camera.startSession. Ce champ a été abandonné dans le niveau d'API 2.
  • optionNames:tableau de chaînes de noms de propriétés à renvoyer.

Résultats

  • options:paires JSON <key, value> des propriétés demandées. Cette valeur peut correspondre à l'un des types suivants: String, String Array, Number, Number Array, Boolean, Object et Object Array. Voir Options :

Erreurs

  • missingParameter:un ou plusieurs paramètres obligatoires sont manquants. Par exemple, optionNames n'est pas spécifié.
  • invalidParameterName:un ou plusieurs nom ou option de paramètre d'entrée le nom n'est pas reconnu ou n'est pas pris en charge (par exemple, ce code doit être renvoyé si une (par exemple, captureInterval) du niveau d'API 2 est utilisée lorsque clientVersion dans Options est égal à 1.
  • invalidParameterValue::les noms des paramètres d'entrée sont reconnus, mais une ou plusieurs valeurs sont incorrectes ; par exemple, sessionId n'existe pas, est inactif ou que son type de données est incorrect. Ce code d'erreur a été abandonné dans Niveau d'API 2 puisque lorsqu'un nom d'option n'est pas valide, invalidParameterName doit être renvoyé.

E/S de commande
Entrée de commande (niveau d'API 1) 
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Résultat de la commande (niveau d'API 1) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Résultat de la commande (erreur) (niveau d'API 1) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
Saisie de commande (niveau d'API 2) 
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Résultat de la commande (niveau d'API 2) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Résultat de la commande (erreur) (niveau d'API 2) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}