รูปภาพโปรเซสเซอร์

ประมวลผลรูปภาพซึ่งบันทึกไว้ก่อนหน้าแต่ยังไม่ได้ประมวลผล คำสั่งนี้ใช้ได้ในกรณีที่คุณรองรับ delayProcessing ตั้งแต่ การประมวลผลใช้เวลานาน หากคุณไม่รองรับ delayProcessing คำขอสำหรับคำสั่งนี้ควรล้มเหลวโดยมีรหัสข้อผิดพลาด disabledCommand เพิ่มคำสั่งนี้ใน API ระดับ 2

พารามิเตอร์

  • previewFileUrls: รายการ URL ของรูปภาพที่ยังไม่ได้ประมวลผล หากต้องการประมวลผลรูปภาพที่ไม่ได้ประมวลผลทั้งหมดในกล้อง รูปภาพนั้นจะเป็นแบบ ["ทั้งหมด"] ต้องระบุ ถ้ากล้องมีปัญหาในการประมวลผลภาพ ไม่ตอบกลับโดยมีข้อผิดพลาด แต่ไม่ต้องสนใจ URL นั้นและดำเนินการต่อ และกรณีร้ายแรงอาจเป็น previewToFinalFileUrls คือ แสดงผลเป็น JSONObject ที่ว่างเปล่า

ผลลัพธ์

  • previewToFinalFileUrls: JSONObject ของ JSON <key, value=""> โดยที่แต่ละคีย์คือ URL ที่สมบูรณ์ของรูปภาพตัวอย่าง และแต่ละคีย์ คือรูปภาพที่ประมวลผลขั้นสุดท้ายที่เกี่ยวข้องและใช้เพื่อดาวน์โหลด จากกล้องได้โดยตรง โปรดทราบว่าคำสั่งนี้คล้ายกับ Camera.takePicture และจะไม่แสดงผล previewToFinalFileUrls ทันที (ยกเว้นกรณีมุมที่จะอธิบายภายหลังในย่อหน้านี้) นับตั้งแต่ การประมวลผล (รวมถึงการต่อภาพในกล้อง) มักจะใช้เวลาสักครู่ (แตกต่างกันไป จากวินาทีเหลือนาที) เพื่อให้เสร็จสมบูรณ์ ได้รับความคืบหน้าของคําสั่งแล้ว ด้วยการสำรวจกล้องเป็นระยะๆ โดยใช้ /osc/commands/status API และ previewToFinalFileUrls คือผลลัพธ์ที่แสดงเมื่อคำสั่ง เสร็จสิ้น หากการเชื่อมต่อกับกล้องขาดหายก่อนที่คำสั่งจะเสร็จสิ้น ลูกค้าจะใช้ listFiles ได้ เพื่อดู URL ของรูปภาพสุดท้ายเมื่อเชื่อมต่อกับกล้องอีกครั้ง หรือ ออกคำสั่ง projectPicture อื่น ซึ่งควรแสดงผล previewToFinalFileUrls ทันทีถ้ารูปภาพนั้นอยู่ ประมวลผลก่อนการเชื่อมต่ออีกครั้ง</key,>

ข้อผิดพลาด

  • disableCommand: หากคุณไม่รองรับการประมวลผลล่าช้า
  • invalidParametersName: ชื่อพารามิเตอร์อินพุตคือ ไม่รู้จัก
  • invalidParameterValue: ชื่อพารามิเตอร์อินพุตคือ รู้จัก แต่ค่าไม่ถูกต้อง เช่น URL ใน previewFileUrls ไม่ถูกต้อง

Command I/O
อินพุตคำสั่ง 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
เอาต์พุตคำสั่ง 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
เอาต์พุตคำสั่ง (ข้อผิดพลาด) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}