camera.takePicture

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Parámetros

  • sessionId: Es el identificador de sesión único que se obtuvo del comando camera.startSession . Este campo quedó obsoleto en el nivel de API 2.

Resultados

  • Nivel de API 1
    • fileUri: es 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 es un URI relativo. Los clientes pueden tratar esto como un identificador opaco.
  • Nivel de API 2
    • fileUrl: La URL absoluta de la imagen capturada, que se puede usar para descargar 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 de la cámara) suele tardar un poco (varía de segundos a minutos). El progreso del comando se obtiene mediante un sondeo periódico de la cámara 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, el 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: Actualmente, 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 de 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."
    }
}