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"]
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
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öötavaleengine 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äsustengine --helpja see sait AXAML-ist, vaatemudelitest ja dokumentatsioonist.