แสดงรูปภาพทั้งหมดในกล้อง เลิกใช้งานคำสั่งนี้ใน 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: URIsize: ขนาดในหน่วยไบต์dateTimeZone: วันที่ เวลา และเขตเวลาสำหรับรูปภาพ โดยอยู่ในรูปแบบYYYY:MM:DD HH:MM:SS+(-)HH:MMใช้รูปแบบ 24 ชั่วโมงสำหรับเวลา วันที่ และเวลาถูกคั่นด้วยช่องว่างหนึ่งช่อง อักขระ ปรับเขตเวลาจากเวลา UTClat: (ไม่บังคับ) ละติจูดของตำแหน่งจับภาพ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."
}
} |