يجب أن يقوم غلاف SDK للجهاز بتوحيد اصطلاحات الاتصال مع الحفاظ على الاختلافات الحقيقية بين الأجهزة. لا تحدد أسماء واجهة برمجة التطبيقات (API) المطابقة دلالات المعلمات أو ملكية المخزن المؤقت أو حالات الخطأ. ما يلي هو طريقة تصميم محول، وليس ادعاء بأن الأجهزة العشوائية قد تم دمجها بالفعل.

تحديد دلالات المعلمة أولا

مجال المعلومات المطلوبة مشكلة لتجنب
المعرف اسم التطبيق وتعيين الجهاز والوضع المطبق أسماء متطابقة بمعاني مختلفة
النوع والوحدة عدد صحيح، نقطة عائمة، التعداد، الوحدات المنطقية والصريحة نسخ الأرقام بوحدات غير متوافقة
القدرة على الوصول للقراءة فقط أو للكتابة، النطاق الديناميكي وتبعيات الحالة كتابة المعلمات التي لا يمكن تغييرها أثناء التقاط الصورة
التعدادات والافتراضيات القيم المدعومة الفعلية والقراءة تم الإبلاغ عن الإعدادات غير المدعومة بنجاح
شروط التنشيط سواء كان التوقف أو إعادة التشغيل أو إعادة الاتصال مطلوبًا بافتراض أن الإطارات تستخدم إعدادًا جديدًا فورًا بعد إرجاع المكالمة

افعل أكثر من مجرد إعادة تسمية الحقول. إرجاع حالات يمكن تحديدها للوظائف غير المدعومة. تحديد التحويل والتقريب للوحدات المتوافقة. تحقق من إعادة القراءة وحالة الجهاز وتغييرات الصورة وفقًا لإمكانيات SDK المستهدفة.

عمر بيانات الإطار

قم بتوثيق ما إذا كان البائع SDK أو المحول أو المتصل يخصص مخزنًا مؤقتًا، ومدة بقائه قابلاً للقراءة، ومتى يجب تحريره أو إرجاعه، وما إذا كان الاستخدام عبر مؤشرات الترابط مسموحًا به وما إذا كان النسخ يحدث. تصف الأبعاد والتنسيق وخطوة الصف والطول الصالح معًا بيانات الصورة؛ لا تفترض صفوفًا مكتظة بإحكام.

لا تقم بتمرير مؤشر رد اتصال غير متزامن إلى مهمة طويلة الأمد دون التأكد من عمره. يتطلب إيقاف التقاط الصور وفصل الاتصال وتدمير الجهاز أيضًا طلبًا للإطارات المعلقة وعمليات الاسترجاعات الموضوعة في قائمة الانتظار وتحرير الموارد.

الدول وأصول الخطأ

ضع في اعتبارك حالات منفصلة منفصلة ومتصلة ومكونة واكتساب وإيقاف وحالات خطأ، مع الاستدعاءات المسموح بها وشروط الانتقال. المهلات السريعة، وقطع الاتصال، والمعلمات غير المدعومة، ونقص المخزن المؤقت، وفشل التحليل بشكل منفصل. احتفظ برمز خطأ البائع وسياقه جنبًا إلى جنب مع رمز خطأ المجمّع.

التحقق من أكثر من مثال

بالنسبة للأجهزة والإصدارات المحددة، قم باختبار حدود المعلمات، والبدء والتوقف المتكرر، ومهلة الإطار، وإرجاع المخزن المؤقت، والمكالمات المتزامنة، وإعادة الاتصال. سجل سبب عدم إمكانية حقن الخطأ أو عدم دعمه. تسليم وثائق API وجداول الأخطاء وتعليمات البناء والأمثلة وسجلات الاختبار المتفق عليها.

الخدمات ذات الصلة: حزم SDK لجهاز الرؤية و التقاط الصور المضمنة.