axiom-vision-diag

Umiejętność diagnostyczna do systematycznego rozwiązywania problemów z Vision Framework na iOS, iPadOS, macOS i tvOS. Obejmuje wskazówki dotyczące niewykrytych obiektów, brakujących punktów orientacyjnych dłoni, niskiej pewności obserwacji, błędów wydajności, konwersji współrzędnych, problemów z rozpoznawaniem tekstu, wykrywaniem kodów kreskowych i skanowaniem dokumentów. Zawiera tabelę objawów z prawdopodobnymi przyczynami i strategie debugowania dla każdego scenariusza.

1. Zainstaluj umiejętność axiom-vision-diag w swoim projekcie Axiom, upewniając się, że Twój system obsługuje iOS 11+ lub równoważną wersję na innej platformie (iPadOS, macOS, tvOS, visionOS).

2. Gdy napotkasz problem z Vision Framework, najpierw sprawdź warunki środowiskowe: oświetlenie, przesłonięcie obiektu i pozycję względem krawędzi kadru — około 40% problemów wynika z tych czynników, a nie z kodu.

3. Zweryfikuj ustawienia pewności obserwacji. Jeśli ignorujesz dane o niskiej pewności, możesz tracić prawidłowe detektywne. Obniż próg pewności, aby sprawdzić, czy problem tkwi w filtracji danych.

4. Sprawdź, czy przetwarzanie Vision Framework działa na wątku głównym — jeśli interfejs użytkownika się zawiesza podczas przetwarzania, przenieś operacje Vision na wątek tła.

5. Jeśli nakładki lub elementy wizualne są w złych pozycjach, zweryfikuj konwersję współrzędnych między systemami (dolny-lewy vs górny-lewy). Błędy konwersji stanowią około 10% problemów.

6. Przed wdrożeniem na starszych urządzeniach sprawdź dostępność API — jeśli używasz funkcji iOS 17+, dodaj sprawdzenie @available, aby uniknąć awarii na starszych systemach.