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