camera.listImages

Mencantumkan semua gambar di kamera. Perintah ini tidak digunakan lagi di API level 2. Sebagai gantinya, gunakan camera.listFiles.

Jika kamera tidak mendukung parameter yang diminta, kamera harus menampilkan kemampuan maksimum yang tersedia untuk perangkat keras. Misalnya, kasus yang jarang terjadi mungkin permintaan: {entryCount: 500, maxSize: 2000}. Alih-alih menampilkan pesan {i>error<i}, respons harus didasarkan pada kemampuan maksimum yang didukung oleh kamera, misalnya: {entryCount: 100, maxSize: 200}. Tampilkan kesalahan untuk semua lainnya kasus; misalnya, jika permintaan adalah {entryCount: 500, maxSize: -500}, harus menampilkan error invalidParameterValue karena maxSize negatif.

Parameter

  • entryCount: Jumlah entri yang diinginkan untuk ditampilkan.
  • maxSize: Ukuran maksimum gambar thumbnail; max(thumbnail_width, thumbnail_height). Hanya wajib jika includeThumb benar (di bawah).
  • continuationToken: (Opsional) Token kelanjutan buram dari string jenis, yang ditampilkan oleh panggilan listImages sebelumnya, digunakan untuk mengambil gambar berikutnya. Hapus parameter ini untuk panggilan listImages pertama. Catatan: Kamera bertanggung jawab atas algoritma yang menghasilkan token.
  • includeThumb: (Opsional) Nilai defaultnya adalah true. Gunakan false untuk menghilangkan gambar thumbnail dari hasil.

Hasil

  • entri: Daftar properti gambar. Setiap entri harus berisi kolom berikut kecuali untuk lintang dan bujur, yang bersifat opsional:
    • name: Nama
    • uri: URI
    • size: Ukuran dalam byte
    • dateTimeZone: Tanggal, waktu, dan zona waktu untuk gambar, dalam format: YYYY:MM:DD HH:MM:SS+(-)HH:MM. Gunakan format 24 jam untuk waktu. Tanggal dan waktu dipisahkan dengan satu kolom kosong karakter. Zona waktu berbeda dari waktu UTC.
    • lat: (Opsional) Lintang lokasi pengambilan gambar.
    • lng: (Opsional) Bujur lokasi pengambilan gambar.
    • width: Lebar gambar
    • height: Tinggi gambar
    • thumbnail: String yang dienkode Base64 untuk gambar thumbnail (saat includeThumb == true).
  • totalEntries: Jumlah total entri dalam penyimpanan.
  • continuationToken: (Opsional) Tetapkan hanya jika hasilnya tidak lengkap (tidak lengkap berarti listingan yang tidak menyertakan gambar terakhir). Untuk mengambil sisa entri, klien harus memanggil perintah listImages lagi dengan token.

Error

  • missingParameter: Parameter apa pun yang diperlukan tidak ditentukan; misalnya, entryCount tidak ditentukan.
  • invalidParameterName: Nama parameter input adalah tidak dikenal.
  • invalidParameterValue: Nama parameter input adalah dikenali, tetapi nilainya tidak valid; misalnya, continuationToken tidak ada, berada di luar jangkauan, datanya jenis salah, jenis data includeThumb salah, atau maxSize memiliki jenis data yang salah saat includeThumb benar.

I/O Perintah
Input Perintah 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
Output Perintah 
{
    "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"
    }
}
Output Perintah (Error) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}