JoyPro объясняет себя четырьмя способами. Режим справки (F1) превращает каждый щелчок в вопрос: щёлкните кнопку, поле, строку списка или вкладку, и маленькое окно рядом скажет, что это делает, какое место занимает и что будет дальше, — не выполняя действие. Туры указывают на настоящие кнопки шаг за шагом и ждут вашего щелчка; у каждой страницы есть свой Тур по этой странице. Приветствие один раз спрашивает, что вы хотите сделать, и начинает подходящим вам способом. Его быстрый ответ, «Просто заставь мою ручку работать», запускает быструю настройку JoyPro: ту же, что Готово, и настроить всё за меня при первом запуске и Настроить всё за меня на странице «Старт». Простые слова делают всё это максимально простым: крупные карточки и самые короткие предложения — для детей и для всех, кто хочет попроще.
Окно Ваши игры при самом первом запуске
Приветствие Что вы хотите сделать?
Тур или быстрая настройка что подходит к вашему ответу
Готово, и настроить всё за меня в окне Ваши игры пропускает приветствие: быстрая настройка начинается сразу. Без окна Ваши игры (вы обновляетесь со старой версии JoyPro 2) первым появляется приветствие.
Для начинающих
#Режим справки: щёлкните что угодно, чтобы узнать, что это делает
Нажмите F1 (или Справка вверху справа > Режим справки (F1)). Указатель мыши превращается в вопросительный знак, а строка вверху говорит: «Режим справки: щёлкните что угодно, чтобы узнать, что это делает. F1 или Esc завершает его».
Щёлкните элемент управления: он не выполняется. Маленькое окно рядом показывает:
сначала одно простое предложение о том, что он делает («Щёлкните, затем нажмите кнопку на ручке.»),
Больше подробностей / Меньше подробностей: более длинное объяснение, Почему это важно (для чего эта часть JoyPro в общей картине), Что будет дальше и Объяснение слов (до двух слов JoyPro из текста, каждое одним простым предложением: «Связка: одна задача, например 'шасси убрать', сразу во всех ваших играх и ЛА.»). По умолчанию раскрыто; с Простые слова начинается свёрнутым,
Подробнее в вики: статья об этом элементе на этом сайте.
Кнопка с меню (Справка, Ещё ...) перечисляет свои пункты, каждый с короткой строкой.
Пустое место страницы объясняет страницу.
Рамка под мышью показывает, какой элемент объяснит щелчок. Колесо мыши по-прежнему прокручивает страницу.
С клавиатуры: перейдите к элементу клавишей Tab и нажмите Enter или Space, чтобы увидеть его справку.
F1, Esc или Выйти из режима справки в строке вверху завершают режим справки; щелчки снова выполняют кнопки.
Когда вы впервые открываете эту версию JoyPro (и когда переходите со старой версии JoyPro 2), она один раз спрашивает: Что вы хотите сделать? Если показывается окно «Ваши игры» первого запуска, приветствие появляется сразу после него. JoyPro выбирает ответ, подходящий к найденным играм, и помечает его предложено; выберите другой, если он вам больше подходит.
Ответ
Что происходит
Играть в ACE COMBAT с моей ручкой управления
Тур, который превращает вашу ручку и РУД в ненастоящий контроллер Xbox: сначала Настроить всё за меня (быстрая настройка; карточка ждёт, пока открыто её окно, а её кнопка Настроить ненастоящий контроллер возвращает вас обратно), затем страница «Виртуальный джойстик»: бесплатный помощник 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 снова открывают его в любое время.
Тур затемняет окно и подсвечивает настоящий элемент управления, о котором идёт речь. Карточка рядом говорит, что делать; у четырёх карточек есть ещё маленькая картинка: что такое ось джойстика, что такое ненастоящий контроллер, что делает экспорт и как Alt+Tab возвращает вас из полноэкранной игры.
Многие шаги ждут вас: «Щёлкните «Связки» на панели внизу.» и «Ждём, когда вы щёлкнете светящуюся кнопку.» Шаг продолжается сам, когда вы щёлкаете. На шаге, который просит открыть страницу, Далее открывает её за вас — даже страницу, скрытую на нижней панели; на шаге, который ждёт другого щелчка, Далее продолжает без него.
Далее — большая синяя кнопка. Назад возвращает на шаг назад; маленькие ссылки Пропустить (пропускает шаг) и Завершить тур (останавливает). Завершить на последнем шаге заканчивает тур.
Закройте JoyPro посреди тура, и при следующем запуске он продолжится с того же шага.
Тур по этой странице (вверху справа, рядом со Справка, и в меню Справка) показывает открытую страницу: для чего она, её основные части и что дальше.
Настройки > Туры перечисляет все туры с кнопкой Начать тур; тур, пройденный до конца, помечен как просмотрено.
Для всех, кому нужны работающие кнопки и больше ничего, быстрый ответ приветствия открывает быструю настройку JoyPro (мастер настройки, который работает сам):
JoyPro находит ваши игры и устройства и делает настройку сам. Устройство, которого JoyPro не знает, называется простыми словами и настраивается как обычное устройство своего вида.
Проверка показывает результат простым списком: какая кнопка что делает («Кнопка 4: перезарядка пушек»). Показать изображение крупно показывает ваше устройство со всеми кнопками; Изменить что-то открывает инструменты, чтобы перенести, поменять местами или убрать функцию.
Вы нажимаете Использовать эти кнопки, затем Записать в мою игру (всегда только одна синяя кнопка). Старое управление игры сохраняется как резервная копия. Окно закрывается, и короткий тур показывает, где потом изменить кнопку.
Для игры, которая знает только контроллер Xbox (ACE COMBAT, Hell Let Loose: Vietnam), вторая кнопка вместо этого — Настроить ненастоящий контроллер: страница «Виртуальный джойстик» показывает последние шаги (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 и Space: 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 (встроен в интерфейс); --check не проходит, пока этот файл старше вики. Элемент сопоставляется по его команде, имени, подписи или подсказке.
Что запоминают приветствие и туры: ui-settings.json, "tours" (отвечено, выбранный путь, только главное или все возможности, просмотренные туры, тур в процессе и его шаг).
Параметры запуска: Services/StartupOptions.cs (--welcome, --tour), передача при втором запуске: AppShell.cs. Справка: Режим справки и туры.
17 элементов управления, прочитанных из исходного кода программы: 17 описано, 0 с фактами из исходного кода (подсказка, комментарий в коде, вызов движка), 0 ещё нужно расширить.
#Показывает или скрывает более подробное объяснение
Кнопкаописано
Показывает или скрывает более длинный текст.
«Больше подробностей» в окне справки показывает более подробное объяснение: что именно делает элемент, почему это важно, что будет дальше и какие слова JoyPro в нём встречаются.
Подсказка JoyPro назначает команды игры на вашу ручку и показывает вам результат
JoyPro выполняет этот шаг сам.
Собственная кнопка карточки, которая выполняет шаг за вас: в туре по геймпаду «Настроить всё за меня» запускает быструю настройку, а тур продолжается за её окном.
Подсказка Открывает копию профиля, который JoyPro 1 использовал последним (last.pr0file в «Документах», папка JoyPro). Собственный файл JoyPro 1 остаётся как есть.
Открыть мой профиль JoyPro 1: открывает его в JoyPro 2, который читает профили JoyPro 1 как есть.
JoyPro открывает копию, поэтому собственный файл JoyPro 1 остаётся без изменений; второй щелчок снова открывает эту копию.
#Крупный текст и очень короткие предложения в турах и справке. Изменить можно в любой момент в «Настройки > Туры».
Кнопкаописано
Переключает на крупный текст и очень короткие предложения.
«Слова попроще» включают или выключают простые слова прямо там, где карточку трудно читать: крупные карточки, самые короткие тексты и справка, которая начинается с одного простого предложения.
Тот же переключатель, что и в «Настройки > Туры»; сохраняется после перезапуска.
#Следующий шаг (шаг, который просит открыть страницу, откроет её за вас)
Кнопкаописано
Переходит к следующему шагу.
«Далее» переходит к следующему шагу тура, даже если шаг ждёт вашего щелчка.
На шаге, который просит открыть страницу, кнопка открывает её за вас, даже если вы скрыли её на нижней панели; на последнем шаге кнопка называется «Завершить» и заканчивает тур.