JoyPro пояснює себе чотирма способами. Режим довідки (F1) перетворює кожне клацання на запитання: клацніть кнопку, поле, рядок списку чи вкладку, і маленьке вікно поруч скаже, що воно робить, де його місце і що буде далі, не виконуючи його. Тури вказують на справжні кнопки крок за кроком і чекають вашого клацання; кожна сторінка має власний Тур цією сторінкою. Привітання один раз запитує, що ви хочете зробити, і починає зі шляху, який вам підходить. Його швидка відповідь, «Просто щоб моя ручка запрацювала», запускає швидке налаштування JoyPro: те саме, що й Готово, і налаштувати все за мене під час першого запуску та Налаштувати все за мене на сторінці Початок. Прості слова роблять усе максимально простим: великі картки й найкоротші речення — для дітей і для всіх, хто хоче простіше.
Вікно Ваші ігри під час найпершого запуску
Привітання Що ви хочете зробити?
Тур або швидке налаштування залежно від вашої відповіді
Готово, і налаштувати все за мене у вікні Ваші ігри пропускає привітання: швидке налаштування починається одразу. Без вікна Ваші ігри (ви оновлюєтеся зі старішої версії JoyPro 2) першим іде привітання.
Для початківців
#Режим довідки: клацніть будь-що, щоб дізнатися, що воно робить
Натисніть F1 (або Довідка вгорі праворуч > Режим довідки (F1)). Вказівник миші перетворюється на знак питання, а рядок угорі каже: «Режим довідки: клацніть будь-що, щоб дізнатися, що воно робить. F1 або Esc завершує режим.»
Клацніть елемент керування: він не спрацює. Маленьке вікно поруч показує:
спершу одне просте речення про те, що він робить («Клацніть його, потім натисніть кнопку на ручці керування.»),
Більше подробиць / Менше подробиць: довше пояснення, Чому це важливо (для чого ця частина JoyPro в загальній картині), Що буде далі і Пояснення слів (до двох слів JoyPro з тексту, кожне одним простим реченням: «Зв'язок: одне завдання, як-от 'landing gear up', в усіх ваших іграх і літаках одночасно.»). Типово відкрито; з Прості слова спочатку закрито,
Докладніше у вікі: запис про цей елемент керування на цьому сайті.
Кнопка з меню (Довідка, Ще ...) показує свої пункти, кожен з коротким рядком.
Порожнє місце сторінки пояснює саму сторінку.
Контур під мишею показує, який елемент керування пояснить клацання. Коліщатко миші, як і раніше, прокручує сторінку.
З клавіатури: перейдіть до елемента керування клавішею Tab і натисніть Enter або Space, щоб побачити його довідку.
F1, Esc або Вийти з режиму довідки в рядку вгорі завершують режим довідки; клацання знову запускають кнопки.
Коли ви вперше відкриваєте цю версію JoyPro (також якщо переходите зі старішої JoyPro 2), вона один раз запитує: Що ви хочете зробити? Коли показується вікно «Ваші ігри» першого запуску, привітання йде одразу після нього. JoyPro вибирає відповідь, яка пасує до знайдених ігор, і позначає її як запропоновано; виберіть іншу, якщо вона вам більше підходить.
Відповідь
Що відбувається
Грати в ACE COMBAT з моєю ручкою керування
Тур, який перетворює вашу ручку керування й важіль газу на несправжній контролер Xbox: спершу Налаштувати все за мене (швидке налаштування; картка чекає, поки відкрите його вікно, а його кнопка Налаштувати несправжній контролер повертає вас назад), потім сторінка Віртуальний joystick: безкоштовний помічник ViGEmBus, якщо його немає (спершу позначте прапорець під ліцензією, потім Установіть ViGEmBus; Windows один раз запитує дозвіл), Тест на вкладці «Живий тест» (картка залишається, доки ви не порухаєте ручку й не натиснете Далі), і коли натискати Старт: запустіть гру; на її титульному екрані утримуйте Alt і натисніть Tab, щоб повернутися, клацніть Старт, Alt+Tab назад у гру.
DCS World або Falcon BMS
Тур шляхом DCS: ваш профіль, зчитування ваших прив'язок DCS, зв'язки для всіх літаків, криві осей, режим упору, експорт і перевірка.
Просто щоб моя ручка запрацювала
Швидке налаштування (нижче), потім «Вийшло!» на сторінці Початок і короткий тур: де пізніше змінити кнопку (виберіть команду гри в списку, потім Записати вхід), як знову надіслати її в гру, «Готово! Запустіть свою гру».
Показати мені все
П'ять ідей, на яких побудовано JoyPro (профіль, зв'язки, прив'язки, експорт, перевірка), по одній, з великими виділеннями; тур чекає ваших клацань.
Я користувався JoyPro 1
Де тепер кожна функція JoyPro 1: завантаження й збереження, імпорт, зв'язки, прив'язки й криві, експорт, перевірка. JoyPro 2 відкриває ваш профіль JoyPro 1 як є: тур пропонує Відкрити мій профіль JoyPro 1, коли знаходить його (відкривається копія; файл JoyPro 1 залишається). Пропонується, коли цей профіль є на ПК.
Без туру
Нічого не запускається.
Якої довжини тур?Короткий показує потрібні вам кроки; Довгий, з усіма доповненнями показує також доповнення (наприклад крок про упор у турі DCS). Прості слова (також у Налаштування > Тури) роблять кожну картку великою, а її текст — максимально коротким; німецька мова тоді звертається на «du». Натисніть Старт або Не зараз, щоб закрити привітання. У будь-якому разі воно само не повертається; Довідка > Тури..., Налаштування > Тури > Показати привітання і пункт JoyPro 2 - Tour поруч із JoyPro будь-коли відкривають його знову.
Тур затемнює вікно й підсвічує справжній елемент керування, про який іде мова. Картка поруч каже, що робити; чотири картки мають ще й маленьке зображення: що таке вісь joystick, що таке несправжній контролер, що робить експорт і як Alt+Tab повертає вас із повноекранної гри.
Багато кроків чекають на вас: «Клацніть „Зв'язки“ на панелі внизу.» і «Чекаю, поки ви клацнете підсвічену кнопку.» Крок продовжується сам, коли ви її клацнете. На кроці, який просить відкрити сторінку, Далі відкриває її за вас, навіть якщо ви приховали її на нижній панелі; на кроці, який чекає іншого клацання, Далі продовжує без нього.
Далі — це велика синя кнопка. Назад повертає на крок назад; маленькі посилання Пропустити (пропускає крок) і Завершити тур (зупиняє). Завершити на останньому кроці закінчує тур.
Якщо закрити JoyPro посеред туру, під час наступного запуску тур продовжиться з того самого кроку.
Тур цією сторінкою (угорі праворуч, поруч із Довідка, і в меню Довідка) показує відкриту сторінку: для чого вона, її основні частини і що далі.
Налаштування > Тури показує кожен тур з кнопкою Почати тур; тур, який ви пройшли до кінця, позначено як переглянуто.
#Швидке налаштування: «Просто щоб моя ручка запрацювала»
Для всіх, кому потрібні лише робочі кнопки, швидка відповідь привітання відкриває швидке налаштування JoyPro (майстер налаштування, що працює сам):
JoyPro знаходить ваші ігри та пристрої й сам робить налаштування. Пристрій, якого JoyPro не знає, називається простими словами й налаштовується як звичайний пристрій свого типу.
Перегляд показує результат простим списком: яка кнопка що робить («Кнопка 4: Reload guns»). Показати зображення великим показує ваш пристрій з кожною кнопкою; Змінити щось відкриває інструменти, щоб перенести, обміняти або пропустити функцію.
Ви натискаєте Використати ці кнопки, потім Записати в мою гру (одночасно лише одна синя кнопка). Старе керування гри зберігається як резервна копія. Вікно закривається, і короткий тур показує, де пізніше змінити кнопку.
Для гри, яка знає лише контролер Xbox (ACE COMBAT, Hell Let Loose: Vietnam), другою кнопкою натомість буде Налаштувати несправжній контролер: сторінка Віртуальний joystick показує останні кроки (ViGEmBus, Тест, Старт на титульному екрані). Цим іграм експорт не потрібен.
Коли щось заважає (гру не знайдено, ручку керування не знайдено), вікно простими словами каже, що робити, з кнопками Спробувати знову і Налаштувати покроково (майстер налаштування з усіма кроками).
Яка відповідь пропонується: встановлено DCS або Falcon BMS — DCS World або Falcon BMS. Встановлено лише ігри для контролера Xbox (ACE COMBAT 7, ACE COMBAT 8, Hell Let Loose: Vietnam) — Грати в ACE COMBAT з моєю ручкою керування. Будь-що інше або ще не знайдено жодної гри — Просто щоб моя ручка запрацювала. Рядок над відповідями називає ігри, на основі яких зроблено вибір.
Кнопка першого запуску «Готово, і налаштувати все за мене» відповідає на привітання швидким шляхом: відкривається налаштування, а привітання поруч не відкривається.
Один раз на користувача: привітання вважається завершеним після Старт або Не зараз, а також після Без туру. Налаштування > Тури > Запитати знову під час наступного запуску повертає його під час наступного запуску й знову позначає всі тури як непереглянуті.
Ніколи під час тестових запусків: привітання не відкривається, коли JoyPro працює у своїй тестовій пісочниці або зі змінною середовища JOYPRO_NO_WELCOME=1.
Запис JoyPro 2 - Tour: JoyPro 2 - Tour.cmd поруч із JoyPro.Gui.exe запускає JoyPro.Gui.exe --welcome (також --tour): привітання відкривається, навіть якщо на нього вже відповіли. Якщо JoyPro вже запущено, запущений екземпляр виходить на передній план і відкриває привітання.
Основне чи всі функції: вибір у привітанні зберігається для турів шляху; Налаштування > Тури має власний вибір для турів, запущених з його списку. Тур цією сторінкою завжди показує всі кроки.
Тури знаходять елементи керування за назвою, а не за положенням: розмір вашого вікна, масштаб інтерфейсу, тема й порядок нижньої панелі не мають значення. Якщо елемента керування немає на екрані, картка стоїть посередині затемненого вікна.
F1 нічого не робить, поки відкрито привітання. Запуск туру або привітання завершує режим довідки.
Швидке налаштування — те саме, що під час першого запуску й на сторінці «Початок»: воно саме виконує кроки майстра налаштування (engine setup devices, engine setup aircraft, engine setup plan) аж до його перевірки; Використати ці кнопки застосовує план (engine setup apply), а Записати в мою гру експортує ігри, як сторінка «Експорт» (з її резервною копією).
У грі: Швидке налаштування записує в гру
Швидке налаштування змінює гру, лише коли ви натискаєте Записати в мою гру: воно експортує ігри, як Експорт на сторінці «Експорт». Старе керування гри зберігається як резервна копія; Скасувати експорт на сторінці «Експорт» повертає його. Режим довідки й тури ніколи самі не змінюють ваш профіль чи ваші ігри; крок туру лише показує кнопку, а натискаєте її ви.
Шар: Views/Controls/HelpLayer.axaml (+ .axaml.cs) поверх вмісту вікна, у межах масштабу інтерфейсу; клавіші F1, Esc, Enter і пробіл: Views/MainWindow.Help.cs. Модель представлення: MainWindowViewModel.Help.cs, .Tours.cs; швидка відповідь викликає StartQuickSetupAsync (.AutoSetupStart.cs). Елемент керування під клацанням і його текст: Services/Help/HelpResolver.cs; тексти сторінок і пояснені слова: Services/Help/HelpCatalog.cs; тури: Services/Help/TourCatalog.cs.
Тексти для окремих елементів керування — це статті цієї вікі: python website/build.py --help-catalog записує перші два речення кожної статті в gui/JoyPro.Gui/Resources/help-controls.json (вбудовано в GUI); --check не проходить, поки цей файл старіший за вікі. Елемент керування зіставляється за його командою, назвою, підписом або підказкою.
Що запам'ятовують привітання й тури: ui-settings.json, "tours" (відповідь дано, вибраний шлях, основне чи всі функції, переглянуті тури, тур у процесі та його крок).
Параметри запуску: Services/StartupOptions.cs (--welcome, --tour), передавання під час другого запуску: AppShell.cs. Довідка: Режим довідки й тури.
17 елементів керування, зчитаних з вихідного коду програми: 17 описано, 0 з фактами з коду (підказка, коментар у коді, виклик рушія), 0 ще треба розширити.
«Більше подробиць» у вікні довідки показує довше пояснення: що саме робить елемент, чому це важливо, що буде далі і які слова JoyPro в ньому трапляються.
Підказка Відкриває копію профілю, який JoyPro 1 використовував останнім (last.pr0file у «Документах», папка JoyPro). Власний файл JoyPro 1 залишається як є.
Відкрити мій профіль JoyPro 1: відкриває його в JoyPro 2, який читає профілі JoyPro 1 такими, як вони є.
JoyPro відкриває копію, тож власний файл JoyPro 1 залишається без змін; другий клік знову відкриває цю копію.
#Великий текст і дуже короткі речення в турах і довідці. Змінити можна будь-коли в «Налаштування > Тури».
Кнопкаописано
Перемикає на великий текст і дуже короткі речення.
«Простіші слова» вмикають або вимикають прості слова саме там, де картку важко читати: великі картки, найкоротші тексти й довідка, що починається з одного простого речення.
Той самий перемикач, що й у «Налаштування > Тури»; зберігається після перезапуску.
#Наступний крок (крок, який просить відкрити сторінку, відкриє її за вас)
Кнопкаописано
Переходить до наступного кроку.
«Далі» переходить до наступного кроку туру, навіть коли крок чекає вашого клацання.
На кроці, який просить відкрити сторінку, вона відкриває сторінку за вас, навіть ту, яку ви сховали з нижньої панелі; на останньому кроці кнопка показує «Завершити» і закінчує тур.