JoyPro2 Discord GitHub
Страницы GUI

Режим справки и туры

Показать:

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

  1. Окно Ваши игры
    при самом первом запуске
  2. Приветствие
    Что вы хотите сделать?
  3. Тур или быстрая настройка
    что подходит к вашему ответу

Готово, и настроить всё за меня в окне Ваши игры пропускает приветствие: быстрая настройка начинается сразу. Без окна Ваши игры (вы обновляетесь со старой версии 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 (мастер настройки, который работает сам):

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

#Закрыть

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

Подсказка Закрыть эту справку (режим справки остаётся включённым)

Закрывает это маленькое окно.

Закрывает это окно справки; режим справки остаётся включённым.

Щёлкните следующий элемент, чтобы прочитать его справку, или нажмите 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 снова открывают его.

Подробнее (на английском)