Camera.listFiles

Kameradaki tüm resimleri/tüm videoları/tüm resimleri ve videoları listeler. Yaklaşık bir birkaç istek var. Bu komut API düzeyi 2'de eklendi.

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

  • fileType: Listelenecek dosyaların türü. Dosya türü şunlardan biri olmalıdır: üçü vardır: “image”, ”video”, ”all”.
  • startPosition: (İsteğe bağlı) İlk dosyanın konumu döndürülmez. Atlanırsa başlangıç konumu 0 olur (bu değer, ilk dosya olabilir. Son dosyanın konumundan büyükse bir boş girişlerle hata yanıtı yerine normal yanıt.
  • entryCount: Döndürülecek istenen giriş sayısı. Eğer daha fazla sayıda dosya içeriyorsa, normal bir yanıt döndürerek hata yanıtı yerine kalan gerçek dosyalar.
  • maxThumbSize: Küçük resimlerin maksimum boyutu; max(küçük resim_genişliği, küçük resim_yüksekliği). İstemci kullanıldığında null olarak ayarlanır Sonuçta küçük resimleri çıkarmak istiyor.

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: Dosyanın adı.
    • fileUrl: Doğrudan kameradan indirmek için kullanılabilen dosyanın mutlak URL'si.
    • size: Dosyanın bayt cinsinden boyutu.
    • dateTimeZone: Dosyanın şu biçimdeki tarih, saat ve saat dilimi: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Saati 24 saat biçimini kullanarak belirtin. Tarih ve bir boş karakterle ayrılır. Saat diliminin, UTC saatiyle farkı var. Lütfen bunu göz önünde bulundurun anlamına gelir.
    • lat: (İsteğe bağlı) Dosyanın yakalandığı andaki konumun enlemi.
    • lng: (İsteğe bağlı) Dosyanın yakalandığı andaki konumun boylamı.
    • width: Resmin veya her video karesinin genişliği.
    • height: Resmin veya her video karesinin yüksekliği.
    • thumbnail: Dosyanın küçük resmi için Base64 olarak kodlanmış dize (maxThumbSize != null olduğunda).
    • isProcessed: Dosyanın doğru olup olmadığını gösteren boole değeri işlenmiş (ör. birleştirilmiş) veya yalnızca bir önizlemedir. Bu, delayProcessing politikası doğru değerine ayarlanmadıkça varsayılan olarak kullanılır. İşlenmiş bir resim varsa önizleme resmi mevcut olsa bile listelenmemelidir. Aksi takdirde, önizleme resmini listeleyin.
    • previewUrl: delayProcessing ise varsayılan olarak boş dizeyi kullanın desteklenmediğinde veya isProcessed yanlış değerine eşit olduğunda ya da önizleme resmi hiçbir zaman ara sonuç olarak oluşturulmamışsa, aksi takdirde söz konusu öğenin URL'si olur. son resme karşılık gelen önizleme resmi. Bu, dönüşüm hunisinin her yerinde önizleme resmi ile son resim arasındaki yazışmayı nasıl tanımlar?
  • totalEntries: Şu konumdaki toplam fileType giriş sayısı: depolama, ör. fileType "image" ise depolama alanına sahip olursunuz.

Hatalar

  • missingparameter: Gerekli herhangi bir parametre belirtilmemiş; örneğin, entryCount belirtilmemiş.
  • geçersizParametreAdı: Giriş parametresinin adı: tanınmıyor.
  • invalidParameterValue: Giriş parametresinin adı tanındı. ancak değeri geçersiz; örneğin, entryCount negatif veya veri türünün yanlış olması.

Komut G/Ç
Komut Girişi 
{
    "parameters": {
        "entryCount": 50,
        "maxThumbSize": 100
    }
}
Komut Çıkışı 
{
    "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
    }
}
Komut Çıkışı (Hata) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter entryCount is negative."
    }
}