JoyPro2 Discord GitHub
Projekti

JoyPro 1:stä JoyPro 2:een

Näytä:

JoyPro 1 (2021–2023) oli DCS-työkalu: se loi suhteita eri ilma-alusten tulojen välille ja määritti ne samaan kohtaan ohjainsauvassa. JoyPro 2 säilyttää täsmälleen saman idean ja saman suhde / näppäinmääritys / muunnin -mallin (JoyPro 1 -profiili avautuu JoyPro 2:ssa) ja rakentaa kaiken muun uudelleen: uusi käyttöliittymä, myös itsenäisesti toimiva moottori, kymmeniä pelejä, testit jokaiselle ominaisuudelle ja paljon turvallisuutta.

#Luvut

Kaikki luvut on mitattu molempien projektien lähdekoodista (gitissä seuratut tiedostot; koodirivit = ei-tyhjät C#-rivit, jotka eivät ole kommentteja). JoyPro 2:n luvut ovat tämän sivuston koontiversiosta.

JoyPro 1 JoyPro 2
Kehitys 2021-02-11–2023-11-15 2026-09-30 alkaen
Commitit 336 1,406
C#-koodirivit 25,502 354,663 (13.9 x)
C#-tiedostot 77 954
Tyypit (luokat, recordit, enumit ...) 106 3,059 (29 x)
Metodit 450 16,702 (37 x)
Automaattiset testit (yksikkö, näkymämalli, renderöinti) 0 1,537, 198 testitiedostossa
Moottorin savutestin osat (oikea moottori testikansioilla) 0 87
Projektit ratkaisussa 2 12
Käyttöliittymän merkintäkielen rivit 973 (WPF XAML) 17,250 (Avalonia AXAML)
Dokumentaation rivit (Markdown) 109 25,636
Pelit 1 (DCS), myöhemmin IL-2 36 JoyPron tukemaa, 57 peliä tutkittu
Käyttöliittymän kielet 1 39
Moottorin komennot (komentorivi) ei yhtään (vain käyttöliittymä) 451 komentoa 60 alueella, 19 yleistä valitsinta
Tällä sivustolla dokumentoidut käyttöliittymän ohjausobjektit 1097

Missä JoyPro 2:n koodi on (C#-koodirivit): moottori 187,202, käyttöliittymä 80,286, käyttöliittymätestit 56,600, voimapalaute 14,394.

flowchart LR
  W["Yksi ikkuna<br/>(näyttö ja logiikka<br/>samassa)"] --> D1["DCS-tiedostot"]
JoyPro 1: yksi ikkuna, joka teki kaiken, DCS:lle.
flowchart TB
  G["Ikkuna"] --> E["Moottori<br/>(tekee jokaisen toiminnon)"]
  G --> F["Voimapalautteen<br/>apuohjelma"]
  G --> V["Virtuaalisen joystickin<br/>apuohjelma"]
  T["Seuranta<br/>ilmaisinalueella"] --> E
  E --> D2["36 peliä"]
  F ~~~ V
JoyPro 2: ikkuna, joka antaa jokaisen toiminnon moottorille, sekä apurit voimapalautteelle, virtuaaliselle joystickille ja seurannalle.
Aloittelijoille

#Mikä on parempaa sinulle

  • Monta peliä, yksi profiili. JoyPro 1 oli DCS:lle. JoyPro 2 tuo ja vie 36 peliä: 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 muita. Yksi suhde pitää saman toiminnon niissä kaikissa.
  • Aloita siitä, mitä sinulla on. Tuonti lukee olemassa olevat näppäinmäärityksesi jokaisesta pelistä; ensimmäisen käynnistyksen määritys löytää pelisi itse.
  • Mikään ei voi rikkoutua lopullisesti. Jokainen vienti varmuuskopioi ensin pelin tiedostot, ja Kumoa viimeisin vienti palauttaa ne tavu tavulta. Jokainen muutos JoyProssa tallennetaan automaattisesti ja voidaan kumota, myös uudelleenkäynnistyksen jälkeen (profiilin historia).
  • Se kertoo, mikä menisi pieleen. Tarkistus selittää ongelmat pelin sanoin ja korjaa ne yhdellä napsautuksella.
  • Se määrittää itsensä. Tee kaikki puolestani sijoittaa tärkeät toiminnot ohjainsauvaasi, kaasuvipuusi ja polkimiisi. Katsot luetteloa ja painat Käytä näitä painikkeita ja Kirjoita peliini.
  • Vähemmän napsauttelua. Ehdotukset, Automaattinen ryhmittely, Automaattinen määritys, määritysohjattu toiminto ja JoyPro-avustaja rakentavat suhteet ja näppäinmääritykset puolestasi; opittu ”oma tyylisi” seuraa sitä, miten teit asiat aiemmin.
  • Se huomaa muutokset. Kun määrität jotain uudelleen pelin sisällä, JoyPro kysyy pelin sulkeuduttua, otetaanko muutos profiiliisi.
  • Sinun kielesi. Käyttöliittymä puhuu 39 kieltä.
  • Enemmän kuin näppäinmäärityksiä. Laitekuvat ja pikaohjeet, HUD ja striimin peittokuva, voimapalaute telemetriasta, virtuaalinen joystick peleille, jotka lukevat vain yhtä laitetta, leikkiohjain (virtuaalinen Xbox-ohjain) peleille, jotka tuntevat vain Xbox-ohjaimen, ohjaamotietokanta ja tilastot siitä, millä lennät.
  • Ohje jokaiselle painikkeelle. F1 selittää minkä tahansa painikkeen, esittelyt osoittavat oikeita painikkeita, ja Helpot sanat pitää tekstit lyhyinä.
  • Ei ylimääräisiä ajonaikaisia kirjastoja etsittäväksi. Julkaisu on yksi zip, jossa on kaikki; ei SlimDX:ää, ei C++-ajonaikaisia kirjastoja.
Lisäasetukset

#Ominaisuus ominaisuudelta

Alue JoyPro 1 JoyPro 2
Suhteet käsin, DCS-tunnisteet käsin, haku kaikista peleistä, synonyymit, toimintoluettelo, perustellut ehdotukset, Automaattinen ryhmittely, ryhmittely kuvauksen mukaan, avustaja; "sama tunniste, eri merkitys" DCS-ilma-aluksittain
Määritykset tallenna painike tai akseli syötteen tallennus, tulon seuraaminen, määritys laitteen kuvassa, Automaattinen määritys mille tahansa laiteyhdistelmälle, ohjattu määritys, Aseta tekoälyllä
Akseleiden säätö DCS:n kaarevuus, kuollut alue, kyllästys pelikohtaisesti pelin omalla vastemallilla, ilma-aluskohtaiset alueet, kalibrointi, pykälätila
Muuntimet kyllä kyllä: muunninsivu, yhdistelmät, pelikohtainen muunnos (BMS shift, ...)
Vie DCS (clean, nuke) kaikki pelit; neljä tilaa ja "tyhjennä myös", ilma-aluskohtainen, mahdollisimman pieni ero DCS:n oletuksiin, merkinnät kirjoittamatta jääneille määrityksille, varmuuskopiot ja kumoaminen
Tuo DCS kaikki pelit, oletukset, näppäimistö, laitteiden yhdistäminen, nimien/ryhmien/muuntimien uudelleentuonti
Turvallisuus "tee varmuuskopio itse" automaattiset versioidut varmuuskopiot, ei kirjoita pelin ollessa käynnissä, profiilihistoria ja kumoaminen istuntojen yli, kirjoitushiekkalaatikko testeissä
Tarkistukset tarkista Tarkista-kortit pelin sanoin, korjaus yhdellä napsautuksella, aiheuttaja historiasta
Asettelut asettelukuvien vienti laitteiden referenssikuvat (tarkka malli VID:PID:n ja HID-nimen perusteella), pikaohjeet, 3D-laitenäkymät
Peittokuva pelinsisäinen peittokuva HUD-suunnittelija, peittokuva, striimisivu OBS:lle, reaaliaikaiset tulot
Peliluettelo mukana toimitettu tietokanta (html) rakennetaan PC:lläsi omasta asennuksestasi, päivitetään pelipäivitysten jälkeen
Seuranta ei mitään pelin asetusten seuranta ilmaisinalueella, kysyy pelin sulkeuduttua
Voimapalaute ei mitään telemetriaan perustuva voimapalaute DCS:lle, IL-2:lle, War Thunderille ja muille (JoyPro.Ffb)
Virtuaaliset laitteet ei mitään vJoy- / Xbox-ohjaintila ja HidHide, virtuaaliset toiminnot, Joystick Gremlin -tuonti
Kielet englanti 39
Päivitykset lataus käsin päivitystarkistus julkaisutietoineen, tarkistussummalla varmistettu asennus
Ongelmaraportit kysy Discordissa yksi tukitiedosto, jossa lokit, asetukset ja (pyynnöstä) profiili; käyttäjäkansio korvattu; mitään ei ladata verkkoon
Tekninen

#Arkkitehtuuri ja laatu

  • Jaettu moottoriin ja käyttöliittymään. JoyPro 1 oli yksi WPF-sovellus, jonka logiikka oli ikkunakoodissa. JoyPro 2:ssa on moottori (engine.exe, .NET Framework 4.8, tavallinen C#), joka sisältää kaiken profiili-, tuonti-/vienti- ja tietokantalogiikan 451 komentona, sekä Avalonia-käyttöliittymä (.NET 9), joka suorittaa moottorin jokaista toimintoa varten. Nopeat vuorovaikutteiset komennot menevät yhdelle pitkään käynnissä olevalle engine serve -prosessille, joten käyttöliittymä pysyy nopeana luopumatta erottelusta. Kaiken, mitä käyttöliittymä tekee, voi tehdä skriptillä (katso moottorin komentorivi).
  • Erilliset prosessit pysyville tehtäville: JoyPro.Ffb.exe (telemetrian voimapalaute), JoyPro.VJoy.exe (virtuaalisen joystickin välittäjä), JoyPro.Tray.exe (seuranta, kun käyttöliittymä on suljettu), kullakin resurssibudjetit ja kestotestit, jotta ne pysyvät huomaamattomina taustalla.
  • Testit: 1,537 automaattista testiä (xUnit: moottorin logiikka, näkymämallit, sivujen näytön ulkopuoliset renderöinnit vaaleana ja tummana), 87 moottorin savutestin osaa, jotka ajavat oikeaa moottoria testikansioita vasten, valinnainen laatuportti invarianttitarkistuksineen oikealla datalla sekä pelinsisäiset päästä päähän -ajot niille peleille, jotka tukevat niitä. Testit ajetaan kirjoitushiekkalaatikossa, jossa on oikeiden kansioiden sormenjälkitarkistus, joten mikään testi ei voi koskea oikeisiin pelikansioihin.
  • Data: pelien komentoluettelot rakennetaan käyttäjän PC:llä asennetusta pelistä kansioon %LOCALAPPDATA%\JoyPro2\GameData; JoyPro toimittaa vain omat tietonsa (toimintoluettelo, laiteluettelo, muunnostaulukot, ohjaamotietokanta).
  • Dokumentaatio luodaan lähdekoodista: pelien tukimatriisi tulee koodista (engine games support), komentorivin viite komennosta engine --help ja tämä sivusto AXAML-tiedostoista, näkymämalleista ja dokumentaatiosta.
  • Wikin tila: kuinka valmis tämä dokumentaatio on
  • Pelituki: jokainen peli ja mitä JoyPro tekee sille