JoyPro2 Discord GitHub
界面页面

帮助模式和导览

显示:

JoyPro 用四种方式解释自己。帮助模式(F1)会把每次点击变成一个提问:点击一个按钮、输入框、列表行或选项卡,旁边就会出现一个小窗口,说明它的作用、它在整体中的位置以及接下来会发生什么,而不会真的执行它。导览 会一步一步地指向真实的按钮,并等待你点击;每个页面都有自己的 本页导览。欢迎界面 会问一次你想做什么,并以适合你的方式开始。它的快捷回答“让我的摇杆直接能用”会启动 JoyPro 的快速设置:与首次启动时的 完成,并全部帮我设置好 以及开始页面上的 全部帮我设置好 是同一个。简单用语 会让这一切尽可能简单:大卡片和最短的句子,适合孩子以及任何希望简单的人。

  1. 首次启动时的
    你的游戏 窗口
  2. 欢迎界面
    你想做什么?
  3. 导览或快速设置
    取决于你的回答

在 你的游戏 窗口中按 完成,并全部帮我设置好 会跳过欢迎界面:快速设置会立即开始。如果没有 你的游戏 窗口(你是从旧版 JoyPro 2 更新的),则会先显示欢迎界面。

新手入门

#帮助模式:点击任何东西了解它的作用

按 F1(或右上角的 帮助 > 帮助模式(F1))。鼠标指针会变成问号,顶部会出现一行:“帮助模式:点击任何内容即可查看它的作用。按 F1 或 Esc 结束。”

  • 点击一个控件:它 不会 被执行。旁边会出现一个小窗口,显示:
    • 首先是一句说明它作用的简单的话(“点击它,然后按下摇杆上的一个按钮。”),
    • 更多详情 / 更少详情:较长的说明、为什么重要(JoyPro 的这一部分在整体中有什么用)、接下来会发生什么 和 词语解释(文中最多两个 JoyPro 术语,每个用一句简单的话解释:“关联:一件事,比如‘收起起落架’,同时作用于你所有的游戏和飞机。”)。默认展开;开启 简单用语 时默认折叠,
    • 在 Wiki 中了解更多:该控件在本网站上的条目。
  • 带菜单的按钮(帮助、更多……)会列出它的各个条目,每个条目附一行简短说明。
  • 页面上的 空白处 会解释整个页面。
  • 鼠标下方的轮廓显示点击会解释哪个控件。鼠标滚轮仍然可以滚动页面。
  • 使用键盘:用 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 旁边的 JoyPro 2 - Tour 条目随时都可以再次打开它。

#导览

导览会让窗口变暗,并让它所讲的真实控件发光。旁边的卡片会说明要做什么;有四张卡片还附有一张小图:什么是摇杆的轴、什么是模拟手柄、导出会做什么,以及 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.Gui.exe 旁边的 JoyPro 2 - Tour.cmd 会以 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。
  • 每个控件的说明文字就是本 wiki 的条目:python website/build.py --help-catalog 把每个条目的前两句写入 gui/JoyPro.Gui/Resources/help-controls.json(嵌入在 GUI 中);只要该文件比 wiki 旧,--check 就会失败。控件按其命令、名称、标签或提示文字进行匹配。
  • 欢迎界面和导览会记住的内容:ui-settings.json,"tours"(是否已回答、所选路线、只看要点还是所有功能、看过的导览、正在进行的导览及其步骤)。
  • 启动选项:Services/StartupOptions.cs(--welcome、--tour),第二次启动时的移交:AppShell.cs。参考:帮助模式和导览。

#参考资料

本页背后的功能文档,由代码仓库生成:

#本页上的每个控件

17 个控件,读取自程序的源代码:17 个已撰写,0 个附有源代码中的信息(工具提示、代码注释、引擎调用),0 个尚待扩充。

#关闭

按钮已撰写

工具提示 关闭此帮助(帮助模式保持开启)

关闭这个小窗口。

关闭这个帮助窗口;帮助模式保持开启。

点击下一个控件来阅读它的帮助,或按 F1 或 Esc 结束帮助模式。

更多详情(英文)

#显示或隐藏更长的说明

按钮已撰写

显示或隐藏更长的文字。

帮助窗口中的“更多详情”会显示更长的说明:这个控件的完整作用、为什么重要、接下来会发生什么,以及其中的 JoyPro 用语。

使用简单用语时,它一开始是收起的。

更多详情(英文)

#在 Wiki 中了解更多

按钮已撰写

工具提示 在浏览器中打开此控件在 JoyPro Wiki 中的页面

在浏览器中打开 JoyPro 网站。

“在 Wiki 中了解更多”会在浏览器中打开 JoyPro Wiki 上此控件的条目。

