Kameradaki tüm resimleri listeler. Bu komut, API düzey 2'de kullanımdan kaldırılmıştır.
Lütfen bunun yerine camera.listFiles
politikasını kullanın.
Kamera istenen parametreleri desteklemiyorsa kameranın
donanım için kullanılabilir olan maksimum kapasitedir. Örneğin, ekip arkadaşlarınızın
istek: {entryCount: 500, maxSize: 2000}
. Hata vermek 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; örneğin, istek {entryCount: 500, maxSize: -500}
olduğunda
maxSize
negatif olduğundan invalidParameterValue
hatası vermelidir.
Parametreler
- entryCount: Döndürülecek istenen giriş sayısı.
- maxSize: Küçük resimlerin maksimum boyutu; max(küçük resim_genişliği, küçük resim_yüksekliği).
Yalnızca
includeThumb
doğru (aşağıda) değerine ayarlandığında gereklidir. - continuationToken: (İsteğe bağlı) Sonraki resimleri almak için kullanılan, önceki
listImages
çağrısı tarafından döndürülen, tür dizesinin opak bir devamlılık jetonu. İlklistImages
çağrısında bu parametreyi kullanmayın. Not: Jetonu oluşturan algoritmadan kamera sorumludur. - includeThumb: (İsteğe bağlı) Varsayılan olarak
true
değerine ayarlanır. Sonuçtan küçük resimleri çıkarmak içinfalse
kullanın.
Sonuçlar
- girişler: Resim özelliklerinin listesi. Her giriş aşağıdaki alanları içermelidir
(isteğe bağlı olan enlem ve boylamlar hariç):
name
: Aduri
: URIsize
: Bayt cinsinden boyutdateTimeZone
: Resmin tarihi, saati ve saat dilimi. Şu biçimdedir:YYYY:MM:DD HH:MM:SS+(-)HH:MM
. Saati 24 saat biçimini kullanarak belirtin. Tarih ve zaman aralığı tek bir boşlukla karakteriyle ayrılır. Saat diliminin, UTC saatiyle farkı var.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ğiheight
: Resim yüksekliğithumbnail
: Küçük resim için Base64 olarak kodlanmış dize (includeThumb == true
) tıklayın.
- 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). Kalanları getirmek için
istemcinin, jetonla
listImages
komutunu yeniden çağırması gerekir.
Hatalar
- missingparameter: Gerekli herhangi bir parametre belirtilmemiş;
örneğin,
entryCount
belirtilmemiş. - geçersizParametreAdı: Giriş parametresinin adı: tanınmıyor.
- invalidParameterValue: Giriş parametresinin adı:
ancak değeri geçersiz; örneğin,
continuationToken
mevcut değil, aralık dışında, verileri yanlıştır,includeThumb
veri türü yanlıştır veyaincludeThumb
şu durumda olduğundamaxSize
'nin veri türü yanlış: doğru.
Komut G/Ç | |
---|---|
Komut Girişi | { "parameters": { "entryCount": 50, "maxSize": 100, "includeThumb": true } } |
Komut Çıkışı | { "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 Çıkışı (Hata) | { "error": { "code": "invalidParameterValue", "message": "Parameter continuationToken is out of range." } } |