JoyPro 1 (2021 až 2023) byl nástroj pro DCS: vytvářel relace mezi vstupy různých letounů a přiřazoval je na stejné místo na ovladači. JoyPro 2 zachovává přesně tuto myšlenku a stejný model relace / přiřazení / modifikátor (profil JoyPro 1 se v JoyPro 2 otevře) a vše kolem přestavuje: nové rozhraní, engine, který běží i samostatně, desítky her, testy pro každou funkci a hodně bezpečnosti.
#Čísla
Všechna čísla jsou změřena na zdrojovém kódu obou projektů (soubory sledované v gitu; řádky kódu = neprázdné řádky C#, které nejsou komentáře). Čísla JoyPro 2 pocházejí ze sestavení tohoto webu.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Vývoj | 2021-02-11 až 2023-11-15 | od 2026-09-30 |
| Commity | 336 | 1,406 |
| Řádky kódu C# | 25,502 | 354,663 (13.9 x) |
| Soubory C# | 77 | 954 |
| Typy (třídy, záznamy, výčty ...) | 106 | 3,059 (29 x) |
| Metody | 450 | 16,702 (37 x) |
| Automatické testy (jednotkové, view model, vykreslení) | 0 | 1,537 v 198 souborech testů |
| Části smoke testu enginu (skutečný engine na testovacích složkách) | 0 | 87 |
| Projekty v řešení | 2 | 12 |
| Řádky značek rozhraní | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Řádky dokumentace (Markdown) | 109 | 25,636 |
| Hry | 1 (DCS), později IL-2 | 36 podporovaných v JoyPro, 57 prozkoumaných titulů |
| Jazyky rozhraní | 1 | 39 |
| Příkazy enginu (příkazový řádek) | žádné (jen GUI) | 451 v 60 oblastech, 19 globálních voleb |
| Ovládací prvky GUI popsané na tomto webu | 1097 |
Kde v JoyPro 2 žije kód (řádky kódu C#): engine 187,202, GUI 80,286, testy GUI 56,600, zpětná vazba síly 14,394.
flowchart LR W["Jedno okno<br/>(obrazovka a logika<br/>v jednom)"] --> D1["Soubory DCS"]
flowchart TB G["Okno"] --> E["Engine<br/>(provádí každou akci)"] G --> F["Pomocník pro<br/>zpětnou vazbu síly"] G --> V["Pomocník pro<br/>virtuální joystick"] T["Sledování<br/>v oznamovací oblasti"] --> E E --> D2["36 her"] F ~~~ V
Pro začátečníky
#Co je pro vás lepší
- Mnoho her, jeden profil. JoyPro 1 byl pro DCS. JoyPro 2 importuje a exportuje 36 herních titulů: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 a 2024, X-Plane 11 a 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma a další. Jedna relace drží stejnou funkci ve všech z nich.
- Začněte s tím, co máte. Import načte vaše stávající přiřazení z každé hry; nastavení při prvním spuštění najde vaše hry samo.
- Nic se nemůže rozbít natrvalo. Každý export nejprve zálohuje soubory hry a Vrátit poslední export je vrátí bajt po bajtu. Každá změna v JoyPro se ukládá automaticky a dá se vrátit, i po restartu (historie profilu).
- Řekne vám, co by se pokazilo. Kontrola vysvětlí problémy slovy hry a opraví je jedním kliknutím.
- Nastaví se samo. Nastavit vše za mě dá důležité funkce na váš ovladač, plynovou páku a pedály. Vy si prohlédnete seznam a stisknete Použít tato tlačítka a Zapsat do mé hry.
- Méně klikání. Návrhy, Automatické seskupení, Automatické přiřazení, průvodce nastavením a asistent JoyPro vytvoří relace a přiřazení za vás; naučený „váš styl“ se řídí tím, jak jste to dělali dřív.
- Všimne si změn. Když ve hře něco přeřadíte, JoyPro se po zavření hry zeptá, zda to má převzít do vašeho profilu.
- Váš jazyk. Rozhraní mluví 39 jazyky.
- Víc než přiřazení. Obrázky zařízení a taháky, HUD a překryv pro stream, zpětná vazba síly z telemetrie, virtuální joystick pro hry, které čtou jen jedno zařízení, napodobený gamepad (virtuální gamepad Xbox) pro hry, které znají jen gamepad Xbox, databáze kokpitů, statistiky toho, s čím létáte.
- Nápověda u každého tlačítka. F1 vysvětlí jakékoli tlačítko, prohlídky ukazují na skutečná tlačítka a Jednoduchá slova to drží krátké.
- Žádné shánění dalších runtime knihoven. Vydání je jeden zip se vším uvnitř; žádné SlimDX, žádné runtime knihovny C++.
Pokročilé
#Funkce po funkci
| Oblast | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relace | ručně, id DCS | ručně s hledáním napříč všemi hrami, synonymy, katalogem funkcí, návrhy s důvody, Automatickým seskupením, seskupením podle popisu, asistentem; "stejné id, jiný význam" pro každý letoun DCS |
| Přiřazení | nahrát tlačítko nebo osu | nahrávání, sledování vstupu, přiřazení na obrázku zařízení, Automatické přiřazení pro libovolnou kombinaci zařízení, průvodce nastavením, Rozložit pomocí AI |
| Ladění os | zakřivení, mrtvá zóna, saturace v DCS | pro každou hru v jejím vlastním modelu odezvy, rozsahy pro jednotlivé letouny, kalibrace, režim zarážky |
| Modifikátory | ano | ano, se stránkou modifikátorů, kombinacemi, převodem pro každou hru (BMS shift, ...) |
| Export | DCS (clean, nuke) | každá hra; čtyři režimy plus "vymazat i", pro jednotlivé letouny, minimální rozdíl vůči výchozímu nastavení DCS, označení nezapsaných přiřazení, zálohy a vrácení zpět |
| Importovat | DCS | každá hra, s výchozími přiřazeními, klávesnicí, sloučením zařízení, opětovným importem názvů/skupin/modifikátorů |
| Bezpečnost | "udělejte si zálohu sami" | automatické zálohy s verzemi, odmítne zapisovat, když hra běží, historie profilu s vrácením zpět napříč spuštěními, zápisový sandbox v testech |
| Kontroly | validate | Kontrola: karty slovy hry, opravy jedním kliknutím, příčina z historie |
| Rozvržení | export obrázků rozvržení | referenční obrázky zařízení (přesný model podle VID:PID a názvu HID), taháky, 3D pohledy na zařízení |
| Překryv | překryv ve hře | Návrhář HUD, překryv, stránka pro streamování v OBS, živé vstupy |
| Seznam her | dodávaná databáze (html) | sestavený na vašem PC z vaší vlastní instalace, obnovený po aktualizacích hry |
| Sledování | žádné | sledování konfigurací her s procesem v oznamovací oblasti, zeptá se po ukončení hry |
| Force feedback | žádné | zpětná vazba síly z telemetrie pro DCS, IL-2, War Thunder a další (JoyPro.Ffb) |
| Virtuální zařízení | žádné | režim vJoy / gamepad Xbox s HidHide, virtuální funkce, import z Joystick Gremlin |
| Jazyky | angličtina | 39 |
| Aktualizace | stáhnout ručně | kontrola aktualizací s poznámkami k vydání, instalace ověřená kontrolním součtem |
| Hlášení o problémech | zeptat se na Discordu | jeden soubor pro podporu s protokoly, nastavením a (na požádání) profilem; uživatelská složka nahrazena; nic se nenahrává |
Technické podrobnosti
#Architektura a kvalita
- Rozděleno na engine a GUI. JoyPro 1 byla jedna aplikace WPF s logikou v kódu okna. JoyPro 2 má engine (
engine.exe, .NET Framework 4.8, čisté C#), který drží veškerou logiku profilu, importu/exportu a databáze jako 451 příkazů, a GUI v Avalonia (.NET 9), které engine spouští pro každou akci. Rychlé interaktivní příkazy jdou do jednoho dlouho běžícíhoengine serve, takže GUI zůstává rychlé, aniž by se vzdalo oddělení. Vše, co GUI dělá, lze skriptovat (viz příkazový řádek enginu). - Samostatné procesy pro trvalé úlohy:
JoyPro.Ffb.exe(zpětná vazba síly z telemetrie),JoyPro.VJoy.exe(přeposílání do virtuálního joysticku),JoyPro.Tray.exe(sledování, když je GUI zavřené), každý s rozpočtem prostředků a dlouhodobými zátěžovými testy, aby na pozadí zůstaly nepostřehnutelné. - Testy: 1,537 automatických testů (xUnit: logika enginu, view modely, vykreslení stránek mimo obrazovku ve světlém i tmavém vzhledu), 87 částí smoke testu enginu, které spouštějí skutečný engine nad testovacími složkami, volitelná kontrola kvality s kontrolami invariantů na skutečných datech a end-to-end běhy ve hře pro hry, které to podporují. Testy běží v zápisovém sandboxu s kontrolou otisku skutečných složek, takže žádný test se nemůže dotknout skutečných složek her.
- Data: seznamy příkazů her se sestavují na PC uživatele z nainstalované hry do
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro dodává jen svá vlastní data (katalog funkcí, katalog zařízení, převodní tabulky, databázi kokpitů). - Dokumentace generovaná ze zdrojového kódu: matice podpory her pochází z kódu (
engine games support), reference CLI zengine --helpa tento web z AXAML, view modelů a dokumentace.
#Související
- Stav wiki: jak je tato dokumentace úplná
- Podpora her: každá hra s tím, co pro ni JoyPro dělá