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 крокі
- Наладзіць усё за мяне
на старонцы «Старт» - Выкарыстаць гэтыя кнопкі
спачатку паглядзіце спіс - Запісаць у маю гульню
сімулятар павінен быць закрыты
Да: запусціце сімулятар адзін раз з падключанымі прыладамі, потым закрыйце яго.
Потым: адкрыйце налады кіравання сімулятара і праверце прызначэнні. Гэтая інтэграцыя яшчэ не праверана на сапраўднай усталёўцы: калі ласка, паведаміце, што адрозніваецца.
Вы раней ужо прывязвалі кнопкі ў сімулятары? Тады старонка «Старт» прапануе Імпартаваць, потым запоўніць прабелы. Вашы прывязкі застаюцца, і новыя функцыі атрымліваюць толькі вольныя кнопкі. Гл. Хуткі старт: каб мая ручка запрацавала.
#Што JoyPro робіць для FSX і Prepar3D
- Імпарт: восі, кнопкі і Hat вашых прылад трапляюць у ваш профіль разам з адчувальнасцю і нулявой зонай кожнай восі. Клавішы клавіятуры трапляюць, калі вы пра гэта просіце.
- Сувязі: адна сувязь — гэта адна функцыя ва ўсіх вашых гульнях («Gear» у FSX, MSFS і X-Plane на адной кнопцы). Каманды — гэта публічныя назвы падзей сімулятараў (
GEAR_TOGGLE,AXIS_AILERONS_SET...). - Экспарт: JoyPro запісвае актыўны файл кіравання сімулятара, у які вы экспартуеце.
#Імпарт вашых прывязак
- Адкрыйце Старт. Картка вашага сімулятара паказвае яго малюнак. Калі яна просіць спіс каманд, націсніце Пабудаваць спіс: JoyPro аб'ядноўвае свой уласны спіс падзей з падзеямі, якія называюць вашы файлы кіравання (і ўласныя файлы-шаблоны сімулятара).
- Націсніце Імпарт на картцы. Выберыце Дадаць у мой профіль і пастаўце птушку Браць таксама клавішы клавіятуры, калі хочаце мець і свае клавішы.
- Націсніце Імпартаваць зараз. Паглядзець мае сувязі адкрывае тое, што было імпартавана.
#Стварэнне і праверка сувязей
На старонцы Сувязі падзея сімулятара ў сувязі стаіць побач з той жа функцыяй у іншых вашых гульнях. Аб'яднайце іх з дапамогай працэсу сувязей, потым націсніце Праверыць зараз на старонцы «Экспарт» (Праверка).
#Экспарт
- Закрыйце сімулятар. Ён перазапісвае файл пры выхадзе; JoyPro адмаўляецца працаваць, пакуль запушчаны
fsx.exeабоPrepar3D.exe. - Адкрыйце Экспарт і выкарыстоўвайце картку вашага сімулятара.
- Пакіньце Замяніць на маіх прыладах разам з Ачысціць і іншыя мае прылады, калі вы наладжваеце свае прылады ў JoyPro. Націсніце Экспартаваць зараз на картцы.
Запусціце сімулятар і адкрыйце яго налады кіравання: там паказваюцца прызначэнні вашых прылад, а адчувальнасць і нулявая зона кожнай восі — на яго старонцы каліброўкі. Дакладны шлях у меню і тое, як сімулятары паказваюць файл 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.