JoyPro2 Discord GitHub
Гульні

FSX і Prepar3D

Паказаць:

FSX, FSX: Steam Edition і Prepar3D v4, v5 і v6 захоўваюць вашы налады кіравання ў адным XML-файле ў %APPDATA%: адна карта на прыладу з яе восямі, кнопкамі і Hat, плюс клавіятура. JoyPro чытае гэты файл у ваш профіль, аб'ядноўвае яго з іншымі вашымі гульнямі ў сувязях і запісвае назад блок за блокам, пакідаючы фарматаванне, каментарыі і іншыя карты як ёсць. Кожны сімулятар — асобная гульня ў JoyPro, бо ў кожнага свой файл.

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

Microsoft Flight Simulator X напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine fsx
Файл прывязак
%APPDATA%\Microsoft\FSX\Controls\Standard.XML (XML)
Уваходы, якія чытае гульня
чытае 32 кнопкі, 8 восяў на joystick (паводле паведамленняў)
Спіс каманд з
уласны спіс падзей JoyPro (публічныя ідэнтыфікатары SDK) + падзеі з вашых файлаў кіравання і шаблона ўсталёўкі
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без мадыфікатара на прывязках joystick.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✓ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні
Microsoft Flight Simulator X: Steam Edition напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine fsxse
Файл прывязак
%APPDATA%\Microsoft\FSX-SE\Controls\ (або папка FSX), XML
Уваходы, якія чытае гульня
чытае 32 кнопкі, 8 восяў на joystick (паводле паведамленняў)
Спіс каманд з
як FSX
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без мадыфікатара на прывязках joystick.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✗ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні
Prepar3D v4 напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine p3d4
Файл прывязак
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml (XML)
Уваходы, якія чытае гульня
чытае 32 кнопкі, 8 восяў на joystick (паводле паведамленняў)
Спіс каманд з
уласны спіс падзей JoyPro + вашы файлы кіравання + Standard.xmlx з усталёўкі
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без мадыфікатара на прывязках joystick.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✗ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні
Prepar3D v5 напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine p3d5
Файл прывязак
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml (XML)
Уваходы, якія чытае гульня
чытае 32 кнопкі, 8 восяў на joystick (паводле паведамленняў)
Спіс каманд з
як Prepar3D v4
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без мадыфікатара на прывязках joystick.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✓ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні
Prepar3D v6 напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine p3d6
Файл прывязак
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml (XML)
Уваходы, якія чытае гульня
чытае 32 кнопкі, 8 восяў на joystick (паводле паведамленняў)
Спіс каманд з
як Prepar3D v4
  • ✓ Імпарт
  • ✓ Экспарт
  • ✓ Прывязкі клавіятуры
  • ◐ МадыфікатарыFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без мадыфікатара на прывязках joystick.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ◐ Майстар налады / Auto Assign
  • ✗ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні

З матрыцы падтрымкі, створанай з кода рухавіка: усе гульні.

Для пачаткоўцаў

#Запуск за 3 крокі

  1. Наладзіць усё за мяне
    на старонцы «Старт»
  2. Выкарыстаць гэтыя кнопкі
    спачатку паглядзіце спіс
  3. Запісаць у маю гульню
    сімулятар павінен быць закрыты

Да: запусціце сімулятар адзін раз з падключанымі прыладамі, потым закрыйце яго.

Потым: адкрыйце налады кіравання сімулятара і праверце прызначэнні. Гэтая інтэграцыя яшчэ не праверана на сапраўднай усталёўцы: калі ласка, паведаміце, што адрозніваецца.

Вы раней ужо прывязвалі кнопкі ў сімулятары? Тады старонка «Старт» прапануе Імпартаваць, потым запоўніць прабелы. Вашы прывязкі застаюцца, і новыя функцыі атрымліваюць толькі вольныя кнопкі. Гл. Хуткі старт: каб мая ручка запрацавала.

#Што JoyPro робіць для FSX і Prepar3D

  • Імпарт: восі, кнопкі і Hat вашых прылад трапляюць у ваш профіль разам з адчувальнасцю і нулявой зонай кожнай восі. Клавішы клавіятуры трапляюць, калі вы пра гэта просіце.
  • Сувязі: адна сувязь — гэта адна функцыя ва ўсіх вашых гульнях («Gear» у FSX, MSFS і X-Plane на адной кнопцы). Каманды — гэта публічныя назвы падзей сімулятараў (GEAR_TOGGLE, AXIS_AILERONS_SET ...).
  • Экспарт: JoyPro запісвае актыўны файл кіравання сімулятара, у які вы экспартуеце.

