JoyPro 1 (з 2021 да 2023) быў інструментам для DCS: ён ствараў сувязі паміж уваходамі розных лятальных апаратаў і прывязваў іх да аднаго месца на ручцы кіравання. JoyPro 2 захоўвае менавіта гэтую ідэю і тую ж мадэль сувязь / прывязка / мадыфікатар (профіль JoyPro 1 адкрываецца ў JoyPro 2) і перабудоўвае ўсё вакол яе: новы інтэрфейс, рухавік, які працуе і сам па сабе, дзясяткі гульняў, тэсты для кожнай функцыі і шмат бяспекі.
#Лічбы
Усе лічбы вымераны на зыходным кодзе абодвух праектаў (файлы, якія адсочваюцца ў git; радкі кода = непустыя радкі C#, якія не з'яўляюцца каментарыямі). Лічбы JoyPro 2 узяты са зборкі гэтага сайта.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Распрацоўка | з 2021-02-11 да 2023-11-15 | з 2026-09-30 |
| Каміты | 336 | 1,406 |
| Радкі кода C# | 25,502 | 354,663 (13.9 x) |
| Файлы C# | 77 | 954 |
| Тыпы (класы, запісы, пералічэнні ...) | 106 | 3,059 (29 x) |
| Метады | 450 | 16,702 (37 x) |
| Аўтаматычныя тэсты (модульныя, мадэлі прадстаўлення, рэндэр) | 0 | 1,537 у 198 файлах тэстаў |
| Часткі хуткага тэсту рухавіка (сапраўдны рухавік на тэставых папках) | 0 | 87 |
| Праекты ў рашэнні | 2 | 12 |
| Радкі разметкі інтэрфейсу | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Радкі дакументацыі (Markdown) | 109 | 25,636 |
| Гульні | 1 (DCS), пазней IL-2 | 36 падтрымлівае JoyPro, 57 гульняў даследавана |
| Мовы інтэрфейсу | 1 | 39 |
| Каманды рухавіка (камандны радок) | няма (толькі графічны інтэрфейс) | 451 у 60 раздзелах, 19 глабальных параметраў |
| Элементы кіравання інтэрфейсу, апісаныя на гэтым сайце | 1097 |
Дзе знаходзіцца код у JoyPro 2 (радкі кода C#): рухавік 187,202, інтэрфейс 80,286, тэсты інтэрфейсу 56,600, зваротная сувязь па сіле 14,394.
flowchart LR W["Адно акно<br/>(экран і логіка<br/>разам)"] --> D1["Файлы DCS"]
flowchart TB G["Акно"] --> E["Рухавік<br/>(выконвае кожнае дзеянне)"] G --> F["Памочнік<br/>зваротнай сувязі па сіле"] G --> V["Памочнік<br/>віртуальнага joystick"] T["Назіральнік<br/>у вобласці апавяшчэнняў"] --> E E --> D2["36 гульняў"] F ~~~ V
#Што лепш для вас
- Шмат гульняў, адзін профіль. JoyPro 1 быў для DCS. JoyPro 2 імпартуе і экспартуе 36 гульняў: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 і 2024, X-Plane 11 і 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma і іншыя. Адна сувязь утрымлівае адну і тую ж функцыю ва ўсіх іх.
- Пачніце з таго, што ў вас ёсць. Імпарт чытае вашы існуючыя прывязкі з кожнай гульні; наладка пры першым запуску сама знаходзіць вашы гульні.
- Нічога не зламаецца назаўсёды. Кожны экспарт спачатку робіць рэзервовую копію файлаў гульні, а Адмяніць апошні экспарт вяртае іх байт у байт. Кожная змена ў JoyPro захоўваецца аўтаматычна і можа быць адменена, нават пасля перазапуску (гісторыя профілю).
- Яно кажа, што пойдзе не так. Праверка тлумачыць праблемы словамі гульні і выпраўляе іх адным націскам.
- Яно наладжваецца само. Наладзіць усё за мяне ставіць важныя функцыі на вашу ручку кіравання, РУД і педалі. Вы праглядаеце спіс і націскаеце Выкарыстаць гэтыя кнопкі і Запісаць у маю гульню.
- Менш націскаў. Прапановы, Аўтагрупаванне, Аўтапрызначэнне, майстар налады і памочнік JoyPro ствараюць сувязі і прывязкі за вас; вывучаны «ваш стыль» паўтарае тое, як вы рабілі раней.
- Яно заўважае змены. Калі вы перапрывязваеце нешта ў гульні, JoyPro пасля закрыцця гульні пытаецца, ці ўнесці гэта ў ваш профіль.
- Ваша мова. Інтэрфейс размаўляе на 39 мовах.
- Больш, чым прывязкі. Малюнкі прылад і шпаргалкі, HUD і аверлэй для трансляцый, зваротная сувязь па сіле з тэлеметрыі, віртуальны joystick для гульняў, якія чытаюць толькі адну прыладу, імітаваны кантролер (віртуальны геймпад Xbox) для гульняў, якія ведаюць толькі кантролер Xbox, база даных кабін, статыстыка таго, на чым вы лётаеце.
- Даведка на кожнай кнопцы. F1 тлумачыць любую кнопку, туры паказваюць на сапраўдныя кнопкі, а «Простыя словы» робяць тэксты кароткімі.
- Не трэба шукаць дадатковыя асяроддзі выканання. Выпуск — адзін zip-архіў, у якім усё ёсць; ніякага SlimDX, ніякіх асяроддзяў выканання C++.
#Функцыя за функцыяй
| Вобласць | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Сувязі | уручную, ідэнтыфікатары DCS | уручную з пошукам па ўсіх гульнях, сінонімы, каталог функцый, прапановы з тлумачэннем, Аўтагрупаванне, групаванне па апісанні, памочнік; "той жа id, іншае значэнне" для кожнага апарата DCS |
| Прывязкі | запісаць кнопку або вось | запіс, сачэнне за ўводам, прывязка на малюнку прылады, Аўтапрызначэнне для любой камбінацыі прылад, майстар налады, «Раскласці з ШІ» |
| Налада восяў | крывізна, мёртвая зона, насычэнне DCS | для кожнай гульні ў яе ўласнай мадэлі водгуку, вобласці дзеяння для кожнага апарата, каліброўка, рэжым упору |
| Мадыфікатары | так | так, са старонкай мадыфікатараў, камбінацыямі, пераносам для кожнай гульні (BMS shift, ...) |
| Экспарт | DCS (clean, nuke) | кожная гульня; чатыры рэжымы плюс "ачысціць і іншыя", для кожнага апарата, мінімальная розніца са значэннямі DCS па змаўчанні, пазнакі для незапісаных прывязак, рэзервовыя копіі і адмена |
| Імпарт | DCS | кожная гульня, са значэннямі па змаўчанні, клавіятурай, аб'яднаннем прылад, паўторным імпартам назваў/груп/мадыфікатараў |
| Бяспека | "зрабіце рэзервовую копію самі" | аўтаматычныя рэзервовыя копіі з версіямі, адмова запісваць, пакуль гульня працуе, гісторыя профілю з адменай паміж сеансамі, пясочніца запісу ў тэстах |
| Праверкі | validate | праверка: карткі на мове гульні, выпраўленні адной пстрычкай, "выклікана" з гісторыі |
| Раскладкі | экспарт малюнкаў раскладкі | даведачныя малюнкі прылад (дакладная мадэль па VID:PID і HID-назве), шпаргалкі, 3D-выгляды прылад |
| Аверлэй | аверлэй у гульні | канструктар HUD, аверлэй, старонка трансляцыі для OBS, жывыя ўваходы |
| Спіс гульняў | пастаўляемая база даных (html) | будуецца на вашым ПК з вашай уласнай усталёўкі, абнаўляецца пасля абнаўленняў гульні |
| Назіранне | няма | назіральнік за канфігурацыямі гульняў з праграмай у вобласці апавяшчэнняў, пытае пасля выхаду з гульні |
| Зваротная сувязь па сіле | няма | зваротная сувязь па сіле з тэлеметрыі для DCS, IL-2, War Thunder і іншых (JoyPro.Ffb) |
| Віртуальныя прылады | няма | рэжым vJoy / геймпада Xbox з HidHide, віртуальныя функцыі, імпарт з Joystick Gremlin |
| Мовы | Англійская | 39 |
| Абнаўленні | спампоўка ўручную | праверка абнаўленняў з апісаннем выпуску, усталёўка з праверкай кантрольнай сумы |
| Справаздачы пра праблемы | спытаць у Discord | адзін файл падтрымкі з журналамі, наладамі і (па запыце) профілем; папка карыстальніка замененая; нічога не запампоўваецца |
#Архітэктура і якасць
- Падзел на рухавік і GUI. JoyPro 1 быў адной праграмай WPF з логікай у кодзе акна. У JoyPro 2 ёсць рухавік (
engine.exe, .NET Framework 4.8, чысты C#), які ўтрымлівае ўсю логіку профіляў, імпарту/экспарту і базы даных у выглядзе 451 каманд, і GUI на Avalonia (.NET 9), які запускае рухавік для кожнага дзеяння. Хуткія інтэрактыўныя каманды ідуць у адзін доўга працуючыengine serve, таму GUI застаецца хуткім, не адмаўляючыся ад падзелу. Усё, што робіць GUI, можна выконваць скрыптамі (гл. камандны радок рухавіка). - Асобныя працэсы для пастаянных задач:
JoyPro.Ffb.exe(зваротная сувязь па сіле з тэлеметрыі),JoyPro.VJoy.exe(перадатчык віртуальнага joystick),JoyPro.Tray.exe(назіральнік, пакуль GUI закрыты), кожны з бюджэтам рэсурсаў і доўгімі тэстамі на ўстойлівасць, каб яны заставаліся незаўважнымі ў фоне. - Тэсты: 1,537 аўтаматычных тэстаў (xUnit: логіка рухавіка, мадэлі выгляду, рэндэры старонак па-за экранам у светлай і цёмнай тэме), 87 частак smoke-тэсту рухавіка, якія запускаюць сапраўдны рухавік на тэставых папках, неабавязковы фільтр якасці з праверкамі інварыянтаў на сапраўдных даных і скразныя прагоны ў гульнях, якія гэта падтрымліваюць. Тэсты працуюць у пясочніцы запісу з праверкай адбітка сапраўдных папак, таму ніводны тэст не можа закрануць сапраўдныя папкі гульняў.
- Даныя: спісы каманд гульняў будуюцца на ПК карыстальніка з усталяванай гульні ў
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro пастаўляе толькі ўласныя даныя (каталог функцый, каталог прылад, табліцы пераўтварэння, база даных кабін). - Дакументацыя генеруецца з зыходнага кода: матрыца падтрымкі гульняў бярэцца з кода (
engine games support), даведка па CLI — зengine --help, а гэты сайт — з AXAML, мадэляў выгляду і дакументацыі.
#Звязанае
- Стан вікі: наколькі поўная гэтая дакументацыя
- Падтрымка гульняў: кожная гульня і тое, што JoyPro для яе робіць