Wrapper SDK ของอุปกรณ์ควรสร้างมาตรฐานการโทรโดยยังคงรักษาความแตกต่างที่แท้จริงระหว่างอุปกรณ์ต่างๆ การจับคู่ชื่อ API ไม่ได้กำหนดความหมายพารามิเตอร์ ความเป็นเจ้าของบัฟเฟอร์ หรือสถานะข้อผิดพลาด ต่อไปนี้เป็นวิธีการออกแบบอะแดปเตอร์ ไม่ใช่การกล่าวอ้างว่าอุปกรณ์ที่กำหนดเองได้ถูกรวมเข้าด้วยกันแล้ว

กำหนดความหมายของพารามิเตอร์ก่อน

สนาม ข้อมูลที่จำเป็น ปัญหาที่ควรหลีกเลี่ยง
ตัวระบุ ชื่อแอปพลิเคชัน การทำแผนที่อุปกรณ์ และโหมดที่ใช้งานได้ ชื่อเหมือนกันแต่ความหมายต่างกัน
ประเภทและหน่วย จำนวนเต็ม จุดลอยตัว การแจงนับ บูลีน และหน่วยที่ชัดเจน การคัดลอกตัวเลขที่มีหน่วยที่เข้ากันไม่ได้
ความสามารถในการเข้าถึง อ่านอย่างเดียวหรือเขียนได้ ช่วงไดนามิกและการอ้างอิงสถานะ การเขียนพารามิเตอร์ที่ไม่สามารถเปลี่ยนแปลงระหว่างการจับภาพ
การแจงนับและค่าเริ่มต้น ค่าที่รองรับจริงและการอ่านกลับ รายงานการตั้งค่าที่ไม่รองรับว่าสำเร็จ
เงื่อนไขการเปิดใช้งาน ไม่ว่าจะจำเป็นต้องหยุด รีสตาร์ท หรือเชื่อมต่อใหม่ สมมติว่าเฟรมใช้การตั้งค่าใหม่ทันทีหลังจากการเรียกกลับ

ทำมากกว่าการเปลี่ยนชื่อฟิลด์ ส่งคืนสถานะที่ระบุได้สำหรับฟังก์ชันที่ไม่รองรับ กำหนดการแปลงและการปัดเศษสำหรับหน่วยที่เข้ากันได้ ตรวจสอบการอ่านกลับ สถานะอุปกรณ์ และการเปลี่ยนแปลงรูปภาพตามความสามารถของ SDK เป้าหมาย

อายุการใช้งานของข้อมูลเฟรม

จัดทำเอกสารว่า SDK ของผู้จำหน่าย อะแด็ปเตอร์ หรือผู้เรียกจัดสรรบัฟเฟอร์ ระยะเวลาที่บัฟเฟอร์ยังคงอ่านได้ เมื่อใดที่ต้องปล่อยหรือส่งคืน อนุญาตให้ใช้ข้ามเธรดได้หรือไม่ และเกิดการคัดลอกหรือไม่ ขนาด รูปแบบ ระยะก้าวของแถว และความยาวที่ถูกต้องร่วมกันเพื่ออธิบายข้อมูลภาพ อย่าถือว่าแถวแน่น

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

สถานะและที่มาของข้อผิดพลาด

พิจารณาสถานะการตัดการเชื่อมต่อ เชื่อมต่อ กำหนดค่า กำลังรับ การหยุด และสถานะข้อบกพร่องแยกกัน โดยมีเงื่อนไขการเรียกและการเปลี่ยนที่อนุญาต การหมดเวลาด่วน การขาดการเชื่อมต่อ พารามิเตอร์ที่ไม่รองรับ การขาดแคลนบัฟเฟอร์ และความล้มเหลวในการแยกวิเคราะห์แยกกัน รักษารหัสข้อผิดพลาดของผู้จัดจำหน่ายและบริบทควบคู่ไปกับรหัสข้อผิดพลาดของ Wrapper

ตรวจสอบมากกว่าตัวอย่าง

สำหรับอุปกรณ์และเวอร์ชันที่ระบุ ขอบเขตของพารามิเตอร์ทดสอบ การเริ่มต้นและหยุดซ้ำ การหมดเวลาของเฟรม การส่งคืนบัฟเฟอร์ การโทรพร้อมกัน และการเชื่อมต่อใหม่ บันทึกว่าเหตุใดจึงไม่สามารถฉีดข้อผิดพลาดหรือไม่ได้รับการรองรับ จัดส่งเอกสาร API ตารางข้อผิดพลาด คำแนะนำในการสร้าง ตัวอย่าง และบันทึกการทดสอบที่ตกลงกัน

บริการที่เกี่ยวข้อง: SDK อุปกรณ์การมองเห็น และ ภาพที่ฝังตัวจับภาพ.