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 hardware. Misalnya, permintaan yang jarang terjadi mungkin adalah permintaan: {entryCount: 500, maxSize: 2000}. Daripada menampilkan error, respons harus didasarkan pada kemampuan maksimum yang didukung oleh kamera, seperti: {entryCount: 100, maxSize: 200}. Tampilkan error untuk semua kasus lainnya; misalnya, jika permintaan adalah {entryCount: 500, maxSize: -500}, error invalidParameterValue akan ditampilkan karena maxSize bernilai negatif.

Parameter

  • entryCount: Jumlah entri yang diinginkan untuk ditampilkan.
  • maxSize: Ukuran maksimum gambar thumbnail; max(thumbnail_width, thumbnail_height). Hanya diperlukan jika includeThumb bernilai benar (di bawah).
  • continuationToken: (Opsional) Token lanjutan 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 membuat token.
  • includeThumb: (Opsional) Nilai defaultnya adalah true. Gunakan false untuk menghapus gambar thumbnail dari hasil.

Hasil

  • entri: Daftar properti gambar. Setiap entri harus berisi kolom berikut, kecuali 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 menampilkan waktu. Tanggal dan waktu dipisahkan oleh satu karakter kosong. 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 berenkode base64 untuk gambar thumbnail (saat includeThumb == true).
  • totalEntries: Jumlah total entri di penyimpanan.
  • continuationToken: (Opsional) Menetapkan hanya jika hasilnya tidak lengkap (tidak lengkap berarti listingan yang tidak menyertakan gambar terakhir). Untuk mengambil entri yang tersisa, 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 tidak dikenali.
  • invalidParameterValue: Nama parameter input dikenali, tetapi nilainya tidak valid; misalnya, continuationToken tidak ada, berada di luar rentang, jenis datanya salah, jenis data includeThumb salah, atau maxSize memiliki jenis data yang salah jika includeThumb bernilai benar.

Perintah I/O

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."
    }
}