JoyPro2 Discord GitHub
Галоўныя працэсы

Імпарт гульні

Паказаць:

Імпарт чытае налады кіравання, захаваныя гульнёй, і ператварае іх у профіль JoyPro: адна сувязь на функцыю з яе кнопкай або воссю. Гэта самы хуткі старт: усё, што вы ўжо наладзілі ў сваіх гульнях, трапляе ў профіль, і з гэтага моманту JoyPro трымае ўсё ў адным месцы.

flowchart LR
  G["Файлы кіравання<br/>вашай гульні"] --> I["Імпарт"]
  D["Вашы падключаныя<br/>прылады"] --> I
  I --> P["Ваш профіль:<br/>сувязі, прывязкі,<br/>мадыфікатары, крывыя"]
Імпарт толькі чытае. Гульня захоўвае свае прывязкі дакладна такімі, якія яны ёсць.
Для пачаткоўцаў

#Імпарт у тры пстрычкі

  1. Адкрыйце Старт (першая кнопка на ніжняй панэлі). У Вашы гульні кожная гульня, якую JoyPro знайшоў на вашым ПК, мае картку з малюнкам. Націсніце Імпарт на гульні, у якую вы гуляеце найбольш.
  2. JoyPro пытаецца, як:
    • Дадаць у мой профіль (рэкамендуецца) захоўвае тое, што ў вас ёсць, і дадае прывязкі гульні.
    • Пачаць нанова з гэтай гульні замяняе вашы сувязі тым, што ёсць у гульні (JoyPro спачатку захоўвае копію вашага профілю).
    • Браць таксама клавішы клавіятуры забірае і лётныя каманды на клавіятуры. Прывязкі прылад бяруцца заўсёды.
    • Для DCS: Усе мае лятальныя апараты DCS або зніміце сцяжок і выберыце лятальныя апараты.
  3. Націсніце Імпартаваць зараз. Праз імгненне картка паведамляе «Гатова: у вашым профілі цяпер 214 сувязей (180 прывязана)», а Паглядзець мае сувязі адкрывае іх. Спачатку паглядзець замест гэтага паказвае, што ёсць у гульні, нічога не змяняючы.
Старонка «Старт» з вашымі гульнямі і прыладаміСтаронка «Старт» з вашымі гульнямі і прыладамі
Старонка «Старт» з вашымі гульнямі і прыладамі (На малюнках праграма па-англійску.)

Профіль не адкрыты? JoyPro створыць яго для вас і з таго часу будзе захоўваць аўтаматычна (кнопкі «Захаваць» няма: кожная змена захоўваецца і можа быць адменена, нават пасля перазапуску).

#Што змяняецца ў гульні?

Нічога. Імпарт толькі чытае файлы гульні. Гульня захоўвае свае прывязкі дакладна такімі, якія яны ёсць, незалежна ад таго, ці будзеце вы потым экспартаваць.

#Імпартуйце, а потым няхай JoyPro запоўніць прабелы

На старонцы «Старт» картка «Наладзіць прылады» пералічвае гульні, у якіх вы самі рабілі прывязкі. Імпартаваць, потым запоўніць прабелы спачатку імпартуе такую гульню. Потым Запоўніць прабелы зараз... ставіць важныя функцыі на кнопкі, якія яшчэ вольныя. Вашы ўласныя прывязкі застаюцца. Для гульняў, якія ўжо ёсць у вашым профілі, картка прапануе Запоўніць прабелы....

#Перад першым імпартам: спіс каманд

JoyPro павінен ведаць каманды кожнай гульні (іх назвы і ідэнтыфікатары). Ён будуе гэты спіс адзін раз з вашай уласнай усталёўкі. Калі спіса няма, старонка «Старт» паказвае Пабудаваць спіс (або Пабудаваць усе адсутныя спісы); пасля абнаўлення гульні картка гульні прапануе Абнавіць. Гэта займае ад некалькіх секунд да некалькіх хвілін (DCS чытае кожны модуль).

