kamera.listeResimleri

Kameradaki tüm resimleri listeler. Bu komut, API düzeyi 2'de kullanımdan kaldırılmıştır. Lütfen bunun yerine camera.listFiles politikasını kullanın.

Kamera istenen parametreleri desteklemiyorsa kamera, donanım için mümkün olan maksimum kapasiteyi döndürmelidir. Örneğin, nadiren de olsa şu istek verilebilir: {entryCount: 500, maxSize: 2000}. Hata bildirmek yerine yanıt, kamera tarafından desteklenen maksimum kapasiteye dayalı olmalıdır. Örneğin: {entryCount: 100, maxSize: 200}. Lütfen diğer tüm durumlar için hataları belirtin. Örneğin, istek {entryCount: 500, maxSize: -500} olduğunda, maxSize negatif olduğundan invalidParameterValue hatası verilmelidir.

Parametreler

  • enterCount: Döndürülecek istenen giriş sayısı.
  • maxSize: Küçük resim resimlerinin maksimum boyutu; maks. Yalnızca includeThumb doğru olduğunda gereklidir (aşağıda).
  • continuationToken: (İsteğe bağlı) Önceki listImages çağrısı tarafından döndürülen ve sonraki resimleri almak için kullanılan, dize türünde bir opak devam jetonu. İlk listImages çağrısında bu parametreyi atlayın. Not: Jetonu oluşturan algoritmadan kamera sorumludur.
  • includeThumb: (İsteğe bağlı) Varsayılan olarak true değerine ayarlanır. Küçük resimleri sonuçtan çıkarmak için false işaretini kullanın.

Sonuçlar

  • entries: Resim özelliklerinin listesi. Her giriş, isteğe bağlı olan enlem ve boylam hariç aşağıdaki alanları içermelidir:
    • name: Ad
    • uri: URI
    • size: Bayt cinsinden boyut
    • dateTimeZone: Resmin tarih, saat ve saat dilimi (şu biçimdedir): YYYY:MM:DD HH:MM:SS+(-)HH:MM. Saat için 24 saatlik biçimi kullanın. Tarih ve saat tek bir boş karakterle ayrılır. Saat dilimi, UTC saatine göre farklıdır.
    • lat: (İsteğe bağlı) Görüntünün çekildiği konumun enlemi.
    • lng: (İsteğe bağlı) Görüntünün çekildiği konumun boylamı.
    • width: Resim genişliği
    • height: Resim yüksekliği
    • thumbnail: Küçük resim için Base64 olarak kodlanmış dize (includeThumb == true olduğunda).
  • totalEntries: Depolama alanındaki toplam giriş sayısı.
  • continuationToken: (İsteğe bağlı) Yalnızca sonuç eksikse ayarlayın (eksik, son resmi içermeyen tüm girişler anlamına gelir). Kalan girişleri getirmek için istemcinin jetonla tekrar listImages komutunu çağırması gerekir.

Hatalar

  • missingParameters: Gerekli herhangi bir parametre belirtilmemiş. Örneğin, entryCount belirtilmemiş.
  • geçersizParametreAdı: Giriş parametresi adı tanınmıyor.
  • Geçersiz ParametreValue: Giriş parametresi adı tanınıyor ancak parametrenin değeri geçersiz. Örneğin, continuationToken mevcut değil, aralık dışında, veri türü yanlış, includeThumb veri türü yanlış veya includeThumb doğru olduğunda maxSize yanlış veri türüne sahip.

Komut G/Ç
Komut Girişi 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Komut Çıktısı 
{
    "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"
    }
}
Komut Çıktısı (Hata) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}