JoyPro2 Discord GitHub
Projekt

Od JoyPro 1 k JoyPro 2

Zobrazit:

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"]
JoyPro 1: jedno okno, které dělalo vše, pro 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
JoyPro 2: okno, které každou akci předá enginu, s pomocníky pro zpětnou vazbu síly, virtuální joystick a sledování.
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ího engine 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 z engine --help a tento web z AXAML, view modelů a dokumentace.
  • Stav wiki: jak je tato dokumentace úplná
  • Podpora her: každá hra s tím, co pro ni JoyPro dělá