camera.listFiles

Listet alle Bilder/alle Videos/alle Bilder und Videos in der Kamera auf. Eventuell dauert es um alle Dateien aufzulisten. Dieser Befehl wurde in API-Ebene 2 hinzugefügt.

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

  • fileType: Typ der Dateien, die aufgelistet werden sollen. Folgende Typen sind zulässig: „image“, „video“, „all“.
  • startPosition: (optional): Die Position der ersten Datei, die angezeigt werden soll. in der Liste zurückgegeben werden. Wenn keine Angabe gemacht wird, ist die Startposition 0, was die mit der ersten Datei. Ist sie größer als die Position der letzten Datei, wird ein Normale Antwort mit leeren Einträgen in Ergebnissen anstelle einer Fehlerantwort.
  • entryCount::Gewünschte Anzahl der zurückzugebenden Einträge Falls ja die Anzahl der verbleibenden Dateien überschreiten, geben Sie einfach eine normale Antwort die verbleibenden Dateien anstatt eine Fehlerantwort zu erhalten.
  • maxThumbSize::Maximale Größe von Miniaturansichten max(thumbnail_width, thumbnail_height) zurückgegeben werden. Er wird auf null gesetzt, wenn der Client möchte keine Miniaturansichten im Ergebnis anzeigen.

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 der Datei.
    • fileUrl::Absolute URL der Datei, die verwendet werden kann, um direkt von der Kamera herunterzuladen
    • size: Größe der Datei in Byte.
    • dateTimeZone:Datum, Uhrzeit und Zeitzone für die Datei im Format: YYYY:MM:DD HH:MM:SS+(-)HH:MM Verwenden Sie das 24-Stunden-Format. Datum und Zeitangaben durch ein Leerzeichen getrennt. Die Zeitzone ist von der koordinierten Weltzeit (UTC) abweichen. Hinweis für Videos das Ende der Aufnahme darstellt.
    • lat (optional): Der Breitengrad des Ortes zum Zeitpunkt der Dateiaufnahme.
    • lng: (Optional) Längengrad des Standorts zum Zeitpunkt der Dateiaufnahme.
    • width:Breite des Bilds oder jedes Videoframes.
    • height:Höhe des Bildes oder jedes Videoframes.
    • thumbnail:Base64-codierter String für die Miniaturansicht der Datei (bei maxThumbSize != null).
    • isProcessed: Ein boolescher Wert, der angibt, ob die Datei verarbeitet (z.B. zusammengefügt) oder nur eine Vorschau. Dies sollte so sein: Standardeinstellung, es sei denn, delayProcessing ist auf „true“ gesetzt. Wenn ein verarbeitetes Bild vorhanden ist, sollte das entsprechende Vorschaubild nicht aufgeführt werden, selbst wenn es existiert. Andernfalls geben Sie das Vorschaubild an.
    • previewUrl::Standardwert ist ein leerer String, wenn delayProcessing wird nicht unterstützt oder wenn isProcessed gleich „false“ ist oder wenn das Vorschaubild angezeigt wird nie als Zwischenergebnis generiert. Andernfalls wird die URL Vorschaubild, das dem endgültigen Bild entspricht. Damit erstellen Sie die Übereinstimmung zwischen dem Vorschaubild und dem endgültigen Bild.
  • totalEntries: Gesamtzahl der Einträge von fileType in Speicher, z.B. wenn fileType auf "image" festgelegt ist, ist dies die Gesamtzahl der Bilder in Speicherplatz.

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 wird erkannt, aber sein Wert ist ungültig. Beispiel: entryCount ist negativ oder der Datentyp ist falsch.

Befehls-E/A
Befehlseingabe 
{
    "parameters": {
        "entryCount": 50,
        "maxThumbSize": 100
    }
}
Befehlsausgabe 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "fileUrl": "file URL",
                "size":  file size, # of bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00",
                "lat": 50.5324,
                "lng": -120.2332,
                "width": 2000,
                "height": 1000,
                "thumbnail": "ENCODEDSTRING",
                "isProcessed": true,
                "previewUrl": ""
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250
    }
}
Befehlsausgabe (Fehler) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter entryCount is negative."
    }
}