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

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

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

พารามิเตอร์

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

ผลลัพธ์

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

ข้อผิดพลาด

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

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