JoyPro2 Discord GitHub
Сторінки GUI

Режим довідки й тури

Показати:

JoyPro пояснює себе чотирма способами. Режим довідки (F1) перетворює кожне клацання на запитання: клацніть кнопку, поле, рядок списку чи вкладку, і маленьке вікно поруч скаже, що воно робить, де його місце і що буде далі, не виконуючи його. Тури вказують на справжні кнопки крок за кроком і чекають вашого клацання; кожна сторінка має власний Тур цією сторінкою. Привітання один раз запитує, що ви хочете зробити, і починає зі шляху, який вам підходить. Його швидка відповідь, «Просто щоб моя ручка запрацювала», запускає швидке налаштування JoyPro: те саме, що й Готово, і налаштувати все за мене під час першого запуску та Налаштувати все за мене на сторінці Початок. Прості слова роблять усе максимально простим: великі картки й найкоротші речення — для дітей і для всіх, хто хоче простіше.

  1. Вікно Ваші ігри
    під час найпершого запуску
  2. Привітання
    Що ви хочете зробити?
  3. Тур або швидке налаштування
    залежно від вашої відповіді

Готово, і налаштувати все за мене у вікні Ваші ігри пропускає привітання: швидке налаштування починається одразу. Без вікна Ваші ігри (ви оновлюєтеся зі старішої версії 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 (майстер налаштування, що працює сам):

  1. JoyPro знаходить ваші ігри та пристрої й сам робить налаштування. Пристрій, якого JoyPro не знає, називається простими словами й налаштовується як звичайний пристрій свого типу.
  2. Перегляд показує результат простим списком: яка кнопка що робить («Кнопка 4: Reload guns»). Показати зображення великим показує ваш пристрій з кожною кнопкою; Змінити щось відкриває інструменти, щоб перенести, обміняти або пропустити функцію.
  3. Ви натискаєте Використати ці кнопки, потім Записати в мою гру (одночасно лише одна синя кнопка). Старе керування гри зберігається як резервна копія. Вікно закривається, і короткий тур показує, де пізніше змінити кнопку.
  4. Для гри, яка знає лише контролер 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 ще треба розширити.

#Закрити

Кнопкаописано

Підказка Закрити цю довідку (режим довідки залишається ввімкненим)

Закриває це маленьке вікно.

Закриває це вікно довідки; режим довідки залишається ввімкненим.

Клацніть наступний елемент керування, щоб прочитати його довідку, або натисніть F1 чи Esc, щоб вийти з режиму довідки.

Докладніше (англійською)

#Показує або ховає довше пояснення

Кнопкаописано

Показує або ховає довший текст.

«Більше подробиць» у вікні довідки показує довше пояснення: що саме робить елемент, чому це важливо, що буде далі і які слова JoyPro в ньому трапляються.

У режимі «Прості слова» воно спочатку згорнуте.

Докладніше (англійською)

#Докладніше у вікі

Кнопкаописано

Підказка Відкриває сторінку цього елемента у вікі JoyPro у вашому браузері

Відкриває сайт JoyPro у браузері.

«Докладніше у вікі» відкриває у вашому браузері статтю про цей елемент керування у вікі JoyPro.

Там ви знайдете подробиці, зображення і те, як цей елемент працює разом з рештою JoyPro.

Докладніше (англійською)

#Налаштувати все за мене

Кнопкаописано

Підказка JoyPro призначає команди гри на вашу ручку керування й показує вам результат

JoyPro виконує цей крок сам.

Власна кнопка картки, яка виконує крок за вас: у турі з геймпадом «Налаштувати все за мене» запускає швидке налаштування, а тур триває за його вікном.

Докладніше (англійською)

#Відкрити мій профіль JoyPro 1

Кнопкаописано

Підказка Відкриває копію профілю, який JoyPro 1 використовував останнім (last.pr0file у «Документах», папка JoyPro). Власний файл JoyPro 1 залишається як є.

Відкрити мій профіль JoyPro 1: відкриває його в JoyPro 2, який читає профілі JoyPro 1 такими, як вони є.

JoyPro відкриває копію, тож власний файл JoyPro 1 залишається без змін; другий клік знову відкриває цю копію.

Докладніше (англійською)

#Назад

Кнопкаописано

Підказка Попередній крок

Повертає на крок назад.

«Назад» переходить до попереднього кроку цього туру.

На першому кроці кнопка сіра.

Докладніше (англійською)

#Великий текст і дуже короткі речення в турах і довідці. Змінити можна будь-коли в «Налаштування > Тури».

Кнопкаописано

Перемикає на великий текст і дуже короткі речення.

«Простіші слова» вмикають або вимикають прості слова саме там, де картку важко читати: великі картки, найкоротші тексти й довідка, що починається з одного простого речення.

Той самий перемикач, що й у «Налаштування > Тури»; зберігається після перезапуску.

Докладніше (англійською)

#Пропустити

Кнопкаописано

Підказка Пропустити цей крок і перейти до наступного

Пропускає цей крок.

«Пропустити» пропускає цей крок і переходить до наступного, не виконуючи його.

На останньому кроці вона закінчує тур.

Докладніше (англійською)

#Завершити тур

Кнопкаописано

Підказка Завершити тур (знову запустити його можна через кнопку «Довідка» > «Тури»)

Завершує тур.

«Завершити тур» зупиняє тур там, де він є, і прибирає затемнення.

Запустіть його знову будь-коли через «Довідка > Тури...» або «Налаштування > Тури».

Докладніше (англійською)

#Наступний крок (крок, який просить відкрити сторінку, відкриє її за вас)

Кнопкаописано

Переходить до наступного кроку.

«Далі» переходить до наступного кроку туру, навіть коли крок чекає вашого клацання.

На кроці, який просить відкрити сторінку, вона відкриває сторінку за вас, навіть ту, яку ви сховали з нижньої панелі; на останньому кроці кнопка показує «Завершити» і закінчує тур.

Докладніше (англійською)

#Вийти з режиму довідки

Кнопкаописано

Підказка Звичайний режим: клацання знову натискають кнопки (F1 або Esc роблять те саме)

Вимикає довідку. Кнопки знову працюють як зазвичай.

«Вийти з режиму довідки» вимикає режим довідки, тож клацання знову запускають кнопки.

F1 або Esc робить те саме.

Докладніше (англійською)

#JoyPro пропонує це на основі ігор, знайдених на цьому ПК

Параметрописано

Вибрати відповідь, яка пасує найкраще.

Одна відповідь на «Що ви хочете зробити?»: виберіть ту, що вам підходить, потім натисніть «Старт».

Відповідь з позначкою «запропоновано» - це та, яку JoyPro вибрав за іграми, знайденими на цьому ПК; «Без туру» нічого не запускає.

Докладніше (англійською)

#Короткий

Параметрописано

Підказка Найкоротший шлях: лише потрібні кроки

Короткий тур лише з важливими кроками.

«Лише головне»: вибраний вами тур показує лише потрібні кроки, найкоротшим шляхом.

JoyPro запам'ятовує цей вибір на потім.

Докладніше (англійською)

#Довгий, з усіма доповненнями

Параметрописано

Підказка Усі кроки, зокрема додаткові

Довгий тур, що показує все.

«Усі можливості»: вибраний вами тур показує кожен крок, також додаткові.

Докладніше (англійською)

#Прості слова: великий текст, короткі речення

Прапорецьописано

Підказка Великий текст і дуже короткі речення в турах і довідці. Змінити можна будь-коли в «Налаштування > Тури».

Великий текст і короткі речення в турах і довідці.

Прості слова: великі картки й найкоротші тексти в турах, а довідка починається з одного простого речення.

Той самий перемикач, що й у «Налаштування > Тури»; зберігається після перезапуску.

Докладніше (англійською)

#Вибір у привітанні

Кнопкаописано

Запускає вибране.

«Старт» починає вибраним вами шляхом: його тур, швидке налаштування або нічого для «Без туру».

Після цього привітання вважається таким, на яке ви відповіли, і більше не відкривається саме.

Докладніше (англійською)

#Не зараз

Кнопкаописано

Підказка Закриває привітання; саме воно більше не з'явиться

Закриває привітання. Нічого не запускається.

«Не зараз» закриває привітання, нічого не запускаючи.

Воно не повертається саме; «Довідка > Тури...», «Налаштування > Тури» або пункт JoyPro 2 - Tour поруч з JoyPro знову відкриває його.

Докладніше (англійською)