Дадаткова

#Параметры і што яны робяць

Параметр Па змаўчанні Эфект
Дадаць у мой профіль / Пачаць нанова Дадаць «Дадаць» аб'ядноўвае з адкрытым профілем; «Пачаць нанова» замяняе яго сувязі пасля пацвярджэння і копіі профілю.
Браць таксама клавішы клавіятуры ваш апошні выбар Таксама трапляюць лётныя каманды, прывязаныя да клавіш.
Імпартаваць і непадключаныя прылады уключана Прылады, якія зараз не падключаны, таксама імпартуюцца (карысна для ручкі кіравання, якую вы падключыце пазней). Выключана: яны прапускаюцца і падлічваюцца.
Лічыць прылады з аднолькавай назвай адной прыладай уключана Windows час ад часу дае прыладзе новы ID; яе старыя і новыя файлы чытаюцца як адна прылада на падключаным ID. Дзве аднолькавыя прылады, падключаныя адначасова, застаюцца асобна.
Уключыць прывязкі па змаўчанні (DCS, форма для экспертаў) уключана Кожная прывязка па змаўчанні, якую DCS мае актыўнай для імпартаванай прылады, трапляе ў профіль, каб імпарт, а потым экспарт «Замяніць» + «Ачысціць і іншыя» пакідаў DCS такім, якім ён быў. Вашы ўласныя прывязкі мацнейшыя за прывязку па змаўчанні на тым жа ўваходзе.
Імпартаваць інверсію / паўзунок / выгін / мёртвую зону / насычэнне (форма для экспертаў) выкл. Бярэ значэнні, зададзеныя у гульні, для прывязак, якія JoyPro не экспартаваў сам. Прывязка, якую экспартаваў JoyPro, атрымлівае сваю наладу назад і без гэтага.
DCS: ігнараваць лятальныя апараты *_easy выкл. Копіі лятальных апаратаў для лёгкага рэжыму прапускаюцца.

Імпарт для экспертаў (старонка «Старт», пад карткамі, і старонка «Дадаткова») прапануе кожны параметр рухавіка для кожнай гульні з кнопкамі Сканаваць (папярэдні прагляд), Імпарт і Экспарт. Кожны выбар запамінаецца для наступнага імпарту.

#Назвы, групы і мадыфікатары вяртаюцца

Файл гульні змяшчае толькі прыладу, уваход і, магчыма, крывую. Экспарт JoyPro захоўвае побач свае ўласныя даныя, а імпарт счытвае іх назад:

