Identyfikowanie problemów

Zbieranie mediów do testowania

Pierwszym krokiem w każdym procesie zgłaszania błędów jest zebranie dowodów na to, że coś idzie nie tak. Proste wiadomości takie jak “Hej, ta gra nie działa” nie są pomocne dla naszego zespołu utrzymania. Aby sprawnie rozwiązać problem, potrzebujemy za każdym razem trzech rzeczy:

Wideo pokazujące aktywowany błąd. Rozumiemy, że nie możesz nagrać efektu na klawiaturze, ale wystarczy wideo z rozgrywki.
Opis czynności, które spowodowały błąd. Bądź jak najbardziej szczegółowy. Nawet małe szczegóły mogą pomóc nam szybko zidentyfikować źródło problemu.
Rozdzielczość ekranu, na której grasz. Bez tego nasi deweloperzy muszą sprawdzać każdą obsługiwaną rozdzielczość, aby znaleźć problem, co może być czasochłonne.

Jeśli jesteś twórcą Lightscript, który nie jest bezpośrednio związany z naszą firmą, te proste kroki również bardzo ci pomogą z twoim własnym kodem. Dokładna dokumentacja w połączeniu ze zrozumieniem struktury kodu sprawia, że identyfikacja problemów jest prostym procesem.

Jeśli jesteś fanem gry próbującym samodzielnie przeprowadzić konserwację, upewnij się, że wysyłasz nam materiał z rozgrywki z widocznym problemem. Być może będziemy w stanie przyspieszyć twoje naprawienie!

Identyfikowanie problemów

Błędy integracji są zwykle łatwe do rozpoznania — jeśli efekt nigdy nie jest odtwarzany lub jest odtwarzany zbyt często, coś wyraźnie jest nie tak. Trudną częścią jest określenie dokładnej sekcji kodu powodującej problem. Zawsze zaczynaj od identyfikacji problemu za pomocą kroków z poprzedniej sekcji, ponieważ daje to najwyraźniejszą ścieżkę. Poniżej znajduje się zalecany proces naprawy błędów:

Sprawdź log konsoli:
- Czy otrzymujemy logi konsoli identyfikujące problem? Typowe problemy to niezadeklarowane zmienne, literówki oraz nieprawidłowe zakresy dla mierników lub rysowania kształtów. Przepełnienia stosu nie są wykrywane przez SignalRGB, ale są łatwe do rozpoznania: SignalRGB jako pierwszy się zawiesza, a potem twój komputer. Bądź odpowiedzialnym programistą i unikaj pozwalania swojej aplikacji liczyć do nieskończoności.
Sprawdź mierniki:
- Czy efekt aktywuje twoje mierniki w Meter Inspector podczas rozgrywki? Jeśli tak, powinieneś widzieć białe pojawiające się w czarnym obszarze pod wyświetlaczem miernika.
  - Jeśli miernik jest źle umieszczony, użyj naszego dedykowanego narzędzia (WindowSpy) do wykonania pomiarów ekranu i dostosowania umieszczenia miernika w sekcji **<head>**.
  - Jeśli to rozwiąże problem, nie zapomnij dostosować miernika dla każdej innej rozdzielczości w sekcji dostosowania. Instrukcje dotyczące umieszczania mierników i znormalizowanych współrzędnych można znaleźć w sekcji “Smart Tags” tego dokumentu.
  - Jeśli mierniki aktywują się poprawnie, problem leży gdzie indziej.
Sprawdź funkcję aktualizacji:
- Czy dane miernika są prawidłowo przekazywane do klasy Meter?
  - Czy wstawiłeś warunkowe aktualizacje Meter, aby uwzględnić złożone zachowanie UI?
  - Jeśli wszystko wygląda dobrze, umieść console.log bezpośrednio w swojej funkcji callback. Log powinien drukować za każdym razem, gdy miernik się stabilizuje, nawet jeśli efekt nie aktywuje się poprawnie.
  - Jeśli log pojawia się konsekwentnie, problem leży gdzie indziej.
Oceń funkcję callback:
- Wiemy, że funkcja callback aktywuje się poprawnie, ponieważ wcześniej widzieliśmy logi. Teraz przejrzyj warunki w efekcie pod kątem dokładności.
  - Jeśli nic nie wydaje się wyraźnie złe, dodaj instrukcje console.log w warunkach, aby sprawdzić, czy aktywują się nieprawidłowo podczas rozgrywki.
  - Jeśli wszystko wygląda dobrze, problem może leżeć w samym efekcie.
Sprawdź funkcję animacji efektu:
- Funkcje animacji mogą się bardzo różnić, więc nie ma uniwersalnej porady. Aby efektywnie debugować:
  - Przenieś efekt do pustego szablonu Lightscript i sprawdź, czy możesz go aktywować, aby zobaczyć animację w SignalRGB.
  - Obserwuj konsolę i zapisuj, gdzie animacja się zacina.
  - Izolowanie kodu problematycznego zaoszczędzi ci czas, więc upewnij się, że wykonujesz ten krok.