Muestra la configuración actual de las propiedades solicitadas. Este comando se modificó en el nivel de API 2.
Parámetros
- sessionId: Es el identificador de sesión único de la string de tipo obtenido mediante el comando
camera.startSession
. Este campo quedó obsoleto en el nivel de API 2. - optionNames: Es un arreglo de strings de nombres de propiedad para mostrar.
Resultados
- options: Son los pares
<key, value>
de JSON de las propiedades solicitadas. El valor puede ser cualquiera de los siguientes tipos:String
,String Array
,Number
,Number Array
,Boolean
,Object
,Object Array
. Consulta Opciones.
Errores
- missingParameter: Falta uno o más parámetros obligatorios; por ejemplo, no se especificó
optionNames
. - invalidParameterName: Uno o más nombres de parámetros de entrada o nombres de opciones no se reconocen o no son compatibles; p.ej., este código se debe mostrar si se usa una opción (p.ej.,
captureInterval
) del nivel de API 2 cuandoclientVersion
enOptions
es 1. - invalidParameterValue: se reconocen los nombres de los parámetros de entrada, pero uno o más valores no son válidos; por ejemplo, el
sessionId
no existe, está inactivo o su tipo de datos es incorrecto. Este código de error dejó de estar disponible en la API nivel 2, ya que cuando se muestra un nombre de opción no válido, se debe mostrarinvalidParameterName
.
E/S de comando | |
---|---|
Entrada de comando (nivel de API 1) | { "parameters": { "sessionId": "12ABC3", "optionNames": [ "iso", "isoSupport" ] } } |
Resultado del comando (nivel de API 1) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
Resultado del comando (error) (nivel de API 1) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |
Entrada de comando (nivel de API 2) | { "parameters": { "optionNames": [ "iso", "isoSupport" ] } } |
Resultado del comando (nivel de API 2) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
Resultado del comando (error) (nivel de API 2) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |