รูปภาพของกล้อง

แสดงรายการรูปภาพทั้งหมดในกล้อง คำสั่งนี้เลิกใช้งานแล้วใน API ระดับ 2 โปรดใช้ camera.listFiles แทน

หากกล้องไม่รองรับพารามิเตอร์ที่ขอ กล้องจะต้องแสดงความสามารถสูงสุดที่ฮาร์ดแวร์มี ตัวอย่างเช่น ในบางกรณีที่พบไม่บ่อยนักอาจเป็นคำขอ {entryCount: 500, maxSize: 2000} แทนที่จะแสดงข้อผิดพลาด การตอบสนองควรขึ้นอยู่กับความสามารถสูงสุดที่กล้องรองรับ เช่น {entryCount: 100, maxSize: 200} โปรดแสดงข้อผิดพลาดสำหรับกรณีอื่นๆ ทั้งหมด เช่น เมื่อคำขอคือ {entryCount: 500, maxSize: -500} ควรแสดงข้อผิดพลาด invalidParameterValue เนื่องจาก maxSize เป็นค่าลบ

พารามิเตอร์

  • entryCount: จำนวนรายการที่ต้องการแสดงผล
  • maxSize: ขนาดสูงสุดของภาพขนาดย่อ; max(thumbnail_width, thumbs_height) จำเป็นเมื่อ includeThumb เป็นจริง (ด้านล่าง) เท่านั้น
  • continuationToken: (ไม่บังคับ) โทเค็นความต่อเนื่องแบบทึบแสงของสตริงประเภท ที่แสดงผลโดยการเรียก listImages ก่อนหน้า ใช้สำหรับเรียกข้อมูลรูปภาพถัดไป ไม่ใช้พารามิเตอร์นี้สำหรับการเรียก listImages ครั้งแรก หมายเหตุ: กล้องมีหน้าที่รับผิดชอบอัลกอริทึมที่สร้างโทเค็น
  • includeThumb: (ไม่บังคับ) ค่าเริ่มต้นคือ true ใช้ false เพื่อละเว้นภาพปกในผลการค้นหา

ผลลัพธ์

  • entries: รายการพร็อพเพอร์ตี้รูปภาพ แต่ละรายการควรมีช่องต่อไปนี้ ยกเว้นละติจูดและลองจิจูด (ไม่บังคับ)
    • name: ชื่อ
    • uri: URI
    • size: ขนาดในหน่วยไบต์
    • dateTimeZone: วันที่ เวลา และเขตเวลาของรูปภาพในรูปแบบ YYYY:MM:DD HH:MM:SS+(-)HH:MM ใช้รูปแบบ 24 ชั่วโมงสำหรับเวลา วันที่และเวลา ถูกคั่นด้วยอักขระว่าง 1 ตัว เขตเวลาออฟเซ็ตจากเวลา UTC
    • lat: (ตัวเลือก) ละติจูดของตำแหน่งถ่ายภาพ
    • lng: (ไม่บังคับ) ลองจิจูดของตำแหน่งถ่ายภาพ
    • width: ความกว้างของรูปภาพ
    • height: ความสูงของรูปภาพ
    • thumbnail: สตริงที่เข้ารหัส Base64 สำหรับภาพขนาดย่อ (เมื่อ includeThumb == true)
  • totalEntries: จำนวนรายการทั้งหมดในพื้นที่เก็บข้อมูล
  • continuationToken: (ไม่บังคับ) ตั้งค่าเฉพาะในกรณีที่ผลลัพธ์ไม่สมบูรณ์ (ไม่สมบูรณ์หมายถึงข้อมูลใดก็ตามที่ไม่มีรูปภาพสุดท้าย) หากต้องการดึงรายการที่เหลือ ไคลเอ็นต์ควรเรียกใช้คำสั่ง listImages อีกครั้งด้วยโทเค็น

ข้อผิดพลาด

  • missingParameters: ไม่มีการระบุพารามิเตอร์ที่จำเป็น เช่น ไม่ได้ระบุ entryCount
  • invalidparameterName: ระบบไม่รู้จักชื่อพารามิเตอร์ที่ป้อน
  • invalidParametersValue: จดจำชื่อพารามิเตอร์อินพุตได้ แต่ค่าไม่ถูกต้อง เช่น ไม่มี continuationToken อยู่นอกช่วง ประเภทข้อมูลไม่ถูกต้อง ประเภทข้อมูล includeThumb ไม่ถูกต้อง หรือ maxSize มีข้อมูลผิดเมื่อ includeThumb เป็นจริง

คำสั่ง I/O
อินพุตคำสั่ง 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
เอาต์พุตคำสั่ง 
{
    "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"
    }
}
เอาต์พุตคำสั่ง (ข้อผิดพลาด) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}