camera.takePicture

Captura uma imagem equirretangular, salvando coordenadas de latitude/longitude para EXIF (se sua câmera tiver seu próprio GPS ou GPS ativado no celulares). Ligar para camera.setOptions antes desta chamada de comando, se necessário. Esse comando foi modificado no nível 2 da API.

Parâmetros

  • sessionId::identificador exclusivo de sessão recebido do camera.startSession . Esse campo foi descontinuado no nível 2 da API.

Resultados

  • API de nível 1
    • fileUri: o URI da imagem capturada. Fabricantes decidir se devem usar URIs absolutos ou relativos; por exemplo, "http://android.com/robots.txt" é um URI absoluto e o arquivo "robots.txt" é um URI relativo. Os clientes podem tratar como um identificador opaco.
  • API de nível 2
    • fileUrl::URL absoluto da imagem capturada, que pode ser usada para fazer o download diretamente do servidor HTTP da câmera. Não se esqueça esse comando não retorna fileUrl imediatamente, já que o a captura (incluindo a edição na câmera) geralmente demora um pouco (varia de segundos para minutos) para concluir. O progresso do comando é obtido pela acessar a câmera periodicamente usando a API /osc/commands/status e fileUrl é o resultado retornado quando o comando é concluído. Quando delayProcessing é verdadeiro, é o URL absoluto da visualização. que pode ser usada como entrada em processPicture para processar a imagem, Caso contrário, ele é o URL absoluto da imagem final processada.

Erros

  • missingParameter: sessionId está ausente. Esse código do erro foi descontinuado na API de nível 2.
  • invalidParameterName:o nome do parâmetro não foi reconhecido, por exemplo, sessionId não é reconhecido no nível 2 da API.
  • invalidParameterValue: o nome do parâmetro de entrada é reconhecido, mas seu valor é inválido. Por exemplo, sessionId não existe, não está mais ativo ou o tipo de dados está incorreto. Esse código do erro foi descontinuado na API de nível 2.
  • disableCommand:: o comando está desativado no momento. por exemplo, a câmera está no modo de gravação de vídeo. Esse código de erro foi adicionado no nível 2 da API.

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