JoyPro2 Discord GitHub
Projekt

Z JoyPro 1 na JoyPro 2

Zobraziť:

JoyPro 1 (2021 až 2023) bol nástroj pre DCS: vytváral vzťahy medzi vstupmi rôznych lietadiel a priraďoval ich na rovnaké miesto na páke. JoyPro 2 zachováva presne túto myšlienku a rovnaký model vzťah / väzba / modifikátor (profil z JoyPro 1 sa otvorí v JoyPro 2) a všetko okolo neho stavia nanovo: nové rozhranie, nástroj, ktorý beží aj samostatne, desiatky hier, testy pre každú funkciu a veľa bezpečnosti.

#Čísla

Všetky čísla sú merané na zdrojovom kóde oboch projektov (súbory sledované v git; riadky kódu = neprázdne riadky C#, ktoré nie sú komentáre). Čísla JoyPro 2 pochádzajú zo zostavenia tejto stránky.

JoyPro 1 JoyPro 2
Vývoj 2021-02-11 až 2023-11-15 od 2026-09-30
Commity 336 1,406
Riadky kódu C# 25,502 354,663 (13.9 x)
Súbory C# 77 954
Typy (triedy, záznamy, enumerácie ...) 106 3,059 (29 x)
Metódy 450 16,702 (37 x)
Automatické testy (unit, view model, vykresľovanie) 0 1,537 v 198 testovacích súboroch
Časti smoke testu nástroja (skutočný nástroj na testovacích priečinkoch) 0 87
Projekty v riešení (solution) 2 12
Riadky značiek rozhrania 973 (WPF XAML) 17,250 (Avalonia AXAML)
Riadky dokumentácie (Markdown) 109 25,636
Hry 1 (DCS), neskôr IL-2 36 podporovaných v JoyPro, 57 preskúmaných titulov
Jazyky rozhrania 1 39
Príkazy nástroja (príkazový riadok) žiadne (len GUI) 451 v 60 oblastiach, 19 globálnych možností
Ovládacie prvky GUI zdokumentované na tejto stránke 1097

Kde v JoyPro 2 žije kód (riadky kódu C#): nástroj 187,202, GUI 80,286, testy GUI 56,600, Force Feedback 14,394.

flowchart LR
  W["Jedno okno<br/>(obrazovka a logika<br/>v jednom)"] --> D1["Súbory DCS"]
JoyPro 1: jedno okno, ktoré robilo všetko, pre DCS.
flowchart TB
  G["Okno"] --> E["Nástroj<br/>(vykonáva každú akciu)"]
  G --> F["Pomocník pre<br/>Force Feedback"]
  G --> V["Pomocník pre<br/>virtuálny joystick"]
  T["Sledovanie<br/>v oznamovacej oblasti"] --> E
  E --> D2["36 hier"]
  F ~~~ V
JoyPro 2: okno, ktoré každú akciu odovzdá nástroju, s pomocníkmi pre Force Feedback, virtuálny joystick a sledovanie.
Pre začiatočníkov

#Čo je pre vás lepšie

  • Veľa hier, jeden profil. JoyPro 1 bol pre DCS. JoyPro 2 importuje a exportuje 36 herných titulov: 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 ďalšie. Jeden vzťah obsahuje rovnakú funkciu vo všetkých z nich.
  • Začnite z toho, čo máte. Import načíta vaše existujúce väzby z každej hry; nastavenie pri prvom spustení nájde vaše hry samo.
  • Nič sa nemôže pokaziť natrvalo. Každý export najprv zálohuje súbory hry a Vrátiť posledný export ich vráti bajt po bajte. Každá zmena v JoyPro sa ukladá automaticky a dá sa vrátiť späť, aj po reštarte (história profilu).
  • Povie vám, čo by sa pokazilo. Kontrola vysvetlí problémy slovami hry a opraví ich jedným kliknutím.
  • Nastaví sa samo. Nastaviť všetko za mňa dá dôležité funkcie na vašu páku, plyn a pedále. Pozriete si zoznam a stlačíte Použiť tieto tlačidlá a Zapísať do mojej hry.
  • Menej klikania. Návrhy, Automatické zoskupenie, Automatické priradenie, sprievodca nastavením a asistent JoyPro vytvárajú vzťahy a väzby za vás; naučený „váš štýl“ sa riadi tým, ako ste to robili predtým.
  • Všimne si zmeny. Keď niečo v hre priradíte inak, JoyPro sa po zatvorení hry opýta, či to má prevziať do vášho profilu.
  • Váš jazyk. Rozhranie hovorí 39 jazykmi.
  • Viac než väzby. Obrázky zariadení a ťaháky, HUD a prekrytie pre stream, Force Feedback z telemetrie, virtuálny joystick pre hry, ktoré čítajú iba jedno zariadenie, napodobený gamepad (virtuálny gamepad Xbox) pre hry, ktoré poznajú iba gamepad Xbox, databáza kokpitov, štatistiky toho, na čom lietate.
  • Pomoc pri každom tlačidle. F1 vysvetlí každé tlačidlo, prehliadky ukazujú na skutočné tlačidlá a Jednoduché slová to držia stručné.
  • Žiadne ďalšie runtime knižnice na zháňanie. Vydanie je jeden zip so všetkým vnútri; žiadne SlimDX, žiadne runtime knižnice C++.
Pokročilé

#Funkcia po funkcii

Oblasť JoyPro 1 JoyPro 2
Vzťahy ručne, ID z DCS ručne s vyhľadávaním vo všetkých hrách, synonymá, katalóg funkcií, návrhy s dôvodmi, Automatické zoskupenie, zoskupenie podľa popisu, asistent; "rovnaké ID, iný význam" pre každé lietadlo DCS
Väzby zachytiť tlačidlo alebo os zachytiť, sledovať vstup, priradiť na obrázku zariadenia, Automatické priradenie pre ľubovoľnú kombináciu zariadení, sprievodca nastavením, Rozložiť pomocou AI
Ladenie osí zakrivenie, mŕtva zóna, saturácia v DCS pre každú hru v jej vlastnom modeli odozvy, rozsahy pre jednotlivé lietadlá, kalibrácia, režim zarážky
Modifikátory áno áno, so stránkou modifikátorov, kombináciami, prekladom pre každú hru (BMS shift, ...)
Export DCS (clean, nuke) každá hra; štyri režimy plus "vymazať aj", pre jednotlivé lietadlá, minimálny rozdiel voči predvoleným nastaveniam DCS, označenia nezapísaných väzieb, zálohy a vrátenie späť
Importovať DCS každá hra, s predvolenými nastaveniami, klávesnicou, zlúčením zariadení, opätovným importom názvov/skupín/modifikátorov
Bezpečnosť "urobte si zálohu sami" automatické zálohy s verziami, odmietne zapisovať, kým hra beží, história profilu so späť aj medzi reláciami, izolované zápisy (sandbox) v testoch
Kontroly validácia kontrola: karty slovami hry, opravy jedným kliknutím, príčina z histórie
Rozloženia export obrázkov rozloženia referenčné obrázky zariadení (presný model podľa VID:PID a názvu HID), ťaháky, 3D pohľady na zariadenia
Prekrytie prekrytie v hre Návrhár HUD, prekrytie, stránka streamu pre OBS, živé vstupy
Zoznam hier dodávaná databáza (html) zostavený na vašom PC z vašej vlastnej inštalácie, obnovený po aktualizáciách hry
Sledovanie žiadne sledovanie konfigurácie hier s programom v oznamovacej oblasti, opýta sa po ukončení hry
Force feedback žiadne Force Feedback z telemetrie pre DCS, IL-2, War Thunder a ďalšie (JoyPro.Ffb)
Virtuálne zariadenia žiadne režim vJoy / gamepad Xbox s HidHide, virtuálne funkcie, import z Joystick Gremlin
Jazyky angličtina 39
Aktualizácie stiahnuť ručne kontrola aktualizácií s poznámkami k vydaniu, inštalácia overená kontrolným súčtom
Hlásenia problémov opýtať sa na Discorde jeden súbor pre podporu s protokolmi, nastaveniami a (na požiadanie) profilom; používateľský priečinok nahradený; nič sa neodosiela
Technické podrobnosti

#Architektúra a kvalita

  • Rozdelené na nástroj a GUI. JoyPro 1 bola jedna aplikácia WPF s logikou v kóde okna. JoyPro 2 má nástroj (engine.exe, .NET Framework 4.8, čisté C#), ktorý obsahuje celú logiku profilu, importu/exportu a databázy ako 451 príkazov, a GUI v Avalonia (.NET 9), ktoré pre každú akciu spúšťa nástroj. Rýchle interaktívne príkazy idú do jedného dlho bežiaceho engine serve, takže GUI zostáva rýchle bez toho, aby sa vzdalo oddelenia. Všetko, čo robí GUI, sa dá skriptovať (pozrite príkazový riadok nástroja).
  • Samostatné procesy pre trvalé úlohy: JoyPro.Ffb.exe (Force Feedback z telemetrie), JoyPro.VJoy.exe (preposielanie do virtuálneho joysticku), JoyPro.Tray.exe (sledovanie, keď je GUI zatvorené), každý s limitmi prostriedkov a dlhodobými záťažovými testami, aby na pozadí zostali nepostrehnuteľné.
  • Testy: 1,537 automatických testov (xUnit: logika nástroja, view modely, vykreslenia stránok mimo obrazovky vo svetlom aj tmavom režime), 87 častí smoke testu nástroja, ktoré spúšťajú skutočný nástroj nad testovacími priečinkami, voliteľná kontrolná brána s kontrolami invariantov na skutočných dátach a celkové behy priamo v hre pre hry, ktoré to podporujú. Testy bežia v izolovanom zápisovom prostredí (sandbox) s kontrolou odtlačku skutočných priečinkov, takže žiadny test sa nemôže dotknúť skutočných priečinkov hier.
  • Dáta: zoznamy príkazov hier sa zostavujú na PC používateľa z nainštalovanej hry do %LOCALAPPDATA%\JoyPro2\GameData; JoyPro dodáva iba vlastné dáta (katalóg funkcií, katalóg zariadení, prevodové tabuľky, databázu kokpitov).
  • Dokumentácia generovaná zo zdrojového kódu: matica podpory hier pochádza z kódu (engine games support), referencia CLI z engine --help a tento web z AXAML, view modelov a dokumentácie.
  • Stav wiki: nakoľko je táto dokumentácia úplná
  • Podpora hier: každá hra s tým, čo pre ňu JoyPro robí