JoyPro 1 (2021 sa 2023) kien għodda għal DCS: kien jagħmel relazzjonijiet bejn l-inputs ta' inġenji tal-ajru differenti u jassenjahom fl-istess post fuq l-istick. JoyPro 2 iżomm eżatt dik l-idea u l-istess mudell ta' relazzjoni / assenjazzjoni / modifikatur (profil ta' JoyPro 1 jinfetaħ f'JoyPro 2), u jerġa' jibni kollox madwarha: interfaċċa ġdida, magna li taħdem ukoll waħedha, għexieren ta' logħob, testijiet għal kull funzjoni, u ħafna sigurtà.
#In-numri
In-numri kollha huma mkejla fuq is-sors taż-żewġ proġetti (fajls irreġistrati f'git; linji tal-kodiċi = linji C# mhux vojta li mhumiex kummenti). In-numri ta' JoyPro 2 huma mill-build ta' dan is-sit.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Żvilupp | 2021-02-11 sa 2023-11-15 | minn 2026-09-30 |
| Commits | 336 | 1,406 |
| Linji tal-kodiċi C# | 25,502 | 354,663 (13.9 x) |
| Fajls C# | 77 | 954 |
| Tipi (classes, records, enums ...) | 106 | 3,059 (29 x) |
| Metodi | 450 | 16,702 (37 x) |
| Testijiet awtomatiċi (unit, view model, render) | 0 | 1,537 f'198 fajl tat-testijiet |
| Partijiet tas-smoke test tal-magna (il-magna vera fuq folders ta' test) | 0 | 87 |
| Proġetti fis-solution | 2 | 12 |
| Linji tal-markup tal-interfaċċja | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Linji tad-dokumentazzjoni (Markdown) | 109 | 25,636 |
| Logħob | 1 (DCS), aktar tard IL-2 | 36 immaniġġjati minn JoyPro, 57 titli riċerkati |
| Lingwi tal-interfaċċja | 1 | 39 |
| Kmandi tal-magna (command line) | xejn (GUI biss) | 451 f'60 oqsma, 19 għażliet globali |
| Kontrolli tal-GUI dokumentati f'dan is-sit | 1097 |
Fejn jinsab il-kodiċi f'JoyPro 2 (linji tal-kodiċi C#): magna 187,202, GUI 80,286, testijiet tal-GUI 56,600, force feedback 14,394.
flowchart LR W["Tieqa waħda<br/>(skrin u loġika<br/>f'waħda)"] --> D1["Fajls ta' DCS"]
flowchart TB G["It-tieqa"] --> E["Il-magna<br/>(tagħmel kull azzjoni)"] G --> F["Force feedback<br/>(helper)"] G --> V["Joystick virtwali<br/>(helper)"] T["Sorveljanza<br/>fiż-żona tan-notifiki"] --> E E --> D2["36 logħba"] F ~~~ V
#X'inhu aħjar għalik
- Ħafna logħob, profil wieħed. JoyPro 1 kien għal DCS. JoyPro 2 jimporta u jesporta 36 titlu ta' logħob: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 u 2024, X-Plane 11 u 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma, u aktar. Relazzjoni waħda żżomm l-istess funzjoni f'kollha.
- Ibda minn dak li għandek. L-importazzjoni taqra l-assenjazzjonijiet li diġà għandek f'kull logħba; is-setup tal-ewwel bidu jsib il-logħob tiegħek waħdu.
- Xejn ma jista' jinkiser għal dejjem. Kull esportazzjoni l-ewwel tagħmel backup tal-fajls tal-logħba, u Ħassar l-aħħar esportazzjoni jerġa' jpoġġihom lura byte byte. Kull bidla f'JoyPro tiġi ssejvjata awtomatikament u tista' titreġġa' lura, anki wara restart (l-istorja tal-profil).
- Jgħidlek x'jista' jmur ħażin. Iċ-ċekk jispjega l-problemi bil-kliem tal-logħba u jsewwihom bi klikk waħda.
- Jissettja lilu nnifsu. Issettja kollox għalija ipoġġi l-funzjonijiet importanti fuq l-istick, it-throttle u l-pedali tiegħek. Inti tħares lejn il-lista u tagħfas Uża dawn il-buttuni u Ikteb fil-logħba tiegħi.
- Inqas klikks. Is-suġġerimenti, Auto Group, Auto Assign, il-wizard tas-setup u assistent ta' JoyPro jibnu r-relazzjonijiet u l-assenjazzjonijiet għalik; "l-istil tiegħek" mitgħallem isegwi kif għamilt qabel.
- Jinduna bil-bidliet. Meta tassenja xi ħaġa mill-ġdid ġewwa logħba, JoyPro jistaqsik, wara li tingħalaq il-logħba, jekk tridx iddaħħalha fil-profil tiegħek.
- Il-lingwa tiegħek. L-interfaċċja titkellem 39 lingwi.
- Aktar minn assenjazzjonijiet. Stampi tal-apparati u folji ta' referenza, HUD u overlay għall-istream, force feedback mit-telemetrija, joystick virtwali għal-logħob li jaqraw apparat wieħed biss, kontrollur finta (pad virtwali tal-Xbox) għal-logħob li jafu biss kontrollur tal-Xbox, database tal-kokpits, statistika ta' dak li ttajjar.
- Għajnuna fuq kull buttuna. F1 jispjega kwalunkwe buttuna, iż-żjarat gwidati juru l-buttuni veri, u Kliem faċli jżomm kollox qasir.
- L-ebda runtime żejjed x'tfittex. Ir-release huwa zip wieħed b'kollox ġewwa; l-ebda SlimDX, l-ebda runtime ta' C++.
#Funzjoni b'funzjoni
| Qasam | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relazzjonijiet | bl-idejn, ids ta' DCS | bl-idejn bit-tfittxija fil-logħob kollha, sinonimi, il-katalgu tal-funzjonijiet, suġġerimenti b'raġunijiet, Auto Group, raggruppament skont id-deskrizzjoni, assistent; "l-istess id, tifsira differenti" għal kull inġenju tal-ajru ta' DCS |
| Assenjazzjonijiet | irrekordja buttuna jew assi | irrekordja, segwi l-input, assenja fuq l-istampa tal-apparat, Auto Assign għal kull kombinazzjoni ta' apparati, wizard tas-setup, Qassam b'AI |
| Irfinar tal-assi | curvature, żona mejta, saturazzjoni ta' DCS | għal kull logħba fil-mudell tar-rispons tagħha, ambiti għal kull inġenju tal-ajru, kalibrazzjoni, modalità tad-detent |
| Modifikaturi | iva | iva, b'paġna tal-modifikaturi, kombinazzjonijiet, traduzzjoni għal kull logħba (BMS shift, ...) |
| Esporta | DCS (clean, nuke) | kull logħba; erba' modalitajiet flimkien ma' "naddaf ukoll", għal kull inġenju tal-ajru, l-iżgħar differenza mid-defaults ta' DCS, marki għall-assenjazzjonijiet mhux miktuba, backups u ħassar |
| Importa | DCS | kull logħba, bid-defaults, tastiera, għaqda tal-apparati, importazzjoni mill-ġdid tal-ismijiet/gruppi/modifikaturi |
| Sigurtà | "agħmel backup int stess" | backups awtomatiċi b'verżjonijiet, jirrifjuta li jikteb waqt li logħba qed taħdem, storja tal-profil bi ħassar anki bejn sessjonijiet, sandbox tal-kitba fit-testijiet |
| Verifiki | validate | iċ-Ċekk: kards bil-kliem tal-logħba, tiswijiet bi klikk waħda, kawża mill-istorja |
| Tqassimiet | esporta stampi tat-tqassim | stampi ta' referenza tal-apparati (il-mudell eżatt skont VID:PID u l-isem HID), folji ta' referenza, veduti 3D tal-apparati |
| Overlay | overlay fil-logħba | disinjatur tal-HUD, overlay, paġna tal-istream għal OBS, inputs live |
| Lista tal-logħob | database mibgħuta mal-programm (html) | mibnija fuq il-PC tiegħek mill-installazzjoni tiegħek stess, aġġornata wara l-aġġornamenti tal-logħob |
| Sorveljanza | xejn | sorveljanza tal-konfigurazzjoni tal-logħob bi programm fiż-żona tan-notifiki, jistaqsik wara li toħroġ mil-logħba |
| Force feedback | xejn | force feedback mit-telemetrija għal DCS, IL-2, War Thunder u aktar (JoyPro.Ffb) |
| Apparati virtwali | xejn | modalità vJoy / pad tal-Xbox b'HidHide, funzjonijiet virtwali, importazzjoni minn Joystick Gremlin |
| Lingwi | Ingliż | 39 |
| Aġġornamenti | niżżel bl-idejn | verifika tal-aġġornamenti b'noti tar-rilaxx, installazzjoni vverifikata b'checksum |
| Rapporti tal-problemi | staqsi fuq Discord | fajl wieħed ta' appoġġ bil-logs, l-issettjar u (fuq talba) il-profil; il-folder tal-utent mibdul; xejn ma jittella' |
#Arkitettura u kwalità
- Maqsum f'magna u GUI. JoyPro 1 kien applikazzjoni WPF waħda bil-loġika fil-kodiċi tat-tieqa. JoyPro 2 għandu magna (
engine.exe, .NET Framework 4.8, C# sempliċi) li żżomm il-loġika kollha tal-profil, tal-import/export u tad-database bħala 451 kmandi, u GUI Avalonia (.NET 9) li tħaddem il-magna għal kull azzjoni. Il-kmandi interattivi qosra jmorru għandengine servewieħed li jibqa' jaħdem, għalhekk il-GUI tibqa' mgħaġġla mingħajr ma tinqata' s-separazzjoni. Kull ma tagħmel il-GUI jista' jsir bi script (ara il-linja tal-kmand tal-magna). - Proċessi separati għal xogħlijiet permanenti:
JoyPro.Ffb.exe(force feedback mit-telemetrija),JoyPro.VJoy.exe(il-forwarder tal-joystick virtwali),JoyPro.Tray.exe(is-sorveljanza waqt li l-GUI hija magħluqa), kull wieħed b'baġits tar-riżorsi u soak tests biex jibqgħu ma jinħassux fl-isfond. - Testijiet: 1,537 testijiet awtomatiċi (xUnit: il-loġika tal-magna, view models, renders offscreen tal-paġni fid-dawl u fid-dlam), 87 partijiet tas-smoke test tal-magna li jħaddmu l-magna vera fuq folders ta' fixture, quality gate fakultattiv b'verifiki ta' invarjanti fuq data vera, u runs end-to-end fil-logħba għal-logħob li jappoġġjawhom. It-testijiet jaħdmu f'sandbox tal-kitba b'verifika tal-fingerprint tal-folders veri, għalhekk l-ebda test ma jista' jmiss folders veri tal-logħob.
- Data: il-listi tal-kmandi tal-logħob jinbnew fuq il-PC tal-utent mil-logħba installata f'
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro jibgħat biss id-data tiegħu stess (katalgu tal-funzjonijiet, katalgu tal-apparati, tabelli tal-konverżjoni, database tal-kokpits). - Dokumentazzjoni ġġenerata mis-sors: il-matriċi tal-appoġġ tal-logħob ġejja mill-kodiċi (
engine games support), ir-referenza tas-CLI minnengine --help, u dan is-sit mill-AXAML, mill-view models u mid-dokumentazzjoni.
#Relatati
- Status tal-wiki: kemm hija kompluta din id-dokumentazzjoni
- Appoġġ għal-logħob: kull logħba b'dak li jagħmel JoyPro għaliha