Camera.listFiles

แสดงรูปภาพและวิดีโอทั้งหมด/วิดีโอทั้งหมด/รูปภาพและวิดีโอทั้งหมดในกล้อง อาจใช้เวลา คำขอหลายรายการเพื่อแสดงไฟล์ทั้งหมด เพิ่มคำสั่งนี้ใน API ระดับ 2

หมายเหตุ: รายชื่อไฟล์ต้องจัดเรียงตามเวลาที่จับภาพ โดยเริ่มจากใหม่สุดก่อน

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

พารามิเตอร์

• fileType: ประเภทไฟล์ที่จะแสดงควรเป็นแบบใดก็ได้ องค์ประกอบ 3 อย่าง ได้แก่ "รูปภาพ" "วิดีโอ" "ทั้งหมด"
• startPosition: (ไม่บังคับ) ตำแหน่งของไฟล์แรกที่ แสดงในรายการอีกครั้ง หากไม่ระบุ ตำแหน่งเริ่มต้นคือ 0 ซึ่งแสดงถึง ไฟล์แรก หากไฟล์มีขนาดใหญ่กว่าตำแหน่งของไฟล์ล่าสุด ให้แสดงผล การตอบกลับปกติพร้อมด้วยรายการว่างเปล่าในผลลัพธ์ แทนที่จะเป็นการตอบกลับข้อผิดพลาด
• entryCount: จำนวนรายการที่ต้องการจะแสดงผล หากใช่ มากกว่าจำนวนไฟล์ที่เหลือ เพียงแสดงการตอบสนองปกติด้วย ไฟล์ที่เหลือแทนที่จะเป็นการตอบสนองต่อข้อผิดพลาด
• maxThumbSize: ขนาดสูงสุดของภาพขนาดย่อ สูงสุด(ความกว้าง_ภาพขนาดย่อ, ความสูง_ภาพขนาดย่อ) โดยตั้งค่าเป็น null เมื่อไคลเอ็นต์ ไม่ต้องการรวมภาพขนาดย่อจากผลการค้นหา

ผลลัพธ์

• รายการ: รายการคุณสมบัติของรูปภาพ แต่ละรายการควรมีฟิลด์ต่อไปนี้ ยกเว้นละติจูดและลองจิจูดซึ่งเป็นตัวเลือก
  • name: ชื่อไฟล์
  • fileUrl: URL ที่สมบูรณ์ของไฟล์ ซึ่งใช้ดาวน์โหลดจากกล้องได้โดยตรง
  • size: ขนาดเป็นไบต์ของไฟล์
  • dateTimeZone: วันที่ เวลา และเขตเวลาของไฟล์ในรูปแบบ YYYY:MM:DD HH:MM:SS+(-)HH:MM ใช้รูปแบบ 24 ชั่วโมงสำหรับเวลา วันที่และ คั่นเวลาด้วยอักขระว่าง 1 ตัว ปรับเขตเวลาจากเวลา UTC โปรดทราบ แสดงถึงช่วงสุดท้ายของการบันทึกวิดีโอ
  • lat: (ไม่บังคับ) ละติจูดของตำแหน่งในขณะที่เก็บไฟล์
  • lng: (ไม่บังคับ) ลองจิจูดของตำแหน่งในขณะที่บันทึกไฟล์
  • width: ความกว้างของรูปภาพหรือวิดีโอแต่ละเฟรม
  • ความสูง: ความสูงของรูปภาพหรือเฟรมวิดีโอแต่ละเฟรม
  • ภาพขนาดย่อ: สตริงที่เข้ารหัส Base64 สำหรับภาพขนาดย่อของไฟล์ (เมื่อ maxThumbSize != null)
  • isProcessed: ค่าบูลีนที่ระบุว่าไฟล์ ผ่านการประมวลผล (เช่น เย็บต่อกัน) หรือเป็นเพียงตัวอย่างเท่านั้น กรณีนี้ควรเป็นจริงภายในวันที่ ค่าเริ่มต้น เว้นแต่จะตั้งค่า delayProcessing เป็น "จริง" หากมีรูปภาพที่ประมวลผลแล้ว รูปภาพตัวอย่างที่เกี่ยวข้องไม่ควรแสดงอยู่ แม้ว่าจะมีอยู่ก็ตาม ไม่เช่นนั้น ให้ระบุรูปภาพตัวอย่าง
  • previewUrl: ค่าเริ่มต้นเป็นสตริงว่างเปล่าหาก delayProcessing ไม่ได้รับการสนับสนุนหรือเมื่อ isProcessed เท่ากับเท็จ หรือเมื่อรูปภาพตัวอย่าง ไม่เคยสร้างเป็นผลลัพธ์ระดับกลาง มิฉะนั้นจะเป็น URL ของ ภาพตัวอย่างที่สอดคล้องกับภาพสุดท้าย ใช้เพื่อสร้าง ความสอดคล้องกันระหว่างรูปภาพตัวอย่างและรูปภาพสุดท้าย
• totalEntries: จำนวนรายการทั้งหมด fileType ใน พื้นที่เก็บข้อมูล เช่น หาก fileType คือ "image" แสดงว่าคือจำนวนรูปภาพทั้งหมดใน พื้นที่เก็บข้อมูล

ข้อผิดพลาด

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

Command I/O
อินพุตคำสั่ง	{ "parameters": { "entryCount": 50, "maxThumbSize": 100 } }
เอาต์พุตคำสั่ง	{ "results": { "entries": [ { "name": "abc", "fileUrl": "file URL", "size": file size, # of bytes, "dateTimeZone": "2014:12:27 08:00:00+08:00", "lat": 50.5324, "lng": -120.2332, "width": 2000, "height": 1000, "thumbnail": "ENCODEDSTRING", "isProcessed": true, "previewUrl": "" } ... { ... } ], "totalEntries": 250 } }
เอาต์พุตคำสั่ง (ข้อผิดพลาด)	{ "error": { "code": "invalidParameterValue", "message": "Parameter entryCount is negative." } }