Bir cihaz SDK sarmalayıcısı, cihazlar arasındaki gerçek farklılıkları korurken arama kurallarını standartlaştırmalıdır. Eşleşen API adları parametre anlamını, arabellek sahipliğini veya hata durumlarını tanımlamaz. Aşağıdakiler bir adaptör tasarım yöntemidir, keyfi cihazların zaten entegre edildiği iddiası değildir.
Önce parametre anlamını tanımlayın
| Alan | Gerekli bilgiler | Kaçınılması gereken sorun |
|---|---|---|
| Tanımlayıcı | Uygulama adı, cihaz eşlemesi ve uygulanabilir mod | Farklı anlamlara sahip aynı isimler |
| Tip ve birim | Tamsayı, kayan nokta, numaralandırma, Boolean ve açık birimler | Uyumsuz birimlere sahip numaraları kopyalama |
| Erişim yeteneği | Salt okunur veya yazılabilir, dinamik aralık ve durum bağımlılıkları | Görüntü yakalama sırasında değişemeyecek parametrelerin yazılması |
| Numaralandırmalar ve varsayılanlar | Desteklenen gerçek değerler ve tekrar | Desteklenmeyen ayarları başarılı olarak bildirme |
| Etkinleştirme koşulları | Durdurmanın, yeniden başlatmanın veya yeniden bağlanmanın gerekli olup olmadığı | Çerçevelerin, çağrı geri döndükten hemen sonra yeni bir ayar kullandığını varsayarsak |
Alanları yeniden adlandırmaktan fazlasını yapın. Desteklenmeyen işlevler için tanımlanabilir durumları döndürün. Uyumlu birimler için dönüştürme ve yuvarlama tanımlayın. Hedef SDK'nın yeteneklerine göre okuma, cihaz durumu ve görüntü değişikliklerini doğrulayın.
Çerçeve veri ömrü
Satıcı SDK'sının, bağdaştırıcının veya arayanın bir arabellek ayırıp ayırmadığını, ne kadar süreyle okunabilir kalacağını, ne zaman yayımlanması veya iade edilmesi gerektiğini, çapraz iş parçacığı kullanımına izin verilip verilmediğini ve kopyalamanın gerçekleşip gerçekleşmediğini belgeleyin. Boyutlar, format, sıra adımı ve geçerli uzunluk birlikte görüntü verilerini tanımlar; sıkıca paketlenmiş satırları varsaymayın.
Eşzamansız bir geri arama işaretçisini, ömrünü onaylamadan uzun süre çalışan bir aşağı akış görevine geçirmeyin. Görüntü yakalamanın kapatılması, bağlantının kesilmesi ve cihazın yok edilmesi, aynı zamanda olağanüstü çerçeveler, sıraya alınmış geri aramalar ve kaynak serbest bırakılması için bir sipariş gerektirir.
Durumlar ve hata kaynakları
İzin verilen çağrılar ve geçiş koşullarıyla birlikte ayrı ayrı bağlantısız, bağlı, yapılandırılmış, alma, durdurma ve hata durumlarını göz önünde bulundurun. Zaman aşımlarını, bağlantı kesilmesini, desteklenmeyen parametreleri, arabellek eksikliklerini ve ayrıştırma hatalarını ayrı ayrı ifade edin. Paketleyicinin hata kodunun yanı sıra satıcı hata kodunu ve içeriğini de koruyun.
Bir örnekten fazlasını doğrulayın
Belirtilen cihazlar ve sürümler için parametre sınırlarını test edin, tekrarlanan başlatma ve durdurma, çerçeve zaman aşımları, ara belleğe dönüş, eşzamanlı çağrılar ve yeniden bağlanma. Bir hatanın neden eklenemediğini veya desteklenmediğini kaydedin. API belgelerini, hata tablolarını, oluşturma talimatlarını, örnekleri ve kabul edilen test kayıtlarını sunun.
İlgili hizmetler: görme cihazı SDK'ları Ve gömülü görüntü görüntü yakalama.