JoyPro2 Discord GitHub
Projekt

Od JoyPro 1 do JoyPro 2

Prikaži:

JoyPro 1 (2021. do 2023.) bio je alat za DCS: stvarao je relacije između ulaza različitih zrakoplova i dodjeljivao ih na isto mjesto na palici. JoyPro 2 zadržava upravo tu ideju i isti model relacija / dodjela / modifikatora (profil iz JoyPro 1 otvara se u JoyPro 2), a sve oko toga gradi iznova: novo sučelje, engine koji radi i samostalno, desetci igara, testovi za svaku funkciju i puno sigurnosti.

#Brojke

Sve su brojke izmjerene na izvornom kodu obaju projekata (datoteke praćene u gitu; redci koda = neprazni C# redci koji nisu komentari). Brojke za JoyPro 2 potječu iz izrade ove web-stranice.

JoyPro 1 JoyPro 2
Razvoj 2021-02-11 do 2023-11-15 od 2026-09-30
Commitovi 336 1,406
Redci C# koda 25,502 354,663 (13.9 x)
C# datoteke 77 954
Tipovi (klase, recordi, enumi ...) 106 3,059 (29 x)
Metode 450 16,702 (37 x)
Automatski testovi (unit, view model, render) 0 1,537 u 198 testnih datoteka
Dijelovi smoke testa engine-a (pravi engine na testnim mapama) 0 87
Projekti u rješenju (solution) 2 12
Redci oznaka sučelja 973 (WPF XAML) 17,250 (Avalonia AXAML)
Redci dokumentacije (Markdown) 109 25,636
Igre 1 (DCS), kasnije IL-2 36 podržava JoyPro, 57 istraženih naslova
Jezici sučelja 1 39
Naredbe engine-a (naredbeni redak) nema (samo sučelje) 451 u 60 područja, 19 globalnih opcija
Kontrole sučelja opisane na ovoj web-stranici 1097

Gdje je kôd u JoyPro 2 (redci C# koda): engine 187,202, sučelje 80,286, testovi sučelja 56,600, force feedback 14,394.

flowchart LR
  W["Jedan prozor<br/>(zaslon i logika<br/>u jednom)"] --> D1["DCS datoteke"]
JoyPro 1: jedan prozor koji je radio sve, za DCS.
flowchart TB
  G["Prozor"] --> E["Engine<br/>(izvršava svaku radnju)"]
  G --> F["Pomoćnik za<br/>force feedback"]
  G --> V["Pomoćnik za<br/>virtualni joystick"]
  T["Praćenje<br/>na programskoj traci"] --> E
  E --> D2["36 igara"]
  F ~~~ V
JoyPro 2: prozor koji svaku radnju predaje engine-u, s pomoćnicima za force feedback, virtualni joystick i praćenje.
Za početnike

#Što je bolje za vas

  • Mnogo igara, jedan profil. JoyPro 1 bio je za DCS. JoyPro 2 uvozi i izvozi 36 naslova igara: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 i 2024, X-Plane 11 i 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma i druge. Jedna relacija drži istu funkciju u svima njima.
  • Počnite od onoga što imate. Uvoz čita vaše postojeće dodjele iz svake igre; postavljanje pri prvom pokretanju samo pronalazi vaše igre.
  • Ništa se ne može trajno pokvariti. Svaki izvoz najprije sigurnosno kopira datoteke igre, a Poništi zadnji izvoz vraća ih bajt po bajt. Svaka promjena u JoyPro sprema se automatski i može se poništiti, čak i nakon ponovnog pokretanja (povijest profila).
  • Kaže vam što bi pošlo po zlu. Provjera objašnjava probleme riječima igre i popravlja ih jednim klikom.
  • Postavlja se sam. Postavi sve umjesto mene stavlja važne funkcije na vašu palicu, gas i pedale. Vi pogledate popis i pritisnete Koristi ove tipke i Zapiši u moju igru.
  • Manje klikanja. Prijedlozi, Automatsko grupiranje, Automatska dodjela, čarobnjak za postavljanje i JoyPro pomoćnik izrađuju relacije i dodjele umjesto vas; naučeni "vaš stil" slijedi kako ste to prije radili.
  • Primjećuje promjene. Kad nešto ponovno dodijelite u igri, JoyPro nakon zatvaranja igre pita treba li to preuzeti u vaš profil.
  • Vaš jezik. Sučelje govori 39 jezika.
  • Više od dodjela. Slike uređaja i podsjetnici, HUD i preklop za stream, force feedback iz telemetrije, virtualni joystick za igre koje čitaju samo jedan uređaj, glumljeni kontroler (virtualni Xbox gamepad) za igre koje poznaju samo Xbox kontroler, baza kokpita, statistika onoga čime letite.
  • Pomoć za svaku tipku. F1 objašnjava bilo koju tipku, vodiči pokazuju na prave tipke, a Jednostavne riječi drže sve kratkim.
  • Nema dodatnih runtimeova za traženje. Izdanje je jedan zip sa svime unutra; bez SlimDX, bez C++ runtimeova.
Napredno

#Značajku po značajku

Područje JoyPro 1 JoyPro 2
Relacije ručno, DCS id-ovi ručno, s pretraživanjem kroz sve igre, sinonimima, katalogom funkcija, prijedlozima s razlozima, Automatskim grupiranjem, grupiranjem po opisu, pomoćnikom; „isti id, drugo značenje” po DCS zrakoplovu
Dodjele snimanje tipke ili osi snimanje, praćenje ulaza, dodjela na slici uređaja, Automatska dodjela za bilo koju kombinaciju uređaja, čarobnjak za postavljanje, Rasporedi s AI-jem
Podešavanje osi DCS zakrivljenost, mrtva zona, saturacija po igri u njezinu vlastitom modelu odziva, područja po zrakoplovu, kalibracija, način zaskočnika
Modifikatori da da, sa stranicom modifikatora, kombinacijama, prijevodom po igri (BMS shift, ...)
Izvoz DCS (clean, nuke) svaka igra; četiri načina plus „očisti i moje druge uređaje”, po zrakoplovu, minimalna razlika prema zadanim postavkama DCS-a, oznake za dodjele koje nisu zapisane, sigurnosne kopije i poništavanje
Uvezi DCS svaka igra, sa zadanim postavkama, tipkovnicom, spajanjem uređaja, ponovnim uvozom imena/grupa/modifikatora
Sigurnost „napravite sigurnosnu kopiju sami” automatske sigurnosne kopije s verzijama, odbija pisati dok igra radi, povijest profila s poništavanjem i nakon ponovnog pokretanja, zaštićeno okruženje za pisanje (sandbox) u testovima
Provjere provjera valjanosti Provjera: kartice riječima igre, ispravci jednim klikom, uzrok iz povijesti
Rasporedi izvoz slika rasporeda referentne slike uređaja (točan model prema VID:PID i HID imenu), podsjetnici, 3D prikazi uređaja
Preklop (overlay) preklop u igri HUD dizajner, preklop, stranica za stream za OBS, ulazi uživo
Popis igara isporučena baza podataka (html) izrađuje se na vašem računalu iz vaše instalacije, osvježava se nakon ažuriranja igre
Praćenje nema praćenje konfiguracije igre s pomoćnikom na programskoj traci, pita nakon izlaska iz igre
Force feedback nema force feedback iz telemetrije za DCS, IL-2, War Thunder i druge (JoyPro.Ffb)
Virtualni uređaji nema način vJoy / Xbox gamepad s HidHideom, virtualne funkcije, uvoz iz Joystick Gremlina
Jezici engleski 39
Ažuriranja ručno preuzimanje provjera ažuriranja s bilješkama o izdanju, instalacija s provjerom kontrolnog zbroja
Izvješća o problemima pitajte na Discordu jedna datoteka za podršku sa zapisnicima, postavkama i (na zahtjev) profilom; korisnička mapa zamijenjena; ništa se ne šalje na internet
Tehnički detalji

#Arhitektura i kvaliteta

  • Podijeljen na engine i GUI. JoyPro 1 bio je jedna WPF aplikacija s logikom u kodu prozora. JoyPro 2 ima engine (engine.exe, .NET Framework 4.8, običan C#) koji sadrži svu logiku profila, uvoza/izvoza i baze podataka kao 451 naredbi, te Avalonia GUI (.NET 9) koji pokreće engine za svaku radnju. Brze interaktivne naredbe idu jednom dugotrajnom engine serve, pa GUI ostaje brz bez odustajanja od razdvajanja. Sve što GUI radi može se skriptirati (pogledajte naredbeni redak engine-a).
  • Zasebni procesi za stalne poslove: JoyPro.Ffb.exe (force feedback iz telemetrije), JoyPro.VJoy.exe (prosljeđivač virtualnog joysticka), JoyPro.Tray.exe (praćenje dok je GUI zatvoren), svaki s proračunom resursa i dugotrajnim testovima opterećenja, kako bi u pozadini ostali neprimjetni.
  • Testovi: 1,537 automatiziranih testova (xUnit: logika engine-a, view modeli, iscrtavanja stranica izvan zaslona u svijetloj i tamnoj temi), 87 dijelova smoke testa koji pokreću pravi engine nad testnim mapama, neobavezna provjera kvalitete s provjerama invarijanti na stvarnim podacima te end-to-end testovi u igri za igre koje to podržavaju. Testovi rade u zaštićenom okruženju za pisanje s provjerom otiska stvarnih mapa, pa nijedan test ne može dirati stvarne mape igara.
  • Podaci: popisi naredbi igara izrađuju se na korisnikovu računalu iz instalirane igre u %LOCALAPPDATA%\JoyPro2\GameData; JoyPro isporučuje samo vlastite podatke (katalog funkcija, katalog uređaja, tablice pretvorbe, bazu podataka kokpita).
  • Dokumentacija generirana iz izvornog koda: matrica podrške igara dolazi iz koda (engine games support), referenca naredbenog retka iz engine --help, a ova web-stranica iz AXAML-a, view modela i dokumentacije.