在那里你会找到详细信息、图片,以及该控件如何与 JoyPro 的其他部分配合工作。

更多详情(英文)

#全部帮我设置好

按钮已撰写

工具提示 JoyPro 把游戏的操作放到你的摇杆上,并把结果给你看

JoyPro 会完成这一步。

卡片上替你完成这一步的按钮:在手柄导览中,“全部帮我设置好”会开始快速设置,导览会在它的窗口后面继续。

更多详情(英文)

#打开我的 JoyPro 1 配置文件

按钮已撰写

工具提示 打开 JoyPro 1 上次使用的配置文件的副本(“文档”中 JoyPro 文件夹里的 last.pr0file)。JoyPro 1 自己的文件保持不变。

打开我的 JoyPro 1 配置文件:在 JoyPro 2 中打开它,JoyPro 2 会按原样读取 JoyPro 1 的配置文件。

JoyPro 打开的是副本,所以 JoyPro 1 自己的文件保持不变;再次点击会重新打开这个副本。

更多详情(英文)

#返回

按钮已撰写

工具提示 上一步

返回上一步。

“返回”会回到本导览的上一步。

在第一步时它是灰色的。

更多详情(英文)

#在导览和帮助中使用大字和很短的句子。可随时在“设置 > 导览”中更改。

按钮已撰写

切换为大字和非常短的句子。

“更简单的用词”可在卡片难以阅读的地方直接打开或关闭简单用语:大卡片、最短的文字,以及以一句简单的话开头的帮助。

与“设置 > 导览”中的开关相同;重启后仍会保留。

更多详情(英文)

#跳过

按钮已撰写

工具提示 跳过这一步,进入下一步

跳过这一步。

“跳过”会略过这一步,不执行它,直接进入下一步。

在最后一步,它会结束导览。

更多详情(英文)

#结束导览

按钮已撰写

工具提示 结束导览(可通过“帮助”按钮 > 导览 重新开始)

结束导览。

“结束导览”会在当前位置停止导览,并取消变暗效果。

随时可以通过“帮助 > 导览...”或“设置 > 导览”重新开始。

更多详情(英文)

#下一步(如果某一步要求你打开页面,会为你打开它)

按钮已撰写

前往下一步。

“下一步”会进入导览的下一步,即使该步骤正在等待你点击。

在要求你打开某个页面的步骤中,它会替你打开该页面,即使是你在底部栏中隐藏的页面;在最后一步,按钮会显示“完成”,并结束导览。

更多详情(英文)

#结束帮助模式

按钮已撰写

工具提示 恢复正常:点击会再次执行按钮操作(按 F1 或 Esc 效果相同)

结束帮助。按钮恢复正常工作。

“结束帮助模式”会关闭帮助模式,这样点击会重新执行按钮。

按 F1 或 Esc 效果相同。

更多详情(英文)

#JoyPro 根据在这台电脑上找到的游戏给出此建议

选项已撰写

选择最合适的答案。

“你想做什么?”的一个回答:选择适合你的那个,然后按“开始”。

标记为推荐的回答是 JoyPro 根据在这台电脑上找到的游戏选出的;“不需要导览”不会开始任何内容。

更多详情(英文)

#简短

选项已撰写

工具提示 最短的方式:只包含你需要的步骤

只包含重要步骤的简短导览。

“只看要点”:你选择的导览只显示你需要的步骤,走最短的路。

JoyPro 会为以后记住这个选择。

更多详情(英文)

#详细,含所有额外内容

选项已撰写

工具提示 每一个步骤,包括额外功能

展示所有内容的详细导览。

“所有功能”:你选择的导览会显示每一步,包括额外内容。

更多详情(英文)

#简单用语:大字、短句

复选框已撰写

工具提示 在导览和帮助中使用大字和很短的句子。可随时在“设置 > 导览”中更改。

在导览和帮助中使用大字和短句。

简单用语:导览中使用大卡片和最短的文字,帮助以一句简单的话开头。

与“设置 > 导览”中的开关相同;重启后仍会保留。

更多详情(英文)

#开始欢迎选项

按钮已撰写

开始所选的内容。

“开始”会按你选择的方式开始:它的导览、快速设置,或者在选择“不需要导览”时什么也不做。

之后欢迎界面算作已回答,不会再自动打开。

更多详情(英文)

#暂不

按钮已撰写

工具提示 关闭欢迎界面;它不会自动再次出现

关闭欢迎界面。不会开始任何内容。

“暂不”会关闭欢迎界面,不开始任何操作。

它不会自动再出现;“帮助 > 导览...”、“设置 > 导览”或 JoyPro 旁边的“JoyPro 2 - Tour”条目都可以再次打开它。

更多详情(英文)