camera.listImages

Listet alle Bilder in der Kamera auf. Dieser Befehl wurde in API-Level 2 eingestellt. Bitte verwende stattdessen „camera.listFiles“.

Wenn eine Kamera die angeforderten Parameter nicht unterstützt, muss sie den Parameter für die Hardware maximal verfügbar sind. Ein seltener Fall kann z. B. sein, Die Anfrage: {entryCount: 500, maxSize: 2000}. Anstatt einen Fehler auszugeben, sollte sich die Antwort auf die maximal von der Kamera unterstützte Leistung beziehen. Beispiel: {entryCount: 100, maxSize: 200}. Bitte geben Sie für alle anderen Cases; Beispiel: Wenn die Anfrage {entryCount: 500, maxSize: -500} lautet, sollte den Fehler invalidParameterValue ausgeben, da maxSize negativ ist.

Parameter

  • entryCount::Gewünschte Anzahl der zurückzugebenden Einträge
  • maxSize:maximale Größe von Miniaturansichten max(thumbnail_width, thumbnail_height) zurückgegeben werden. Nur erforderlich, wenn includeThumb „true“ ist (siehe unten).
  • continuationToken: (optional): Ein intransparentes Fortsetzungs-Token des Typs „String“, das vom vorherigen listImages-Aufruf zurückgegeben wurde und zum Abrufen der nächsten Bilder verwendet wird. Lassen Sie diesen Parameter beim ersten listImages-Aufruf weg. Hinweis: Die Kamera ist für den Algorithmus verantwortlich, der das Token generiert.
  • includeThumb: (optional): Die Standardeinstellung ist true. Mit false können Sie Miniaturansichten aus dem Ergebnis ausschließen.

Ergebnisse

  • Einträge:Eine Liste der Bildeigenschaften. Jeder Eintrag sollte die folgenden Felder enthalten mit Ausnahme von Längen- und Breitengraden, die optional sind: <ph type="x-smartling-placeholder">
      </ph>
    • name: Name
    • uri: URI
    • size: Größe in Byte
    • dateTimeZone: Datum, Uhrzeit und Zeitzone für das Bild im Format: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Verwenden Sie das 24-Stunden-Format. Datum und Zeit durch ein Leerzeichen getrennt sind Zeichen. Die Zeitzone ist von der koordinierten Weltzeit (UTC) abweichen.
    • lat (optional): Der Breitengrad des Aufnahmeorts.
    • lng (optional): Längengrad des Aufnahmeorts.
    • width: Bildbreite
    • height: Bildhöhe
    • thumbnail: Base64-codierter String für die Miniaturansicht (wenn includeThumb == true).
  • totalEntries: Gesamtzahl der im Speicher gespeicherten Einträge.
  • continuationToken: (optional): Wird nur festgelegt, wenn das Ergebnis unvollständig ist. (unvollständig bedeutet alle Einträge, die nicht das letzte Bild enthalten). Zum Abrufen der verbleibenden muss der Client den listImages-Befehl noch einmal mit dem Token aufrufen.

Fehler

  • missingParameter:Alle erforderlichen Parameter wurden nicht angegeben. Beispiel: entryCount ist nicht angegeben.
  • invalidParameterName:Der Name des Eingabeparameters lautet nicht erkannt.
  • invalidParameterValue::Der Name des Eingabeparameters lautet erkannt, aber sein Wert ist ungültig; zum Beispiel continuationToken nicht vorhanden, liegt außerhalb des zulässigen Bereichs, seine Daten Typ ist falsch, der Datentyp von includeThumb ist falsch oder maxSize hat den falschen Datentyp, wenn includeThumb gleich true fest.

Befehls-E/A
Befehlseingabe 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Befehlsausgabe 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "uri": "image URI",
                "size": image size in bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00"
                "lat": 50.5324
                "lng": -120.2332
                "width": 2000
                "height": 1000
                "thumbnail": "ENCODEDSTRING"
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250,
        "continuationToken": "50"
    }
}
Befehlsausgabe (Fehler) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}