Гульня Даныя JoyPro Аднаўляецца
DCS <aircraft>\joystick\<device>.jp, modifiers.lua назва сувязі, групы (па парадку), мадыфікатары з назвамі, інверсія, паўзунок, мёртвая зона, насычэнне, крывая
IL-2 Great Battles data\input\jp.actions назва, групы, псеўданім, мадыфікатары, дакладная налада
Гульні з рэестра гульняў (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json назва, групы, псеўданім, мадыфікатары, налада
Star Citizen actionmaps.jp назвы

Бягучы стан гульні мацнейшы: крывая, якую вы змянілі ў DCS пасля экспарту, захоўваецца. Прывязкі, якія JoyPro ніколі не экспартаваў, атрымліваюць назву, складзеную з дзеяння гульні, і групы DCS, IL2 або GENERATED + гульня.

#Дзве ахоўныя праверкі

  • Змены, яшчэ не экспартаваныя. Калі вы змянілі прывязкі ў JoyPro і яшчэ не экспартавалі іх у гэтую гульню, імпарт вярнуў бы старыя прывязкі. JoyPro спачатку пытаецца.
  • Ужо імпартавана? Калі ў профілі ўжо ёсць гульня, змены, якія вы потым зробіце ў гульні, трапляюць праз назіральнік за гульнямі (ён пытаецца пасля закрыцця гульні); паўторны імпарт па-ранейшаму робіцца адной пстрычкай.
У гульні: Што чытае імпарт для кожнага тыпу гульні

Імпарт ніколі не запісвае ў папку гульні. Што ён чытае:

  • DCS: прывязкі кожнага лятальнага апарата і прылады, вашы мадыфікатары, а з «Уключыць прывязкі па змаўчанні» — прывязкі, якія DCS мае па змаўчанні для кожнай прылады.
  • IL-2 Great Battles / Korea: раскладку клавіш і водгукі восяў.
  • Star Citizen: прывязкі клавіш галіны (LIVE, PTU ...) разам з уласнымі прывязкамі джойсціка гульні па змаўчанні на js1.
  • Гульні з пяхотай або тэхнікай (War Thunder, Arma, Reforger, WARDOGS ...): толькі лётныя дзеянні; усё астатняе ігнаруецца, а не выдаляецца.
  • MSFS: профілі ўводу сімулятара (версіі Steam або Microsoft Store) і, па запыце, прэсеты сімулятара па змаўчанні.

Прылады, якія гульня не можа адрозніць (у некаторых гульнях — дзве прылады адной мадэлі), і прывязкі да паловы восі (Elite) прапускаюцца і называюцца ў выніку.

Тэхнічныя падрабязнасці

#Як гэта працуе ўнутры

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Ён выклікае AskAboutUnexportedChangesAsync (рухавік sync pending), пацвярджае «Пачаць нанова» і захоўвае копію профілю (BackupProfileBeforeChange("before-import")), потым выклікае імпарт гульні: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync або ImportRegistryGameAsync. Спачатку паглядзець робіць тое ж самае са scan (PreviewImportWizardAsync) і адкрывае панэль «Вывад».
  2. Рухавік. Для DCS: engine dcs import [--path <Saved Games\DCS>] --merge --include-defaults [--plane <a> --plane <b>] --include-keyboard true|false --ignore-easy-planes false --only-connected false --merge-same-name true. Імпарцёр чытае кожны файл прылады, супастаўляе прыладу па GUID асобніка DirectInput і назве, супастаўляе кожны ідэнтыфікатар каманды са спісам каманд гульні (DB\<game> у %LOCALAPPDATA%\JoyPro2\GameData) і будуе адну сувязь на функцыю і ўваход. Выпраўленні пры загрузцы (--load-corrections, --correction-mode) пераназначаюць перайменаваныя ідэнтыфікатары каманд з ацэнкай упэўненасці.
  3. Профіль. Сувязі аб'ядноўваюцца па назве і па аднолькавым уваходзе; мадыфікатары ствараюцца з modifiers.lua (DCS) або з налад shift гульні. Профіль захоўваецца атамарна, і кожнае захаванне — гэта версія ў <data>\ProfileHistory (адмена працуе і пасля перазапуску).
  4. Назіральнік. Імпарт гульні без запісу сінхранізацыі запамінае файлы гульні, таму змены, якія вы потым зробіце ў гульні, будуць заўважаны (<data>\Sync\<game>.json).

#Файлы, якія ён чытае

Гульня Файлы
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua і modifiers.lua, а таксама чыстыя профілі, якія JoyPro пабудаваў з вашай усталёўкі DCS
IL-2 Great Battles / Korea data\input\*.actions і водгукі восей
Star Citizen actionmaps.xml галіны
MSFS аддаленая папка Steam або захаванне Microsoft Store

Параметры GUI як параметры рухавіка: «Дадаць» — --merge, клавіятура — --include-keyboard true, непадключаныя прылады — --only-connected false, аднолькавая назва — --merge-same-name true, лёгкія лятальныя апараты — --ignore-easy-planes true. Ахоўная праверка для змен, яшчэ не экспартаваных, — engine sync pending.

Каманды рухавіка: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import і engine <game> import для кожнай гульні з рэестра гульняў (напрыклад engine warthunder import, engine msfs2024 import). Правілы паўторнага імпарту: паўторны імпарт. Тэсты: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.