JoyPro2 Discord GitHub
Праект

Ад JoyPro 1 да JoyPro 2

Паказаць:

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"]
JoyPro 1: адно акно, якое рабіла ўсё, для DCS.
flowchart TB
  G["Акно"] --> E["Рухавік<br/>(выконвае кожнае дзеянне)"]
  G --> F["Памочнік<br/>зваротнай сувязі па сіле"]
  G --> V["Памочнік<br/>віртуальнага joystick"]
  T["Назіральнік<br/>у вобласці апавяшчэнняў"] --> E
  E --> D2["36 гульняў"]
  F ~~~ V
JoyPro 2: акно, якое перадае кожнае дзеянне рухавіку, з памочнікамі для зваротнай сувязі па сіле, віртуальнага joystick і назіральніка.
Для пачаткоўцаў

#Што лепш для вас

  • Шмат гульняў, адзін профіль. 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, мадэляў выгляду і дакументацыі.