camera.getOptions

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

Paramètres

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

Résultats

  • options:paires <key, value> JSON des propriétés demandées. La valeur peut être de l'un des types suivants: String, String Array, Number, Number Array, Boolean, Object, Object Array. Consultez la section Options.

Erreurs

  • missingParameter:un ou plusieurs paramètres obligatoires sont manquants. Par exemple, optionNames n'est pas spécifié.
  • invalidParameterName:un ou plusieurs noms de paramètre d'entrée ou d'option ne sont pas reconnus ou non compatibles. Par exemple, ce code doit être renvoyé si une option (par exemple, captureInterval) du niveau d'API 2 est utilisée lorsque la valeur de clientVersion dans Options est 1.
  • invalidParameterValue:les noms des paramètres d'entrée sont reconnus, mais une ou plusieurs valeurs ne sont pas valides. Par exemple, sessionId n'existe pas, est inactif ou son type de données est incorrect. Ce code d'erreur est obsolète depuis le niveau d'API 2, car lorsqu'un nom d'option n'est pas valide, invalidParameterName doit être renvoyé.

E/S des commandes
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."
   }
}
Entrée 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."
   }
}