camera.getImage

Gibt ein Bild in voller oder skalierter Größe anhand seines URI zurück. Zu den Eingabeparametern gehört die Auflösung. Dies ist der einzige Befehl, der zurückgegeben werden sollte: Content-Type: image/jpeg. Alle anderen Befehle geben Content-Type: application/json;charset=utf-8 zurück. Dieser Befehl wurde in API-Level 2 verworfen.

Parameter

  • fileUri:URI der Zieldatei. Hersteller entscheiden, ob sie absolute oder relative URIs verwenden. Clients können dies als intransparente Kennung behandeln.
  • maxSize (optional): Maximale Größe des angeforderten Bildes; max(scaledimage_width, scaledimage_height). Wenn maxSize weggelassen wird oder größer als das Bild in voller Größe ist, wird das Bild in voller Größe zurückgegeben.

Ergebnisse

  • content:Binäre Bilddaten, einschließlich entsprechender (z. B. skalierter) Metadaten im Bildheader.

Fehler

  • missingParameter: Der erforderliche fileUri ist nicht angegeben.
  • invalidParameterName:Der Name eines Eingabeparameters wurde nicht erkannt.
  • invalidParameterValue: Der Name des Eingabeparameters wird erkannt, aber sein Wert ist ungültig. Beispiel: Der Wert fileUri existiert nicht, der Datentyp ist falsch oder maxSize hat den falschen Datentyp.

Befehls-E/A

Befehlseingabe
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
Befehlsausgabe
Image binary data
Befehlsausgabe (Fehler)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}