ประมวลผลรูปภาพ ซึ่งถ่ายไว้ก่อนหน้านี้ แต่ยังไม่ได้ประมวลผล
คำสั่งนี้จะเกี่ยวข้องในกรณีที่คุณรองรับ delayProcessing
เท่านั้น เนื่องจากการประมวลผลใช้เวลานาน หากไม่รองรับ delayProcessing
คำขอสำหรับคำสั่งนี้ควรล้มเหลวเนื่องจากรหัสข้อผิดพลาด disabledCommand
มีการเพิ่มคำสั่งนี้ใน API ระดับ 2
พารามิเตอร์
- previewFileUrls: รายการ URL ของรูปภาพที่ยังไม่ได้ประมวลผล
หากคุณต้องการประมวลผลรูปภาพที่ไม่ได้ประมวลผลทั้งหมดในกล้อง รูปภาพจะเป็น [“all”]
ไม่สามารถเว้นว่างได้ หากกล้องมีปัญหาในการประมวลผลรูปภาพ กล้องไม่ตอบสนองพร้อมกับมีข้อผิดพลาด แต่ไม่ควรไม่สนใจ URL นั้นและไปต่อยังตัวอื่น โดยกรณีสุดโต่ง (
previewToFinalFileUrls
) อาจแสดงผลเป็น JSONObject ที่ว่างเปล่า
ผลลัพธ์
- previewToFinalFileUrls: คู่ JSONObject ของ JSON <key, value="">
โดยแต่ละคีย์จะเป็น URL ที่สมบูรณ์ของรูปภาพตัวอย่าง และแต่ละคีย์คือรูปภาพที่ประมวลผลขั้นสุดท้ายที่เกี่ยวข้อง และสามารถใช้เพื่อดาวน์โหลด
จากกล้องถ่ายรูปได้โดยตรง โปรดทราบว่าคำสั่งนี้คล้ายกับcamera.takePicture และไม่แสดง
previewToFinalFileUrls
ทันที (ยกเว้นในมุมที่จะอธิบายภายหลังในย่อหน้านี้) เนื่องจากการประมวลผล (รวมถึงการต่อภาพในกล้อง) มักใช้เวลาสักครู่ (แตกต่างกันตั้งแต่วินาทีไปจนถึงนาที) ความคืบหน้าของคำสั่งจะได้มาจากการสำรวจกล้องเป็นระยะๆ โดยใช้ API /osc/commands/status และpreviewToFinalFileUrls
คือผลลัพธ์ที่แสดงเมื่อคำสั่งทำงานเสร็จสิ้น หากขาดการเชื่อมต่อกับกล้องก่อนคำสั่งจะเสร็จสิ้น ไคลเอ็นต์จะใช้listFiles
เพื่อรับ URL ของรูปภาพสุดท้ายเมื่อเชื่อมต่อกับกล้องอีกครั้ง หรือออกคำสั่ง processPicture ใหม่ซึ่งควรแสดงผลpreviewToFinalFileUrls
ทันทีหากประมวลผลรูปภาพแล้วก่อนการเชื่อมต่อใหม่</key,>
ข้อผิดพลาด
- disableCommand: ไม่รองรับการประมวลผลแบบหน่วงเวลา
- invalidparameterName: ระบบไม่รู้จักชื่อพารามิเตอร์ที่ป้อน
- invalidparameterValue: รู้จักพารามิเตอร์ที่ป้อนได้แต่ค่าไม่ถูกต้อง เช่น URL ใดๆ ใน
previewFileUrls
ไม่ถูกต้อง
คำสั่ง 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." } } |