Trình bao bọc SDK thiết bị phải chuẩn hóa các quy ước gọi trong khi vẫn duy trì sự khác biệt thực sự giữa các thiết bị. Tên API trùng khớp không xác định ngữ nghĩa tham số, quyền sở hữu bộ đệm hoặc trạng thái lỗi. Sau đây là phương pháp thiết kế bộ điều hợp, không phải khẳng định rằng các thiết bị tùy ý đã được tích hợp.
Xác định ngữ nghĩa tham số đầu tiên
| Cánh đồng | Thông tin bắt buộc | Vấn đề cần tránh |
|---|---|---|
| Mã định danh | Tên ứng dụng, ánh xạ thiết bị và chế độ áp dụng | Tên giống nhau nhưng có ý nghĩa khác nhau |
| Loại và đơn vị | Số nguyên, dấu phẩy động, phép liệt kê, Boolean và đơn vị rõ ràng | Sao chép số với đơn vị không tương thích |
| Khả năng truy cập | Chỉ đọc hoặc có thể ghi, phạm vi động và phụ thuộc trạng thái | Ghi thông số không thể thay đổi trong quá trình chụp ảnh |
| Bảng liệt kê và giá trị mặc định | Giá trị được hỗ trợ thực tế và đọc lại | Báo cáo cài đặt không được hỗ trợ là thành công |
| Điều kiện kích hoạt | Cần phải dừng, khởi động lại hay kết nối lại | Giả sử các khung sử dụng cài đặt mới ngay sau khi có cuộc gọi trở lại |
Làm được nhiều việc hơn là đổi tên các trường. Trả về trạng thái có thể nhận dạng cho các hàm không được hỗ trợ. Xác định chuyển đổi và làm tròn cho các đơn vị tương thích. Xác minh khả năng đọc lại, trạng thái thiết bị và thay đổi hình ảnh theo khả năng của SDK mục tiêu.
Tuổi thọ dữ liệu khung
Ghi lại xem SDK, bộ điều hợp hoặc trình gọi của nhà cung cấp có phân bổ bộ đệm hay không, bộ đệm có thể đọc được trong bao lâu, khi nào bộ đệm phải được phát hành hoặc trả về, liệu việc sử dụng đa luồng có được phép hay không và liệu việc sao chép có xảy ra hay không. Kích thước, định dạng, bước hàng và độ dài hợp lệ cùng mô tả dữ liệu hình ảnh; không giả sử các hàng được đóng gói chặt chẽ.
Không chuyển con trỏ gọi lại không đồng bộ sang tác vụ xuôi dòng chạy dài mà không xác nhận thời gian tồn tại của nó. Việc tắt tính năng chụp ảnh, ngắt kết nối và phá hủy thiết bị cũng yêu cầu có thứ tự đối với các khung hình chưa xử lý, lệnh gọi lại được xếp hàng đợi và giải phóng tài nguyên.
Trạng thái và nguồn gốc lỗi
Xem xét các trạng thái ngắt kết nối, kết nối, định cấu hình, thu thập, dừng và lỗi riêng biệt, với các cuộc gọi và điều kiện chuyển tiếp được phép. Thể hiện thời gian chờ, ngắt kết nối, tham số không được hỗ trợ, thiếu bộ đệm và lỗi phân tích cú pháp riêng biệt. Giữ nguyên mã lỗi và ngữ cảnh của nhà cung cấp cùng với mã lỗi của trình bao bọc.
Xác minh nhiều hơn một ví dụ
Đối với các thiết bị và phiên bản được chỉ định, ranh giới tham số kiểm tra, khởi động và dừng lặp lại, hết thời gian chờ khung, trả về bộ đệm, cuộc gọi đồng thời và kết nối lại. Ghi lại lý do tại sao một lỗi không thể được đưa vào hoặc không được hỗ trợ. Cung cấp tài liệu API, bảng lỗi, hướng dẫn xây dựng, ví dụ và hồ sơ kiểm tra đã được thống nhất.
Các dịch vụ liên quan: SDK thiết bị thị giác Và chụp ảnh hình ảnh nhúng.