JoyPro2 Discord GitHub
GUI 頁面

說明模式與導覽

顯示:

JoyPro 用四種方式說明自己。說明模式(F1)會把每次點擊變成一個問題:點一個按鈕、欄位、清單列或分頁,它旁邊的小視窗就會說明它的作用、它在整體中的位置,以及接下來會發生什麼,而不會執行它。導覽 會一步一步指向真正的按鈕,並等您點擊;每個頁面都有自己的 本頁導覽。歡迎畫面 會詢問一次您想做什麼,並以適合您的方式開始。它的快速答案「讓我的搖桿直接能用」會啟動 JoyPro 的快速設定:和首次啟動時的 完成,並全部幫我設定好 以及「開始」頁面上的 全部幫我設定好 是同一個。簡單用語 會讓這一切變得盡可能簡單:大卡片和最短的句子,適合兒童和任何想要簡單的人。

  1. 您的遊戲 視窗
    在第一次啟動時
  2. 歡迎畫面
    您想做什麼?
  3. 導覽或快速設定
    依您的答案而定

在 您的遊戲 視窗中按 完成,並全部幫我設定好 會略過歡迎畫面:快速設定會立即開始。沒有 您的遊戲 視窗時(您從較舊的 JoyPro 2 更新),會先顯示歡迎畫面。

給新手

#說明模式:點任何東西了解它的作用

按 F1(或右上角的 說明 > 說明模式 (F1))。滑鼠指標會變成問號,頂端會有一行字:「說明模式:點選任何項目即可了解其功能。按 F1 或 Esc 結束。」

  • 點一個控制項:它 不會 執行。它旁邊的小視窗會顯示:
    • 先用一句簡單的話說明它的作用(「點一下,然後按下搖桿上的按鈕。」),
    • 更多詳情/更少詳情:較長的說明、為什麼重要(這部分在 JoyPro 整體中的用途)、接下來會發生什麼 和 詞語解釋(文字中最多兩個 JoyPro 用語,各用一句簡單的話說明:「關聯:一件事,例如『放下起落架』,同時適用於您所有的遊戲和飛機。」)。預設為展開;使用 簡單用語 時則一開始是收合的,
    • 更多內容請見 Wiki:本網站上該控制項的條目。
  • 帶有選單的按鈕(說明、更多……)會列出它的項目,每個項目附一行簡短說明。
  • 頁面上的空白處 會說明該頁面。
  • 滑鼠下方的外框會顯示點擊會說明哪個控制項。滑鼠滾輪仍然可以捲動頁面。
  • 使用鍵盤:用 Tab 移到一個控制項,然後按 Enter 或 空白鍵 查看它的說明。
  • 按 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 旁邊的 JoyPro 2 - Tour 項目,隨時都可以再次開啟它。

#導覽

導覽會讓視窗變暗,並讓它所說明的真正控制項發光。旁邊的卡片會告訴您要做什麼;其中四張卡片還附有一張小圖:搖桿的軸是什麼、模擬手把是什麼、匯出做了什麼,以及 Alt+Tab 如何讓您從全螢幕遊戲回來。

  • 許多步驟會 等您操作:「請點選底部列中的『關聯』。」和「正在等您點選發光的按鈕。」當您點擊後,步驟就會自動繼續。在要求您開啟某個頁面的步驟中,下一步 會幫您開啟它,即使是您在底部列中隱藏的頁面也可以;在等待其他點擊的步驟中,下一步 會直接繼續,不需要那次點擊。
  • 下一步 是大的藍色按鈕。返回 會回到上一步;還有小連結 略過(跳過一個步驟)和 結束導覽(停止)。最後一步的 完成 會結束導覽。
  • 在導覽中途關閉 JoyPro,下次啟動時會從同一個步驟繼續。
  • 本頁導覽(右上角,在 說明 旁邊,也在 說明 選單中)會介紹目前開啟的頁面:它的用途、主要部分,以及接下來要做什麼。
  • 設定 > 導覽 會列出每個導覽,附有 開始導覽;跑完的導覽會標示為 已看過。

#快速設定:「讓我的搖桿直接能用」

對於只想要按鈕能用、其他什麼都不要的人,歡迎畫面的快速答案會開啟 JoyPro 的快速設定(自動執行的 設定精靈):

  1. JoyPro 會找到您的遊戲和裝置,並自行完成設定。JoyPro 不認得的裝置會以淺顯的文字命名,並像同類型的一般裝置一樣設定。
  2. 檢閱會以簡單的清單顯示結果:哪個按鈕做什麼(「按鈕 4:武器重新裝彈」)。放大顯示圖片 會顯示您的裝置和每個按鈕;做些修改 會開啟用來移動、交換或略過功能的工具。
  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.Gui.exe 旁邊的 JoyPro 2 - Tour.cmd 會啟動 JoyPro.Gui.exe --welcome(也可用 --tour):即使之前已回答過,歡迎畫面仍會開啟。如果 JoyPro 已在執行,執行中的 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」項目可以再次開啟它。

更多詳情(英文)