Camera.listFiles

Kameradaki tüm resimleri/tüm videoları/tüm resimleri ve videoları listeler. Tüm dosyaların listelenmesi için birkaç istek gerekebilir. Bu komut, API düzeyi 2'de eklenmiştir.

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

  • fileType: Listelenecek dosyaların türü şu üç dosyadan biri olmalıdır: "image", "video", "all".
  • startPosition: (İsteğe bağlı) Listede döndürülecek ilk dosyanın konumu. Atlanırsa başlangıç konumu 0 olur. Bu da ilk dosyayı temsil eder. Son dosyanın konumundan daha büyükse hata yanıtı yerine sonuçlarda boş girişlerle normal bir yanıt döndürün.
  • enterCount: Döndürülecek istenen giriş sayısı. Değer, kalan dosya sayısından fazlaysa hata yanıtı yerine, geri kalan gerçek dosyalarla birlikte normal bir yanıt döndürmeniz yeterlidir.
  • maxThumbSize: Küçük resim boyutlarının maksimum boyutu; max(thumbnail_width, olabileceğiniz küçük resim_yüksekliği). İstemci sonuçtan küçük resimleri çıkarmak istediğinde null olarak ayarlanır.

Sonuçlar

  • entries: Resim özelliklerinin listesi. Her giriş, isteğe bağlı olan enlem ve boylam hariç aşağıdaki alanları içermelidir:
    • name: Dosyanın adı.
    • fileUrl: Doğrudan kameradan indirmek için kullanılabilecek dosyanın mutlak URL'sidir.
    • size: Dosyanın bayt cinsinden boyutu.
    • dateTimeZone:Dosyanın tarih, saat ve saat dilimi (şu biçimde): 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. Bunun videolar için yakalamanın sonunu temsil ettiğini unutmayın.
    • lat: (İsteğe bağlı) Dosya yakalandığı sıradaki konumun enlemi.
    • lng: (İsteğe bağlı) Dosya yakalama sırasındaki konumun boylamı.
    • width: Resmin veya her bir video karesinin genişliği.
    • height: Resmin veya her bir video karesinin yüksekliği.
    • thumbnail (küçük resim): Dosyanın küçük resmi için Base64 olarak kodlanmış dize (maxThumbSize != null olduğunda).
    • isProcessed: Dosyanın işlendiğini (ör. birleştirilmiş) veya yalnızca bir önizleme olduğunu gösteren boole değeri. delayProcessing doğru değerine ayarlanmadığı sürece bu, varsayılan olarak doğru olmalıdır. İşlenmiş bir resim varsa ilgili önizleme resmi mevcut olsa bile listelenmemelidir. Aksi takdirde, önizleme resmini listeleyin.
    • previewUrl: delayProcessing desteklenmiyorsa veya isProcessed yanlış değerine eşitse ya da önizleme resmi hiçbir zaman ara sonuç olarak oluşturulmadıysa varsayılan olarak boş dizeyi alır. Aksi takdirde, nihai resme karşılık gelen önizleme resminin URL'si olur. Bu, önizleme resmi ile son resim arasında bağlantı kurmak için kullanılır.
  • totalEntries: Depolama alanındaki fileType girişlerinin toplam sayısı.Ör. fileType "image" ise depolama alanındaki toplam resim sayısıdır.

Hatalar

  • missingParameters: Gerekli herhangi bir parametre belirtilmemiş. Örneğin, entryCount belirtilmemiş.
  • geçersizParametreAdı: Giriş parametresi adı tanınmıyor.
  • geçersizParametre Değeri: Giriş parametresinin adı tanındı ancak parametrenin değeri geçersiz. Örneğin, entryCount negatif veya veri türü yanlış.

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