JoyPro2 Discord GitHub
Projekt

JoyPro 1-st JoyPro 2-ni

Näita:

JoyPro 1 (2021 kuni 2023) oli DCS-i tööriist: see lõi seoseid eri õhusõidukite sisendite vahel ja määras need juhtkangil samale kohale. JoyPro 2 säilitab täpselt selle idee ja sama seose / määrangu / modifikaatori mudeli (JoyPro 1 profiil avaneb JoyPro 2-s) ning ehitab kõik selle ümber uuesti üles: uus liides, mootor, mis töötab ka iseseisvalt, kümneid mänge, testid iga funktsiooni jaoks ja palju turvalisust.

#Arvud

Kõik arvud on mõõdetud mõlema projekti lähtekoodist (gitis jälgitavad failid; koodiread = mittetühjad C# read, mis pole kommentaarid). JoyPro 2 arvud on selle saidi ehitusest.

JoyPro 1 JoyPro 2
Arendus 2021-02-11 kuni 2023-11-15 alates 2026-09-30
Commitid 336 1,406
C# koodiread 25,502 354,663 (13.9 x)
C# failid 77 954
Tüübid (klassid, kirjed, loendid ...) 106 3,059 (29 x)
Meetodid 450 16,702 (37 x)
Automaattestid (ühik, vaatemudel, renderdus) 0 1,537 198 testifailis
Mootori suitsutesti osad (päris mootor testkaustadel) 0 87
Projektid lahenduses 2 12
Liidese märgendusread 973 (WPF XAML) 17,250 (Avalonia AXAML)
Dokumentatsiooni read (Markdown) 109 25,636
Mängud 1 (DCS), hiljem IL-2 36 toetab JoyPro, 57 mängu uuritud
Liidese keeled 1 39
Mootori käsud (käsurida) puuduvad (ainult kasutajaliides) 451 60 valdkonnas, 19 üldist valikut
Sellel saidil kirjeldatud kasutajaliidese juhtelemendid 1097

Kus JoyPro 2 kood asub (C# koodiread): mootor 187,202, kasutajaliides 80,286, kasutajaliidese testid 56,600, force feedback 14,394.

flowchart LR
  W["Üks aken<br/>(kuva ja loogika<br/>koos)"] --> D1["DCS-i failid"]
JoyPro 1: üks aken, mis tegi kõike, DCS-i jaoks.
flowchart TB
  G["Aken"] --> E["Mootor<br/>(teeb iga toimingu)"]
  G --> F["Force feedbacki<br/>abiprogramm"]
  G --> V["Virtuaalse joysticku<br/>abiprogramm"]
  T["Jälgija<br/>teavitusalas"] --> E
  E --> D2["36 mängu"]
  F ~~~ V
JoyPro 2: aken, mis annab iga toimingu mootorile, koos abilistega force feedbacki, virtuaalse joysticku ja jälgija jaoks.
Algajatele

#Mis on sinu jaoks parem

  • Palju mänge, üks profiil. JoyPro 1 oli DCS-i jaoks. JoyPro 2 impordib ja ekspordib 36 mängu: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 ja 2024, X-Plane 11 ja 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma ja teised. Üks seos hoiab sama funktsiooni kõigis neis.
  • Alusta sellest, mis sul on. Import loeb igast mängust sinu olemasolevad määrangud; esimese käivituse seadistus leiab sinu mängud ise.
  • Miski ei lähe jäädavalt katki. Iga eksport teeb enne mängufailidest varukoopia ja Võta viimane eksport tagasi paneb need baidihaaval tagasi. Iga muudatus JoyPros salvestatakse automaatselt ja selle saab tagasi võtta, isegi pärast taaskäivitust (profiili ajalugu).
  • See ütleb, mis läheks valesti. Kontroll selgitab probleeme mängu sõnadega ja parandab need ühe klõpsuga.
  • See seadistab end ise. Seadista kõik minu eest paneb tähtsad funktsioonid sinu juhtkangile, gaasikangile ja pedaalidele. Sa vaatad loendit ja vajutad Kasuta neid nuppe ning Kirjuta minu mängu.
  • Vähem klõpsamist. Soovitused, Automaatne rühmitamine, Automaatne määramine, seadistusviisard ja JoyPro assistent loovad seoseid ja määranguid sinu eest; õpitud „sinu stiil“ järgib seda, kuidas sa seda varem tegid.
  • See märkab muudatusi. Kui määrad mängus midagi ümber, küsib JoyPro pärast mängu sulgemist, kas see sinu profiili võtta.
  • Sinu keel. Liides räägib 39 keelt.
  • Rohkem kui määrangud. Seadmete pildid ja spikrid, HUD ja voogedastuse ülekate, force feedback telemeetriast, virtuaalne joystick mängudele, mis loevad ainult ühte seadet, asenduspult (virtuaalne Xboxi pult) mängudele, mis tunnevad ainult Xboxi kontrollerit, kokpitite andmebaas, statistika selle kohta, millega lendad.
  • Abi iga nupu kohta. F1 selgitab iga nuppu, ringkäigud näitavad päris nuppudele ja Lihtsad sõnad hoiab teksti lühikesena.
  • Pole vaja lisakäituskeskkondi otsida. Väljalase on üks zip-fail, kus on kõik sees; pole SlimDX-i ega C++ käituskeskkondi.
Täpsem

#Funktsioon funktsiooni haaval

Valdkond JoyPro 1 JoyPro 2
Seosed käsitsi, DCS-i ID-d käsitsi, otsinguga üle kõigi mängude, sünonüümid, funktsioonide kataloog, põhjendatud soovitused, Automaatne rühmitamine, rühmitamine kirjelduse järgi, assistent; „sama ID, erinev tähendus“ DCS-i õhusõidukite kaupa
Määrangud salvesta nupp või telg sisendi salvestamine, sisendi jälgimine, määramine seadme pildil, Automaatne määramine mis tahes seadmekombinatsioonile, seadistusviisard, Paiguta tehisintellektiga
Telgede häälestus DCS-i kõverus, surnud tsoon, küllastus iga mängu jaoks tema enda reaktsioonimudelis, ulatused õhusõidukite kaupa, kalibreerimine, astmete režiim
Modifikaatorid jah jah, modifikaatorite lehe, kombinatsioonide ja mängupõhise tõlkega (BMS shift, ...)
Ekspordi DCS (clean, nuke) kõik mängud; neli režiimi pluss „tühjenda ka“, õhusõidukite kaupa, minimaalne erinevus DCS-i vaikeväärtustest, märked kirjutamata määrangutele, varukoopiad ja tagasivõtmine
Impordi DCS kõik mängud, koos vaikeväärtuste, klaviatuuri, seadmete ühendamise ning nimede/rühmade/modifikaatorite taasimpordiga
Ohutus „tee ise varukoopia“ automaatsed versioonitud varukoopiad, keeldub kirjutamast, kui mäng töötab, profiili ajalugu tagasivõtmisega üle seansside, testides kirjutamisliivakast
Kontrollid valideerimine Kontroll: kaardid mängu sõnadega, ühe klõpsuga parandused, põhjus ajaloost
Paigutused paigutuspiltide eksport seadmete viitepildid (täpne mudel VID:PID ja HID-nime järgi), spikrid, seadmete 3D-vaated
Ülekate mängusisene ülekate HUD-i kujundaja, ülekate, voogedastuse leht OBS-i jaoks, reaalajas sisendid
Mängude loend kaasas olev andmebaas (html) ehitatakse sinu arvutis sinu enda installist, värskendatakse pärast mängu värskendusi
Jälgimine puuduvad mängu seadistuste jälgija teavitusala hostiga, küsib pärast mängu sulgemist
Force feedback puuduvad telemeetriapõhine force feedback DCS-i, IL-2, War Thunderi jt jaoks (JoyPro.Ffb)
Virtuaalsed seadmed puuduvad vJoy / Xboxi puldi režiim HidHide'iga, virtuaalsed funktsioonid, Joystick Gremlini import
Keeled inglise 39
Värskendused allalaadimine käsitsi värskenduste kontroll väljalaskemärkmetega, kontrollsummaga kontrollitud paigaldus
Probleemiaruanded küsi Discordis üks tugifail logide, seadete ja (soovi korral) profiiliga; kasutaja kaust asendatud; midagi ei laadita üles
Tehniline

#Arhitektuur ja kvaliteet

  • Jagatud mootoriks ja GUI-ks. JoyPro 1 oli üks WPF-rakendus, mille loogika oli aknakoodis. JoyPro 2-l on mootor (engine.exe, .NET Framework 4.8, tavaline C#), mis hoiab kogu profiili-, impordi/ekspordi- ja andmebaasiloogikat 451 käsuna, ning Avalonia GUI (.NET 9), mis käivitab mootori iga toimingu jaoks. Kiired interaktiivsed käsud lähevad ühele pikalt töötavale engine serve'ile, nii et GUI jääb kiireks ilma eraldatusest loobumata. Kõike, mida GUI teeb, saab skriptida (vaata mootori käsurida).
  • Eraldi protsessid püsivate tööde jaoks: JoyPro.Ffb.exe (telemeetriapõhine force feedback), JoyPro.VJoy.exe (virtuaalse joysticki edastaja), JoyPro.Tray.exe (jälgija, kui GUI on suletud), igaühel ressursieelarved ja kestustestid, et need jääksid taustal märkamatuks.
  • Testid: 1,537 automaattesti (xUnit: mootori loogika, vaatemudelid, lehtede ekraaniväline renderdus heledas ja tumedas), 87 mootori suitsutesti osa, mis käitavad päris mootorit näidiskaustade peal, valikuline kvaliteediväravas invariantide kontrolliga päris andmetel ning mängusisesed otsast lõpuni käivitused mängudele, mis seda toetavad. Testid töötavad kirjutamisliivakastis päris kaustade sõrmejälje kontrolliga, nii et ükski test ei saa päris mängukaustu puudutada.
  • Andmed: mängude käsuloendid ehitatakse kasutaja arvutis paigaldatud mängust kausta %LOCALAPPDATA%\JoyPro2\GameData; JoyPro tarnib ainult oma andmeid (funktsioonide kataloog, seadmete kataloog, teisendustabelid, kokpitite andmebaas).
  • Dokumentatsioon luuakse lähtekoodist: mängutoe tabel tuleb koodist (engine games support), käsurea viide käsust engine --help ja see sait AXAML-ist, vaatemudelitest ja dokumentatsioonist.
  • Viki olek: kui täielik see dokumentatsioon on
  • Mängutugi: iga mäng ja mida JoyPro selle jaoks teeb