JoyPro 1 (2021–2023) buvo DCS įrankis: jis kūrė ryšius tarp skirtingų orlaivių įvesčių ir priskyrė juos tai pačiai vietai ant valdymo rankenėlės. JoyPro 2 išlaiko būtent šią idėją ir tą patį ryšio / priskyrimo / modifikatoriaus modelį (JoyPro 1 profilis atsidaro JoyPro 2), o visa kita aplink jį sukurta iš naujo: nauja sąsaja, variklis, kuris veikia ir atskirai, dešimtys žaidimų, testai kiekvienai funkcijai ir daug saugumo.
#Skaičiai
Visi skaičiai išmatuoti abiejų projektų išeities kode (git sekami failai; kodo eilutės = netuščios C# eilutės, kurios nėra komentarai). JoyPro 2 skaičiai paimti iš šios svetainės kompiliavimo.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Kūrimas | 2021-02-11–2023-11-15 | nuo 2026-09-30 |
| Komitai | 336 | 1,406 |
| C# kodo eilutės | 25,502 | 354,663 (13.9 x) |
| C# failai | 77 | 954 |
| Tipai (klasės, įrašai, išvardijimai ...) | 106 | 3,059 (29 x) |
| Metodai | 450 | 16,702 (37 x) |
| Automatiniai testai (vienetų, rodinio modelio, atvaizdavimo) | 0 | 1,537 198 testų failuose |
| Variklio dūmų testo dalys (tikras variklis su bandomaisiais aplankais) | 0 | 87 |
| Projektai sprendime | 2 | 12 |
| Sąsajos žymėjimo eilutės | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Dokumentacijos eilutės (Markdown) | 109 | 25,636 |
| Žaidimai | 1 (DCS), vėliau IL-2 | 36 palaiko JoyPro, ištirta 57 žaidimų |
| Sąsajos kalbos | 1 | 39 |
| Variklio komandos (komandų eilutė) | nėra (tik GUI) | 451 60 srityse, 19 bendrosios parinktys |
| Šioje svetainėje aprašyti GUI valdikliai | 1097 |
Kur JoyPro 2 yra kodas (C# kodo eilutės): variklis 187,202, GUI 80,286, GUI testai 56,600, jėgos grįžtamasis ryšys 14,394.
flowchart LR W["Vienas langas<br/>(ekranas ir logika<br/>kartu)"] --> D1["DCS failai"]
flowchart TB G["Langas"] --> E["Variklis<br/>(atlieka kiekvieną veiksmą)"] G --> F["Jėgos grįžtamojo ryšio<br/>pagalbinė programa"] G --> V["Virtualaus joystick<br/>pagalbinė programa"] T["Stebėjimas<br/>pranešimų srityje"] --> E E --> D2["36 žaidimų"] F ~~~ V
Pradedantiesiems
#Kas jums geriau
- Daug žaidimų, vienas profilis. JoyPro 1 buvo skirtas DCS. JoyPro 2 importuoja ir eksportuoja 36 žaidimų: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 ir 2024, X-Plane 11 ir 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma ir kitus. Vienas ryšys juose visuose turi tą pačią funkciją.
- Pradėkite nuo to, ką turite. Importas nuskaito jūsų esamus priskyrimus iš kiekvieno žaidimo; pirmojo paleidimo sąranka pati suranda jūsų žaidimus.
- Niekas nesugadinama visam laikui. Kiekvienas eksportas pirmiausia padaro žaidimo failų atsarginę kopiją, o Atšaukti paskutinį eksportą juos atkuria baitas į baitą. Kiekvienas pakeitimas JoyPro programoje išsaugomas automatiškai ir gali būti atšauktas, net po paleidimo iš naujo (profilio istorija).
- Pasako, kas nepavyktų. Patikra paaiškina problemas žaidimo žodžiais ir jas ištaiso vienu spustelėjimu.
- Nusistato pats. Nustatyti viską už mane priskiria svarbiausias funkcijas jūsų valdymo rankenėlei, greičio svirčiai ir pedalams. Jūs peržiūrite sąrašą ir paspaudžiate Naudoti šiuos mygtukus bei Įrašyti į mano žaidimą.
- Mažiau spustelėjimų. Pasiūlymai, Auto Group, Auto Assign, sąrankos vedlys ir JoyPro padėjėjas sukuria ryšius ir priskyrimus už jus; išmoktas „jūsų stilius“ seka tai, kaip darėte anksčiau.
- Pastebi pakeitimus. Kai ką nors iš naujo priskiriate žaidime, užsidarius žaidimui JoyPro paklausia, ar perkelti tai į jūsų profilį.
- Jūsų kalba. Sąsaja kalba 39 kalbomis.
- Daugiau nei priskyrimai. Įrenginių paveikslėliai ir pagalbinės lentelės, HUD ir transliacijos perdanga, jėgos grįžtamasis ryšys pagal telemetriją, virtualus joystick žaidimams, kurie skaito tik vieną įrenginį, tariamas pultas (virtualus Xbox pultas) žaidimams, kurie pažįsta tik Xbox pultą, kabinų duomenų bazė, statistika apie tai, kuo skraidote.
- Pagalba prie kiekvieno mygtuko. F1 paaiškina bet kurį mygtuką, turai rodo į tikrus mygtukus, o Paprasti žodžiai viską sutrumpina.
- Nereikia ieškoti papildomų vykdymo aplinkų. Leidimas yra vienas zip failas su viskuo viduje; jokio SlimDX, jokių C++ vykdymo aplinkų.
Papildomai
#Funkcija po funkcijos
| Sritis | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Ryšiai | rankiniu būdu, DCS ID | rankiniu būdu su paieška visuose žaidimuose, sinonimai, funkcijų katalogas, pasiūlymai su priežastimis, Auto Group, grupavimas pagal aprašymą, asistentas; „tas pats ID, kita reikšmė“ kiekvienam DCS orlaiviui |
| Priskyrimai | įrašyti mygtuką ar ašį | įrašymas, įvesties sekimas, priskyrimas įrenginio paveikslėlyje, Auto Assign bet kokiam įrenginių deriniui, sąrankos vedlys, Išdėstyti su DI |
| Ašių derinimas | DCS kreivumas, negyvoji zona, sotis | kiekvienam žaidimui pagal jo paties atsako modelį, taikymo sritys kiekvienam orlaiviui, kalibravimas, fiksatoriaus režimas |
| Modifikatoriai | taip | taip, su modifikatorių puslapiu, deriniais, vertimu kiekvienam žaidimui (BMS shift, ...) |
| Eksportuoti | DCS (clean, nuke) | kiekvienas žaidimas; keturi režimai ir „išvalyti ir kitus“, kiekvienam orlaiviui, minimalus skirtumas nuo DCS numatytųjų, žymės neįrašytiems priskyrimams, atsarginės kopijos ir atšaukimas |
| Importuoti | DCS | kiekvienas žaidimas, su numatytaisiais, klaviatūra, įrenginių sujungimu, pavadinimų / grupių / modifikatorių pakartotiniu importu |
| Sauga | „pasidarykite atsarginę kopiją patys“ | automatinės atsarginės kopijos su versijomis, atsisako rašyti, kol veikia žaidimas, profilio istorija su atšaukimu tarp seansų, rašymo smėlio dėžė testuose |
| Patikros | patvirtinti | Patikra: kortelės žaidimo žodžiais, taisymai vienu spustelėjimu, priežastis iš istorijos |
| Išdėstymai | išdėstymo paveikslėlių eksportas | įrenginių pavyzdiniai paveikslėliai (tikslus modelis pagal VID:PID ir HID pavadinimą), pagalbinės lentelės, 3D įrenginių vaizdai |
| Perdanga | perdanga žaidime | HUD kūrimo įrankis, perdanga, transliacijos puslapis OBS, tiesioginės įvestys |
| Žaidimų sąrašas | kartu pateikiama duomenų bazė (html) | sukuriamas jūsų kompiuteryje iš jūsų įdiegto žaidimo, atnaujinamas po žaidimo naujinimų |
| Stebėjimas | nėra | žaidimų konfigūracijos stebėtojas su pranešimų srities programa, klausia žaidimui baigus darbą |
| Force feedback | nėra | telemetrijos jėgos grįžtamasis ryšys DCS, IL-2, War Thunder ir kitiems (JoyPro.Ffb) |
| Virtualūs įrenginiai | nėra | vJoy / Xbox pulto režimas su HidHide, virtualios funkcijos, Joystick Gremlin importas |
| Kalbos | Anglų | 39 |
| Naujinimai | atsisiųsti rankiniu būdu | naujinimų tikrinimas su leidimo pastabomis, diegimas su kontrolinės sumos patikra |
| Problemų ataskaitos | klausti Discord | vienas pagalbos failas su žurnalais, nustatymais ir (paprašius) profiliu; naudotojo aplankas pakeistas; niekas neįkeliama |
Techninės detalės
#Architektūra ir kokybė
- Padalyta į variklį ir GUI. JoyPro 1 buvo viena WPF programa, kurios logika buvo lango kode. JoyPro 2 turi variklį (
engine.exe, .NET Framework 4.8, paprastas C#), kuriame visa profilio, importo / eksporto ir duomenų bazės logika sudėta į 451 komandas, ir Avalonia GUI (.NET 9), kuri kiekvienam veiksmui paleidžia variklį. Greitos interaktyvios komandos keliauja į vieną ilgai veikiantįengine serve, todėl GUI išlieka greita neatsisakant atskyrimo. Viską, ką daro GUI, galima aprašyti scenarijumi (žr. variklio komandinę eilutę). - Atskiri procesai nuolatiniams darbams:
JoyPro.Ffb.exe(telemetrijos jėgos grįžtamasis ryšys),JoyPro.VJoy.exe(virtualaus joystick persiuntėjas),JoyPro.Tray.exe(stebėtojas, kol GUI uždaryta), kiekvienas su išteklių biudžetais ir ilgalaikės apkrovos testais, kad fone liktų nepastebimi. - Testai: 1,537 automatiniai testai (xUnit: variklio logika, rodinių modeliai, puslapių atvaizdavimas už ekrano šviesiame ir tamsiame režimuose), 87 variklio dūmų testo dalys, kurios paleidžia tikrą variklį su pavyzdiniais aplankais, pasirenkami kokybės vartai su invariantų patikromis tikruose duomenyse ir galutiniai bandymai žaidime tiems žaidimams, kurie juos palaiko. Testai vyksta rašymo smėlio dėžėje su tikrų aplankų pirštų atspaudų patikra, todėl joks testas negali paliesti tikrų žaidimų aplankų.
- Duomenys: žaidimų komandų sąrašai sukuriami naudotojo kompiuteryje iš įdiegto žaidimo į
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro pateikia tik savo duomenis (funkcijų katalogą, įrenginių katalogą, konvertavimo lenteles, kabinų duomenų bazę). - Dokumentacija generuojama iš šaltinio kodo: žaidimų palaikymo matrica gaunama iš kodo (
engine games support), CLI žinynas – išengine --help, o ši svetainė – iš AXAML, rodinių modelių ir dokumentacijos.
#Susiję
- Wiki būsena: kiek išsami ši dokumentacija
- Žaidimų palaikymas: kiekvienas žaidimas ir ką JoyPro jam daro