camera.takePicture

Captura una imagen equirrectangular y guarda las coordenadas de latitud y longitud en el formato EXIF (si la cámara cuenta con su propio GPS o el GPS está habilitado en los teléfonos celulares conectados). Llama a camera.setOptions antes de realizar esta llamada de comando si es necesario. Este comando se modificó en el nivel de API 2.

Parámetros

  • sessionId: Es el identificador único de sesión obtenido del comando camera.startSession . Este campo dejó de estar disponible en el nivel de API 2.

Resultados

  • Nivel de API 1
    • fileUri: el URI de la imagen capturada Los fabricantes deciden si usar URI absolutos o relativos; por ejemplo, "http://android.com/robots.txt" es un URI absoluto, mientras que "robots.txt" es relativo. Los clientes pueden tratar esto como un identificador opaco.
  • Nivel de API 2
    • fileUrl: URL absoluta de la imagen capturada, que se puede usar para descargarla directamente desde el servidor HTTP de la cámara. Ten en cuenta que este comando no muestra fileUrl de inmediato, ya que la captura (incluida la unión dentro de la cámara) suele tardar un tiempo en completarse (puede variar de segundos a minutos). Para obtener el progreso del comando, se sondea la cámara de forma periódica con la API de /osc/commands/status y fileUrl es el resultado que se muestra cuando finaliza el comando. Cuando delayProcessing es verdadero, es la URL absoluta de la imagen de vista previa, que se puede usar como entrada en processPicture para procesar la imagen; de lo contrario, es la URL absoluta de la imagen final procesada.

Errores

  • missingParameter: Falta sessionId. Este código de error dejó de estar disponible en el nivel de API 2.
  • invalidParameterName: No se reconoce el nombre del parámetro, p.ej., no se reconoce sessionId en el nivel de API 2.
  • invalidParameterValue: Se reconoce el nombre del parámetro de entrada, pero su valor no es válido. Por ejemplo, sessionId no existe, ya no está activo o su tipo de datos es incorrecto. Este código de error dejó de estar disponible en el nivel de API 2.
  • DisabledCommand: El comando está inhabilitado. Por ejemplo, la cámara está en modo de grabación de video. Este código de error se agregó en el nivel de API 2.

E/S de comando
Entrada del comando (nivel de API 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Resultado del comando (nivel de API 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Resultado del comando (error) (nivel de API 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Entrada de comando (nivel de API 2) 
none
Resultado del comando (nivel de API 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Resultado del comando (error) (nivel de API 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}