camera.takePicture

Acquisisce un'immagine equirettangolare, salvando le coordinate di latitudine/longitudine a EXIF (se la fotocamera dispone di un proprio GPS o GPS è abilitato telefoni cellulari). Chiama il numero camera.setOptions prima di questa chiamata, se necessario. Questo comando è stato modificato nel livello API 2.

Parametri

  • sessionId: l'identificatore di sessione univoco ottenuto dalla camera.startSession . Questo campo è stato ritirato nel livello API 2.

Risultati

  • Livello API 1
      .
    • fileUri: URI dell'immagine acquisita. Produttori decidere se utilizzare URI assoluti o relativi; ad esempio "http://android.com/robots.txt" è un URI assoluto mentre "robots.txt" è un URI relativo. I clienti possono trattare come identificatore opaco.
  • Livello API 2
      .
    • fileUrl: l'URL assoluto dell'immagine acquisita, che può essere per il download direttamente dal server HTTP della videocamera. Non dimenticare di apporre nota che questo comando non restituisce fileUrl immediatamente poiché l'acquisizione (compresa l'unione nella fotocamera) richiede in genere un po' di tempo (varia dalle secondi o minuti) per completare. L'avanzamento del comando si ottiene eseguire periodicamente il polling della videocamera utilizzando l'API /osc/commands/status e fileUrl è il risultato restituito al termine del comando. Quando delayProcessing è true, è l'URL assoluto dell'anteprima che può essere utilizzata come input in processPicture per elaborare l'immagine, altrimenti si tratta dell'URL assoluto dell'immagine finale elaborata.

Errori

  • missingParameter: sessionId mancante. Questo codice di errore è stato ritirato nel livello API 2.
  • invalidParameterName:il nome del parametro non è riconosciuto, ad esempio sessionId non è riconosciuto nel livello API 2.
  • invalidParameterValue: il nome del parametro di input è riconosciuto, ma il suo valore non è valido; ad esempio sessionId non esiste, non è più attivo o il tipo di dati non è corretto. Questo codice di errore è stato ritirato nel livello API 2.
  • disableCommand: il comando è attualmente disabilitato; ad esempio la fotocamera è in modalità di ripresa video. Questo codice di errore è stato aggiunto nel livello API 2.

I/O comando
Input comando (livello API 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Output comando (livello API 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Output comando (errore) (livello API 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Input comando (livello API 2) 
none
Output comando (livello API 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Output comando (errore) (livello API 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}