#Імпарт вашых прывязак

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

#Стварэнне і праверка сувязей

На старонцы Сувязі падзея сімулятара ў сувязі стаіць побач з той жа функцыяй у іншых вашых гульнях. Аб'яднайце іх з дапамогай працэсу сувязей, потым націсніце Праверыць зараз на старонцы «Экспарт» (Праверка).

#Экспарт

  1. Закрыйце сімулятар. Ён перазапісвае файл пры выхадзе; JoyPro адмаўляецца працаваць, пакуль запушчаны fsx.exe або Prepar3D.exe.
  2. Адкрыйце Экспарт і выкарыстоўвайце картку вашага сімулятара.
  3. Пакіньце Замяніць на маіх прыладах разам з Ачысціць і іншыя мае прылады, калі вы наладжваеце свае прылады ў JoyPro. Націсніце Экспартаваць зараз на картцы.
У гульні: Што вы бачыце ў FSX і Prepar3D

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

#Што вы робіце самі ў FSX і Prepar3D

  • Запусціце сімулятар адзін раз з падключанымі прыладамі, каб ён запісаў свой файл кіравання.
  • Праверце вынік пасля першага экспарту (гл. вышэй). Гэта першая сапраўдная праверка гэтай інтэграцыі на вашым ПК.
  • Hat прызначаецца цалкам і звычайна гэта панарамаванне выгляду (PAN_VIEW). Іншыя падзеі на асобных кірунках Hat не запісваюцца; прывязвайце іх у сімулятары.

#Тыповыя памылкі

  • «Сімулятар запушчаны»: закрыйце яго і экспартуйце зноў.
  • Прылада страціла прывязкі пасля перападключэння: Windows можа даць прыладзе новы GUID. Тады JoyPro знаходзіць яе карту па назве, калі такую назву мае роўна адна падключаная прылада (з папярэджаннем).
  • Прывязкі joystick з мадыфікатарам няма: фармат не мае мадыфікатараў на кнопках joystick. Клавішы могуць мець Ctrl, Shift і Alt.
Дадаткова

#Файлы, якія JoyPro чытае і запісвае

Сімулятар Файл кіравання
FSX (каробачная версія) %APPDATA%\Microsoft\FSX\Controls\Standard.XML (актыўны файл з fsx.cfg [CONTROLS] Controls_Current)
FSX: Steam Edition %APPDATA%\Microsoft\FSX-SE\Controls\ побач з каробачнай FSX, %APPDATA%\Microsoft\FSX\Controls\, калі ўсталявана адна
Prepar3D v4 / v5 / v6 %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (актыўны файл з Prepar3D.cfg [CONTROLS])
усе <file>.joypro.json (уваходы, якія запісаў JoyPro), <file>.joypro-meta.json (назвы, групы і налады восей для наступнага імпарту)

Standard.xmlx з Prepar3D (наборы прылад) і шаблон FSX у папцы ўсталёўкі чытаюцца для спіса каманд і ніколі не запісваюцца.

#Рэжымы экспарту ў FSX і Prepar3D

Рэжым Што адбываецца ў сімулятары
Толькі дадаць Ніколі не выдаляе і не замяняе блок. Прывязка на ўваходзе, які мае іншую падзею, не запісваецца і трапляе ў спіс.
Абнавіць, пакінуць прывязкі гульні Замяняе падзею на вашым уваходзе (канфлікт) і захоўвае ўсё астатняе.
Абнавіць, мой профіль мацнейшы Таксама выдаляе іншыя ўваходы падзей, якія вы прывязваеце (падключаныя прылады; клавіятуру — толькі з параметрам клавіятуры).
Замяніць на маіх прыладах Асноўныя карты прылад, якія вы запісваеце, захоўваюць толькі вашы прывязкі.
+ Ачысціць і іншыя мае прылады Асноўныя карты іншых падключаных прылад ачышчаюцца (самі карты застаюцца).

