camera.takePicture

Captura una imagen equirrectangular y guarda las coordenadas de latitud y longitud a EXIF (si tu cámara cuenta con GPS propio o que el GPS está habilitado en teléfonos celulares). Llamar al 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 único de la sesión obtenido del camera.startSession . Este campo dejó de estar disponible en el nivel de API 2.

Resultados

  • Nivel de API 1
    • fileUri: Es el URI de la imagen capturada. Fabricantes decidir si usar URI absolutos o relativos por ejemplo, "http://android.com/robots.txt" es un URI absoluto mientras que "robots.txt" es un URI relativo. Los clientes pueden tratar como un identificador opaco.
  • Nivel de API 2
    • fileUrl: Es la URL absoluta de la imagen capturada, que puede usarse para realizar descargas directamente desde el servidor HTTP de la cámara. Por favor, Ten en cuenta que este comando no muestra fileUrl de inmediato, ya que (incluida la unión de imágenes en la cámara) suele tardar un poco (varía de segundos a minutos) en completarse. El progreso del comando se obtiene sondear la cámara periódicamente con la API /osc/commands/status y fileUrl es el resultado que se muestra cuando finaliza el comando. Cuándo delayProcessing es verdadero, es la URL absoluta de la 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 el tipo de datos es incorrecto. Este código de error dejó de estar disponible en el nivel de API 2.
  • disableCommand: El comando está inhabilitado en este momento. por ejemplo, si 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."
    }
}