kamera.listObrazy

Wyświetla listę wszystkich obrazów w aparacie. To polecenie zostało wycofane w interfejsie API poziomu 2. Zamiast niej używaj elementu camera.listFiles.

Jeśli kamera nie obsługuje żądanych parametrów, musi zwracać błąd z maksymalnymi możliwościami sprzętowymi. Rzadkim przypadkiem może być np. żądanie: {entryCount: 500, maxSize: 2000}. Zamiast zgłaszać błąd, odpowiedź powinna opierać się na maksymalnych możliwościach kamery, na przykład: {entryCount: 100, maxSize: 200}. Błędy w pozostałych przypadkach przypadki; na przykład jeśli żądanie to {entryCount: 500, maxSize: -500}, powinien zgłosić błąd invalidParameterValue, ponieważ maxSize ma wartość ujemną.

Parametry

  • entryCount: wymagana liczba wpisów do zwrócenia.
  • maxSize: maksymalny rozmiar miniatur miniatur. max(Miniatura_szerokość, wysokość_miniatury). Wymagane tylko wtedy, gdy includeThumb ma wartość prawda (poniżej).
  • continuationToken: (opcjonalny) nieprzezroczysty token kontynuacji typu ciąg znaków, zwracany przez poprzednie wywołanie listImages, używany do pobierania następnych obrazów. Pomiń ten parametr przy pierwszym wywołaniu funkcji listImages. Uwaga: za algorytm, który generuje token, odpowiada kamera.
  • includeThumb: (opcjonalnie) wartość domyślna true. Użyj false, aby pominąć miniatury w wynikach.

Wyniki

  • entries: lista właściwości obrazu. Każdy wpis powinien zawierać następujące pola oprócz szerokości i długości geograficznej, które są opcjonalne:
    • name: nazwa
    • uri: URI
    • size: rozmiar w bajtach
    • dateTimeZone: data, godzina i strefa czasowa zdjęcia w formacie: YYYY:MM:DD HH:MM:SS+(-)HH:MM Podaj godzinę w formacie 24-godzinnym. Data i godzinę są oddzielone jednym pustym znaku. Strefa czasowa jest odsunięta od czasu UTC.
    • lat: (opcjonalnie) szerokość geograficzna lokalizacji, w której zrobiono zdjęcie.
    • lng: (opcjonalnie) długość miejsca, w którym zrobiono zdjęcie.
    • width: szerokość obrazu
    • height: wysokość obrazu
    • thumbnail: ciąg zakodowany w standardzie Base64 dla obrazu miniatury (gdy includeThumb == true).
  • totalEntries: łączna liczba wpisów w pamięci.
  • continuationToken: (opcjonalny) ustawiany tylko wtedy, gdy wynik jest niepełny. (Niekompletne oznacza każdą wizytówkę, która nie zawiera ostatniego zdjęcia). Do pobrania pozostałe wpisy, klient powinien ponownie wywołać polecenie listImages z tokenem.

Błędy

  • missingParameter:nie określono żadnego wymaganego parametru; na przykład entryCount nie został określony.
  • invalidParametrName:nazwa parametru wejściowego to Nie rozpoznano.
  • invalidParameterValue::nazwa parametru wejściowego to rozpoznano, ale jego wartość jest nieprawidłowa; np. continuationToken nie istnieje, jest poza zakresem, jego dane typ danych jest nieprawidłowy, typ danych includeThumb jest nieprawidłowy lub maxSize ma nieprawidłowy typ danych, gdy includeThumb to true (prawda).

Polecenie I/O
Dane wejściowe polecenia 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Dane wyjściowe polecenia 
{
    "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"
    }
}
Dane wyjściowe polecenia (błąd) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}