#Што ніколі не змяняецца

  • Карты прылад, якія не падключаны, прылады, што імпарт ігнаруе, і прылада vJoy, у якую JoyPro перадае сігналы.
  • Карты slew (... SLEW {GUID}), Mouse Yoke, Mouse Look, карты Prepar3D для асобных SimObject і карта клавіятуры, калі вы не экспартуеце прывязкі клавіятуры.
  • Акорды з дзвюх простых клавіш, каментарыі, фарматаванне і невядомыя элементы.

#Крывыя і налады

  • Дэталізацыя: агульная, адзін файл для ўсіх лятальных апаратаў.
  • Налады восі (мадэль восей fsx): адчувальнасць (ад 0 да 127) і нулявая зона (ад 0 да 127) для кожнай восі прылады, як на старонцы каліброўкі. Крывая па змаўчанні падганяецца (мёртвая зона — у нулявую зону, насычэнне — у адчувальнасць); форма крывой адпаведніка не мае. У рэжыме «Абнавіць» значэнні, зададзеныя ў сімулятары, застаюцца, калі значэнні JoyPro — звычайныя па змаўчанні.
  • Інвертаваць: адмоўная адчувальнасць.
  • Без зваротнай сувязі па сіле, налад гульні і тэлеметрыі. Назіральнік заўважае змяненні пасля закрыцця сімулятара.
Тэхнічныя падрабязнасці

#Унутры інтэграцыі FSX і Prepar3D

flowchart LR
  P["Ваш профіль<br/>(сувязі + прывязкі)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
  E --> X["Controls / Standard.XML:<br/>адна карта на прыладу<br/>(назва прылады {GUID}),<br/>KEYBOARD_MAIN (толькі з параметрам<br/>клавіятуры)"]
  X --> G["Налады кіравання сімулятара"]
Адзін файл кіравання на сімулятар. Карта клавіятуры запісваецца толькі з параметрам клавіятуры.

Код: engine\Games\FsxIntegration.cs (адзін клас, адна гульня на сімулятар), engine\Games\FsxControlsFile.cs (тэкставае рэдагаванне цэлых блокаў), engine\Games\FsxEvents.cs (спіс падзей JoyPro).

  • Фармат: <SimControls.Map> з <Name>, <Axis> (<Index> ад 0 да 7 = X, Y, Z, Rx, Ry, Rz, Slider, другі паўзунок; <AxEvent>, <AxScale>, <AxNull>), <Entry> (<Index> кнопкі ад 0, <Down> / <Up>, <DownRpt>1 для падзей з паўторам) і <POV> (увесь Hat). Загаловак encoding="Windows-1252".
  • Прылады: карта для кожнай прылады DirectInput з назвай <instance name>{<instance GUID>}; супастаўляецца па GUID, інакш па назве, калі яе мае роўна адна падключаная прылада. Прылада, якой няма ў файле, атрымлівае новую карту. Паведамляецца пра 32 кнопкі і 8 восей на прыладу.
  • Супастаўленне: JOY_X .. JOY_SLIDER2 у <Index> ад 0 да 7, JOY_BTN<n> у <Index> n-1, Hat — па кірунку ўверх (JOY_BTN_POV1_U).
  • Спіс каманд: engine fsx refresh-db (а таксама fsxse, p3d4, p3d5, p3d6): каля 150 падзей з назвамі JoyPro плюс кожная падзея, якую называюць вашы файлы кіравання і шаблоны сімулятара; падзеі AXIS_* — гэта восі.
  • Імпарт / экспарт: engine fsx paths (спачатку актыўны файл), engine fsx import, engine fsx scan, engine fsx export і тое ж для engine fsxse export, engine p3d4 export, engine p3d5 export, engine p3d6 export. Рэзервовая копія перад першым запісам.

#Вядомыя абмежаванні

  • Усё патрабуе праверкі на сапраўднай усталёўцы: загаловак Prepar3D v4+ і ці змяшчае <Name> па-ранейшаму GUID, дакладныя байты, якія запісваюць сімулятары, назва восі другога паўзунка, а таксама ці захоўвае сімулятар новую карту, якую JoyPro дадае для прылады, якой ён яшчэ не бачыў.
  • Назва файла канфігурацыі FSX: Steam Edition вызначана па здагадцы.
  • Тэсты: engine\tests\smoke\fsx.ps1 са штучным файлам, пабудаваным па задакументаваным фармаце.

Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): fsx-p3d.md.