camera.listImages

Listet alle Bilder auf, die sich in der Kamera befinden. Dieser Befehl wurde in API-Level 2 verworfen. Bitte verwende stattdessen camera.listFiles.

Wenn eine Kamera die angeforderten Parameter nicht unterstützt, muss sie die maximal für die Hardware verfügbare Funktion zurückgeben. Ein seltener Fall könnte beispielsweise die Anfrage sein: {entryCount: 500, maxSize: 2000}. Anstatt einen Fehler auszugeben, sollte die Antwort auf der maximalen von der Kamera unterstützten Funktion basieren, z. B. {entryCount: 100, maxSize: 200}. In allen anderen Fällen sollten Fehler ausgegeben werden. Wenn die Anfrage beispielsweise {entryCount: 500, maxSize: -500} lautet, sollte der Fehler invalidParameterValue ausgegeben werden, 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). Nur erforderlich, wenn includeThumb „true“ ist (siehe unten).
  • continuationToken (optional): Ein intransparentes Fortsetzungstoken vom Typ 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): Der Standardwert ist true. Verwenden Sie false, um Miniaturansichten aus dem Ergebnis auszuschließen.

Ergebnisse

  • entries:Eine Liste der Bildeigenschaften. Jeder Eintrag sollte die folgenden Felder enthalten, mit Ausnahme der optionalen Felder „Breitengrad“ und „Längengrad“:
    • name: Name
    • uri: URI
    • size: Größe in Byte
    • dateTimeZone: Datum, Uhrzeit und Zeitzone des Bildes im Format YYYY:MM:DD HH:MM:SS+(-)HH:MM. Verwenden Sie das 24-Stunden-Format für die Uhrzeit. Datum und Uhrzeit sind durch ein leeres Zeichen getrennt. Die Zeitzone wird von der UTC-Zeit abweichen.
    • lat (optional): Breitengrad des Bildaufnahmeorts.
    • lng (optional): Längengrad des Aufnahmeorts.
    • width: Bildbreite
    • height: Bildhöhe
    • thumbnail: Base64-codierter String für das Thumbnail (wenn includeThumb == true).
  • totalEntries: Gesamtzahl der Einträge im Speicher.
  • continuationToken: (Optional) Wird nur festgelegt, wenn das Ergebnis unvollständig ist. Unvollständig bedeutet, dass Einträge nicht das letzte Bild enthalten. Zum Abrufen der verbleibenden Einträge muss der Client den Befehl listImages mit dem Token noch einmal aufrufen.

Fehler

  • missingParameter: Es wurde kein erforderlicher Parameter angegeben, z. B. entryCount.
  • invalidParameterName: Der Name des Eingabeparameters wird nicht erkannt.
  • invalidParameterValue: Der Name des Eingabeparameters wird erkannt, aber sein Wert ist ungültig. Beispiel: continuationToken existiert nicht, liegt außerhalb des Bereichs, der Datentyp ist falsch, der Datentyp includeThumb ist falsch oder maxSize hat den falschen Datentyp, wenn includeThumb wahr ist.

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."
    }
}